Start here when locating repository truth. Retrieve only what the task needs.
| Path | Role |
|---|---|
| WORKFLOW.md | Request shape, judgment, validation, completion |
| product/ | Current product behavior contracts |
| ARCHITECTURE.md | Structural index → architecture/ |
| plans/ | Durable multi-session working memory |
| decisions/ | Lasting product and architecture choices |
| templates/ | Exec-plan and decision templates |
| Path | Role |
|---|---|
| architecture/ | Deep module design (Execution, MCP, PyTest, Logging, Visualization, …) |
| agents/ | Agent task router and operational digests |
| static/ | Icon and installer assets (not behavioral truth) |
| I want to… | Read |
|---|---|
| Choose how to work on a request | WORKFLOW.md |
| Know current platform behavior | product/overview.md |
| Route an agent task | agents/index.md |
| Understand a module deeply | ARCHITECTURE.md |
| Resume complex work | plans/active/ |
| Inherit a lasting choice | decisions/ |
| End-user guides | RevitDevTool.Wiki |
- Behavior change →
product/<domain>.md - Module structure / design change →
architecture/<Module>/ - Agent workflow / verify traps →
agents/ - Lasting policy →
decisions/ - Multi-session work →
plans/active/ - Bounded fix with no contract change → code + proof only
Do not duplicate the same fact across layers; link instead.
- Root contract for agents: AGENTS.md
- User-facing README: ../README.md