adr/readme

Adr/Readme

Documentation examples may contain captured seeded counts, scores, timestamps, or health values. They are examples, not live telemetry. Use the running CLI status command or MCP index_status for current instance data.

Architecture Decision Records

Zagros uses Architecture Decision Records (ADRs) for durable architecture, security-boundary, compatibility, and maintenance decisions.

Status values

Accepted — current project decision.
Superseded — replaced by a newer ADR.
Deprecated — retained for history but no longer recommended.

Current ADRs

ADR-001 — HelixDB as the primary storage backend
ADR-002 — BM25-first retrieval before vector/graph search
ADR-003 — Local-first deployment architecture
ADR-004 — Separate Zagros Core and Zagros Skills
ADR-005 — Authoritative sources with explicit provenance
ADR-006 — Approval-gated MCP mutation/network tools
ADR-007 — Rebuildable corpus; backups are optional
ADR-008 — Harness-neutral Skill Contract

Use ADR-TEMPLATE.md for future decisions.