Project Bible
The Bible is the single source of truth for this project's architecture.
Documentation Rules
- All architecture decisions must be recorded in this Bible.
- The documentation language is English only.
- If a decision is superseded, update the Bible immediately and remove or mark obsolete content.
- Do not duplicate architecture documentation in
README.md,claude.md, or other files.
Structure
governance/documentation-policy.md- mandatory rules for maintaining architecture docs.architecture/system-overview.md- current scope, boundaries, and high-level system composition.architecture/api-surface.md- HTTP API and UI route contracts.architecture/runtime-flows.md- ingest, timeline, status, and failure invariants.architecture/ui-information-architecture.md- required UI structure and semantics.architecture/data-model.md- domain language, core tables, and migration boundaries.docs/README.md- index of active project documents outside the architecture set.docs/hardware-ingest-contract.md- external JSON integration contract.decisions/README.md- how to capture new and updated architecture decisions.