ADR-0001: Source of Truth¶
Status¶
Accepted
Context¶
The company needs a durable, versioned, reviewable, and AI-friendly documentation system.
Knowledge should not be fragmented across too many tools with unclear ownership.
Decision¶
GitHub stores the source of truth for durable company documentation.
The published documentation site is the reading surface, not the primary editing surface.
Linear is used for execution tracking. Eraser is used for visual documentation. Chat messages are not considered durable documentation by default.
Consequences¶
- documentation is versioned
- documentation can be reviewed like code
- documentation can be published as HTML
- AI systems can rely on a more stable and structured knowledge base
- temporary notes must be promoted into durable documents when they matter