Architecture Decisions¶
Append-only log of high-leverage decisions affecting Animus architecture, scope, and tooling.
What is an ADR?¶
An Architecture Decision Record (ADR) documents a significant decision: the context, the options considered, the choice made, and the tradeoffs accepted. ADRs are append-only — once logged, they are not edited, only superseded by a new ADR.
An Arete Decision Log (ADL) entry is a higher-level commitment scoped to a project milestone. ADLs live here alongside ADRs.
Index¶
| ID | Title | Date | Status | Class |
|---|---|---|---|---|
| ADR-001 | Adopt v2.1 Mind-class Architecture | 2026-06-18 | Accepted | ARCH |
| ADL-20260618-001 | Commit to v2.1 as canonical executable baseline | 2026-06-18 | Committed | ARCH |
Classes¶
- ARCH — Structural or cross-cutting architecture changes
- UX — Interface, interaction, or workflow decisions
- SCOPE — Project scope inclusions and exclusions
- TOOLING — Build, CI, deployment, or development tool choices
- PHIL — Philosophical or principle-level decisions
How to Propose a New ADR¶
- Copy
_templates/adr.mdtoADR-NNN.md(next sequential number) - Fill in all sections
- Submit a PR with the
docs:prefix - Discuss and revise; once accepted, merge
Template¶
See _templates/adr.md.