This directory holds the project's Architecture Decision Records in the MADR format. Each ADR captures one significant decision: its context, the decision itself, the consequences, and the alternatives that were considered.
- Copy 0000-template.md to
NNNN-short-title.mdwhereNNNNis the next free 4-digit number. - Set status to
Proposed. Discuss in a PR. - On merge, update status to
Accepted. Reference the ADR from the relevantAGENTS.mdorSPEC.mdsection. - Superseding an ADR: keep the old file, set its status to
Superseded by NNNN, add a back-link from the new ADR.
| # | Title | Status |
|---|---|---|
| 0001 | Adopt a uv workspace monorepo | Accepted |
| 0002 | Three-layer architecture (use-cases → engine → shared) | Accepted |
| 0003 | Public API = top-level __init__.py re-exports only |
Accepted |
| 0004 | TDD for new public API; coverage thresholds | Accepted |
| 0005 | Engine dependency on utils for error types | Accepted |
| 0006 | Distributed adapter registry & runtime boundaries | Accepted |
| 0007 | Adapter identity & manifest v2 | Accepted |
| 0008 | Plugin discovery via env vars + entry points | Accepted |
| 0009 | Monorepo structural unification (utils rename, single AGENTS.md, use-case template) | Accepted |