Repository knowledge
What the repository declares about itself: sources, nodes, edges, the plan, and searching them.
What the repository declares about itself: sources, nodes, edges, the plan, and searching them.
- use cases
- 8
- guaranteed
- 8
-
guaranteed intermediate
Decide what belongs in the AI context, as data
Read the repository’s declared scope policy, see which paths are in and out of the index, and let doctor and the knowledge index apply it rather than a hardcoded list.
knowledge · doctor -
guaranteed intermediate
Refuse a directory of the layer that documents nothing
A directory added under the layer without a context document fails validation by name, nothing resolves against the tree until it says what it is for, and the same hierarchy is readable over MCP and the API without running the gate.
context · doctor -
guaranteed basic
Hand the repository to someone who cannot clone it
Take a snapshot that a model can read or a gate can run in, without sending anything untracked and without losing the file modes on the way.
archive -
guaranteed basic
Keep what an episode learned, without a model and without a conversation
Record a decision inside an episode, derive it into a candidate knowledge record from the ledger, read the evidence that the derivation ran, and watch a second derivation change nothing.
start · decision · knowledge · history -
guaranteed intermediate
Keep the plan as milestones and issues the tool can validate
Declare milestones as outcomes and issues as execution contracts, and let the tool say what is ready and what is blocked.
plan -
guaranteed basic
Read back what happened, and keep the ledger within its cap
Read the append-only ledger as operational history, filtered by task and event, validate every line, and rotate the oldest lines into an archive rather than deleting them.
history · search · watch -
guaranteed basic
Record a decision as data, and prove the tool cannot accept it for you
Read the decisions a repository holds, validate the whole set in one command, and watch the tool refuse to write the one status only a person may write.
adr · knowledge -
guaranteed intermediate
Trace a change to the context documents it affects
List the scoped context documents, resolve which apply to a path and why, and find out which documents a change set touches before it lands.
context · doctor