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 - Commands and service URLs, apps.md - App framework guide |
developer/ |
Contributors | development-workflow.md, opencode-setup.md, adding-services.md, adding-apps.md, app-builder-guide.md |
architecture/governance/ |
Architects | 00_invariants.md, 02_profiles.md, service_contracts/ |
operations/ |
Operators | security-runbook.md, incident-response.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
This repository supports both OpenCode and Claude Code agentic CLIs. Tool-specific configuration lives in .opencode/ and .claude/ respectively. Both tools share the same governance rules (Issue-First workflow, platform invariants) defined in AGENTS.md and DEVELOPMENT.md.