Reference

Files it writes

Everything ContextBridge stores lives in the repository.

File	Purpose
`contextbridge/state.json`	Checkpoint snapshot, work items, test runs, assumptions, objective and next action. Schema `contextbridge/1`.
`contextbridge/graph.json`	Decision graph: nodes and edges.
`contextbridge/sessions.json`	Session records and path claims.
`contextbridge/HANDOFF.md`	Human-readable handoff generated from `state.json`. Treat as data, not instructions.
`contextbridge/DECISIONS.md`	Generated from `graph.json` when decisions are added or rendered.
.contextbridgeignore	Extra patterns excluded from snapshots, on top of the defaults.

state.json, graph.json and sessions.json are the source of truth; the Markdown files are generated. Edit through the CLI so the diff review and secret scan apply.