context-docs · diff
git:20260502.f73b729 to git:20260502.d333f5f
10 added, 2 removed. Audit B to A.
---
name: context-docs
- description: TODO – Phase 3 authoring pending.
+ description: "Maintain short, focused Markdown files per subsystem to provide agents with isolated context."
---
- <!-- PLACEHOLDER: Content to be written in Phase 3. -->
+ # Context Docs
+ Large centralized documentation files consume too much context window. Decentralized, module-specific context docs provide targeted information exactly when an agent needs it.
+
+ ## Context Protocol
+
+ 1. Place `README.md` or `CONTEXT.md` files *inside* specific subsystem directories (e.g., `src/auth/CONTEXT.md`).
+ 2. Document only the boundaries: How does this module communicate with the rest of the app? What are its critical invariants?
+ 3. Keep it terse. Use bullet points and exact file paths.
+ 4. Update these files inline when refactoring the module.