37 lines
824 B
Markdown
37 lines
824 B
Markdown
# ADR-0010: Documentation as code
|
|
|
|
- **Status:** Accepted
|
|
- **Date:** 2026-07-30
|
|
|
|
## Context
|
|
|
|
Long-lived multi-agent development drifts when docs lag. The project requires three audience-specific trees plus agent governance from day one.
|
|
|
|
## Decision
|
|
|
|
Maintain from the first commit:
|
|
|
|
- `living_docs/` — current truth
|
|
- `developer_docs/` — contributor technical docs
|
|
- `user_docs/` — end-user docs
|
|
- `agent/` — rules, workflow, ADRs, security
|
|
|
|
Policy: same PR as code; session incomplete without living_docs updates. See `agent/DOCUMENTATION_POLICY.md`.
|
|
|
|
## Consequences
|
|
|
|
### Positive
|
|
|
|
- Continuous onboarding
|
|
- ADRs + living status reduce rework
|
|
|
|
### Negative / tradeoffs
|
|
|
|
- Doc volume to maintain
|
|
- Discipline required from AI agents
|
|
|
|
### Follow-ups
|
|
|
|
- [x] Phase 0 scaffold
|
|
- [ ] Enforce via PR checklist / review
|