Documentation organized by audience. Keep it lean -- if something can be regenerated or is operator-only, it belongs in the wiki, not the repo.
| Directory | Audience | Key Files |
|---|---|---|
user/ |
End users | usage.md - Setup, commands, troubleshooting |
developer/ |
Contributors | development-workflow.md, opencode-setup.md, adding-services.md |
architecture/governance/ |
Architects | 00_invariants.md, 02_profiles.md, service_contracts/ |
operations/ |
Operators | security.md, model-recommendations.md |
reference/ |
All | manpage.txt |
These files are canonical and loaded by all agents:
AGENTS.md— Operating contractDEVELOPMENT.md— Workflow rulesCONTRIBUTING.md— External contributor guideSECURITY.md— Security policy