Cross-tool decisions that apply to all four tools: phonewave, sightjack, paintress, amadeus.
This directory (docs/shared-adr/) contains shared ADRs that apply across all four tools.
Each tool maintains its own copy in docs/shared-adr/. ADR IDs are referenced in docs/adr/README.md, .semgrep/layers.yaml, and docs/conformance.md.
| # | Decision | Status |
|---|---|---|
| S0001 | Cross-Tool Decision Index | Accepted |
| S0002 | cobra CLI framework adoption | Accepted |
| S0003 | stdio convention (stdout=data, stderr=logs) | Accepted |
| S0004 | OpenTelemetry noop-default + OTLP HTTP | Accepted |
| S0005 | D-Mail Schema v1 specification | Accepted |
| S0006 | fsnotify-based file watch daemon | Accepted |
| S0007 | Root infrastructure and layer conventions | Accepted |
| S0008 | cmd-eventsource import prohibition | Accepted |
| S0009 | SQLite WAL cooperative model for concurrent CLI | Accepted |
| S0010 | Reference data management pattern | Accepted |
| S0011 | COMMAND naming convention (imperative present tense) | Accepted |
| S0012 | POLICY pattern reference implementation | Accepted |
| S0013 | State directory naming convention | Accepted |
| S0014 | Root package file organization | Accepted |
| S0015 | Aggregate root and use case layer | Accepted |
| S0016 | Event Storming alignment and per-tool applicability | Accepted |
| S0017 | Superseded by S0030 | |
| S0018 | Accepted cross-tool divergence (default subcommand, storage model) | Accepted |
| S0019 | D-Mail receive-side validation (Postel's Law) | Accepted |
| S0020 | OTel Metrics Design | Accepted |
| S0021 | Cross-Tool Contract Testing | Accepted |
| S0022 | Superseded by S0026 | |
| S0023 | Event Delivery Guarantee Levels | Accepted |
| S0024 | Domain Model Maturity Assessment | Accepted |
| S0025 | RDRA Gap Resolution — D-Mail Protocol Extension | Accepted |
| S0026 | CLI Argument Design (Actual Implementation) — supersedes S0022 | Accepted |
| S0027 | OTel env-file backend configuration | Accepted |
| S0028 | Usecase-adapter dependency inversion | Accepted |
| S0029 | Parse-don't-validate commands | Accepted |
| S0030 | Insight Data Persistence — supersedes S0017 | Accepted |
| S0031 | D-Mail Context Extension — amends S0005 | Accepted |
| S0032 | CVD-Friendly Signal Color Palette | Accepted |
| S0033 | Loop Safety Audit (2026-03) | Accepted |
| S0034 | Session-Usecase Boundary Clarification | Accepted |
| S0035 | D-Mail Wave Field Extension | Accepted |
| S0036 | Cross-Tool Correlation Protocol | Accepted |
| S0037 | AI Coding Session Abstraction Layer | Accepted |
| S0038 | Harness Layer (filter/verifier/policy) | Accepted |
| S0039 | Harness Evolution Loop | Accepted |
| S0040 | Event Store Snapshot Architecture | Accepted |
| S0041 | Improvement Controller Placement (in amadeus) | Accepted |