Browse docs▾
Governance
The rules, critical-rules, task lifecycle, and release process.
- ADR: Role dispatch stays opt-in; the role chain is single-agent guidance
- ADR — Task-ID Allocator Seam + externalref
- ADR — Task ID Collision Resistance for OSS Multi-Contributor Flow
- Agent Workflow PolicyDomain routing, task protocol, escalation, and memory contract — supplements `AGENTS.md` § Core Loop.
- Stack Anatomy Contract
- The coding-os Constitution — Values the Rules Derive Fromthe WHY beneath the rules. `AGENTS.md` lists the imperatives; [critical-rules.md](critical-rules.md) gives each rule's mechanism; THIS file states the small set of values every rule derives from — so when you hit a situation no rule covers, you can reason from the value and construct the right rule yourself.
- Critical Rules — Full TextCanonical expansion of every numbered rule listed in `AGENTS.md` § Critical Rules. AGENTS.md keeps the 1-line summary; this file is the rationale + enforcement reference.
- Decision RecordsDefine where durable architectural decisions live and how to reference them from tasks and governance docs.
- Docs-First Protocol
- Documentation System PolicyDefine the canonical documentation taxonomy, naming rules, file headers, and navigation contract for all active docs.
- GDPR / Privacy ComplianceDefine data handling, consent, and retention rules for personal data in the project.
- MCP Tool InventoryRoute AI agents to the correct tools for research, validation, and automation tasks.
- Migration Guide — Pre-0.3 → CurrentUpgrade a consumer project scaffolded by a pre-0.3 coding-os core to the
- Release Process (SSOT)
- Risk RegisterCanonical list of active project, architecture, and workflow risks that still require mitigation or follow-up.
- Scaffold Boundary Contract
- Stability Contract — what 1.0 freezes
- Stack Maturity Matrix
- Task Lifecycle Policy
- Product Vision — coding-os
- Wrapper Derivation PolicyDefine how editor- and tool-specific wrapper files (`.claude/`, `.codex/`) stay thin, derived, and subordinate to canonical SSOT docs.