Workflow guide
Agents repeatedly rediscover architecture, conventions, and known traps.
Maintain a bounded index, architecture map, glossary, conventions, patterns, gotchas, area flows, and validation reports.
Evidence: public-synthetic-reproduction. Recorded: 2026-09-01.
A new person or agent needs to orient to a repository without reading every file.
- Write one index linking architecture, file map, conventions and known pitfalls.
- Give each file a clear scope and keep detailed evidence behind links.
- Run the context-budget guard and check every linked path.
- Ask a fresh reader to identify the next safe task, then fix any missing route.
Check your result
The links and budgets pass, and a fresh reader can name the next action without guessing.
Limits
- AI-maintained context can preserve errors unless evidence and review are required