Skip to content

Commit 1b143bf

Browse files
committed
docs: rename code map to code graph
1 parent 0081de9 commit 1b143bf

1 file changed

Lines changed: 14 additions & 14 deletions

File tree

README.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010

1111
<p align="center">
1212
<strong>Built for coding agents to run end to end</strong> (install, setup, verify, handoffs), not as a human day-to-day terminal app.
13-
When an agent says tests passed, you get a file with the real exit code, a <strong>code map</strong> of what changed (<code>brigade code</code>), and an <strong>evidence log</strong> you can search later (<code>brigade evidence</code>).
13+
When an agent says tests passed, you get a file with the real exit code, a <strong>code graph</strong> of what changed (<code>brigade code</code>), and an <strong>evidence log</strong> you can search later (<code>brigade evidence</code>).
1414
Optional: one MCP and tools catalog across agents, and shared notes with a review gate.
1515
Local files. No daemon. No lock-in.
1616
</p>
@@ -24,16 +24,16 @@
2424
<img src="https://shieldcn.dev/pypi/v/brigade-cli.svg?label=pypi&size=xs" alt="PyPI version">
2525
<img src="https://shieldcn.dev/pypi/dm/brigade-cli.svg?size=xs" alt="PyPI downloads per month">
2626
<img src="https://shieldcn.dev/badge/python-3.10+-blue.svg?logo=python&logoColor=white&size=xs" alt="Python 3.10+">
27-
<img src="https://shieldcn.dev/badge/rust-code_map-b7410e.svg?logo=rust&logoColor=white&size=xs" alt="Rust: code map engine">
27+
<img src="https://shieldcn.dev/badge/rust-code_graph-b7410e.svg?logo=rust&logoColor=white&size=xs" alt="Rust: code graph engine">
2828
<img src="https://shieldcn.dev/badge/go-evidence_log-00add8.svg?logo=go&logoColor=white&size=xs" alt="Go: evidence log engine">
2929
<img src="https://shieldcn.dev/badge/license-MIT-4e7247.svg?size=xs" alt="MIT license">
3030
</p>
3131

3232
<p align="center">
33-
<img src="docs/assets/brigade-demo.svg" alt="Recording: an agent claims tests pass; a verify run writes a receipt with the real exit code, code impact shows what the change touched, evidence search finds the run in the ledger, and outcome rank scores the skill that did the work" width="800">
33+
<img src="docs/assets/brigade-demo.svg" alt="Recording: an agent claims tests pass. A verify run writes a receipt with the real exit code, the code graph shows what the change touched, evidence search finds the run in the ledger, and outcome rank scores the skill that did the work" width="800">
3434
</p>
3535

36-
<p align="center"><em>An agent said "tests pass." This is the claim becoming a record: receipt, code map, evidence log, rank.</em></p>
36+
<p align="center"><em>An agent said "tests pass." This is the claim becoming a record: receipt, code graph, evidence log, rank.</em></p>
3737

3838
## The loop
3939

@@ -70,9 +70,9 @@ brigade setup # install the verified native engines
7070
brigade operator quickstart --target ./my-repo --harnesses codex
7171
```
7272

73-
brigade prints a one-line notice when a new release is out (checked at most
74-
once a day via an anonymous request; set `BRIGADE_NO_UPDATE_CHECK=1` to
75-
disable - details in [docs/update-channels.md](docs/update-channels.md)).
73+
Brigade prints a one-line notice when a new release is out. It checks at most
74+
once a day through an anonymous request. Set `BRIGADE_NO_UPDATE_CHECK=1` to
75+
disable it. Details are in [docs/update-channels.md](docs/update-channels.md).
7676

7777
Stable pinners may deliberately install an exact release with
7878
`pipx install brigade-cli==X.Y.Z` or refresh through
@@ -105,9 +105,9 @@ brigade work verify run --target . --command "pytest -q" --capture brigade-work
105105

106106
Receipts land in the **evidence log** (`brigade evidence`), a Go engine installed by `brigade setup` (historically shipped as MiseLedger). Every consequential action elsewhere in Brigade (a memory write, a skill promotion, a sync) is logged the same way. `brigade evidence search` answers "what ran, when, and what did it change" from files, weeks later. Cross-model dispatches through `brigade run` carry the same paper trail. When someone asks what your agents did this week, the answer comes from receipts you can grep, not from scrollback. [Capability page](https://brigade.tools/evidence-memory).
107107

108-
## Code map, built in
108+
## Code graph, built in
109109

110-
The `code_graph_delta` line in that receipt comes from the **code map** (`brigade code`), a Rust engine installed by `brigade setup` (historically shipped as GraphTrail; digest-verified, no toolchain required). It indexes your repo once and keeps up incrementally. On this repository a sync pass over 652 files and 10,405 symbols reports in well under a second. A receipt names the exact symbols a change touched, and your agents stop grepping and start asking structural questions:
110+
The `code_graph_delta` line in that receipt comes from the **code graph** (`brigade code`), a Rust engine installed by `brigade setup` (historically shipped as GraphTrail, digest-verified, no toolchain required). It indexes your repo once and keeps up incrementally. On this repository a sync pass over 652 files and 10,405 symbols reports in well under a second. A receipt names the exact symbols a change touched, and your agents stop grepping and start asking structural questions:
111111

112112
```
113113
$ brigade code impact _write_receipt
@@ -196,7 +196,7 @@ The ledger is plain JSON and markdown under `memory/outcome/`, tracked in git, r
196196

