# 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