Architecture Decision Record (ADR) Log

This directory is the durable ADR log for framework-level architecture and operating decisions that affect how teams and agents execute work.

Use this log to preserve why decisions were made, what alternatives were considered, and what contributors should continue to follow over time.

Authoring guide:

• docs/adr-template-guide.md

ADR index

• ADR 0001: GitHub as durable control plane — Accepted
• ADR 0002: Multi-surface hybrid execution model — Accepted
• ADR 0003: Pull requests as primary control gate — Accepted
• ADR 0004: Markdown CI guardrail — Accepted
• ADR 0005: Dependabot for GitHub Actions — Accepted
• ADR 0006: CODEOWNERS for review routing — Accepted
• ADR 0007: Path-based PR auto-labeler — Accepted
• ADR 0008: Stale branch cleanup automation — Accepted
• ADR 0009: Mermaid as primary diagram format — Accepted
• ADR 0010: Diagrams convention — Accepted
• ADR 0011: Documentation navigation — Accepted
• ADR 0012: SVG companions for diagrams — Superseded by ADR 0024
• ADR 0013: Mobile quick action section convention — Accepted
• ADR 0014: Deployment and infrastructure scope — Deferred
• ADR 0015: Handoff packet enforcement — Accepted
• ADR 0016: Continuous checks and recurring framework audit layer — Accepted
• ADR 0017: Queue health check and drift-detection layer — Accepted
• ADR 0018: Framework change governance and deprecation policy — Accepted
• ADR 0019: Project brain factory and bidirectional improvement loop — Accepted
• ADR 0020: Portable core, additive enterprise (runtime-agnostic brains) — Accepted
• ADR 0021: Expose Brain Factory over MCP (standard-library stdio server) — Accepted
• ADR 0022: Multi-target command emission to standard agent discovery locations — Accepted
• ADR 0023: Documentation site on GitHub Pages (MkDocs Material) — Accepted
• ADR 0024: Retire SVG companions for diagrams — Accepted
• ADR 0025: CLI distribution via PyPI and npm — Accepted

Numbering convention

• Use sequential, zero-padded numbering: 0001, 0002, 0003, ...
• File naming pattern: NNNN-short-kebab-case-title.md
• Never reuse a retired number; preserve historical continuity.

Status convention

• Proposed — under discussion and not yet adopted.
• Accepted — approved and currently in force.
• Superseded — replaced by a newer ADR (link old and new ADRs).
• Deprecated — no longer recommended, retained for historical context.