197197
| Surface | Commands | Notes |
198198
|---|---|---|
199-
| Code map | `brigade code …` | Callers, impact, context. Formerly GraphTrail. |
199+
| Code graph | `brigade code …` | Callers, impact, context. Formerly GraphTrail. |
200200
| Evidence log | `brigade evidence …` | Searchable ledger of runs and imports. Formerly MiseLedger. |
201201
| Content Guard | `brigade guard` / `brigade scrub` | Secrets and private detail before publish. |
202202

@@ -208,9 +208,9 @@ The ledger is plain JSON and markdown under `memory/outcome/`, tracked in git, r
208208
| [Token Glace](https://github.com/escoffier-labs/token-glace) | `brigade add tokens` | Compact noisy tool output before it burns context |
209209
| [Skillet](https://github.com/escoffier-labs/skillet) | optional roster | Portable skills that reconcile can promote or roll back |
210210
| [Bootstrap Doctor](https://github.com/escoffier-labs/bootstrap-doctor) | `brigade add bootstrap-doctor` | Audit OpenClaw bootstrap files (SOUL.md, TOOLS.md, AGENTS.md, IDENTITY.md, MEMORY.md, and the rest of the set) and trim oversize detail into cards |
211-
| Notifications | `brigade add notifications` | Optional `agent-notify` binary for Discord, Telegram, or Signal; status and setup planning only until you wire hooks or pass an explicit `--send` |
211+
| Notifications | `brigade add notifications` | Optional `agent-notify` binary for Discord, Telegram, or Signal. Status and setup planning only until you wire hooks or pass an explicit `--send` |
212212

213-
Upgrading from standalone GraphTrail or MiseLedger installs? `brigade setup` replaces both. The old `brigade add graphtrail` / `add evidence` paths remain as compatibility shims. Engine binaries and some paths still use the historical names; the operator surface is `brigade code` and `brigade evidence`. Details: [wiring guide](docs/wiring-graphtrail-miseledger.md), [station contract](docs/station-contract.md).
213+
Upgrading from standalone GraphTrail or MiseLedger installs? `brigade setup` replaces both. The old `brigade add graphtrail` / `add evidence` paths remain as compatibility shims. Engine binaries and some paths still use the historical names. The operator surface is `brigade code` and `brigade evidence`. Details: [wiring guide](docs/wiring-graphtrail-miseledger.md), [station contract](docs/station-contract.md).
214214

215215
Beyond the daily loop, the same review-and-receipt pattern covers cross-model runs (`brigade run` dispatches one bounded task across your roster), security scans, friction mining, research reports, and fleet health. All of it stays behind `brigade extras on` until you ask. The full tour: [docs/overview.md](docs/overview.md).
216216

@@ -248,12 +248,12 @@ I run an always-on OpenClaw agent next to daily Codex and Claude Code sessions.
248248

249249
| What you type / say | Historical name | Notes |
250250
|---|---|---|
251-
| Code map · `brigade code` | GraphTrail | Built in via `brigade setup` |
251+
| Code graph · `brigade code` | GraphTrail | Built in via `brigade setup` |
252252
| Evidence log · `brigade evidence` | MiseLedger | Built in via `brigade setup` |
253253
| Content Guard · `brigade guard` / `scrub` | content-guard | Embedded |
254254
| Bootstrap Doctor | same | Full OpenClaw bootstrap set: SOUL, TOOLS, AGENTS, IDENTITY, MEMORY, and related session-start files |
255255

256-
Kitchen language (*brigade de cuisine*, *mise en place*, station nicknames) is brand and deep docs. Commands and product surfaces stay plain: receipt, code map, evidence log, sync, handoff.
256+
Kitchen language (*brigade de cuisine*, *mise en place*, station nicknames) is brand and deep docs. Commands and product surfaces stay plain: receipt, code graph, evidence log, sync, handoff.
257257

258258
**Who runs what:** agents install, set up, verify, and write handoffs. Humans set policy and review gates when something is ambiguous or risky. The CLI is the control plane the fleet drives, not a tool you are expected to operate by hand all day.
259259

0 commit comments

Comments
 (0)