This directory contains all Architecture Decision Records for the CodeLens project.
Index
| ADR | Title | Status | Date | Supersedes |
|---|---|---|---|---|
| ADR-0001 | Runtime Boundaries and Single-Source Registries | Proposed | 2026-04-12 | — |
| ADR-0002 | Enterprise Productization, Evaluation, and Release Gates | Proposed | 2026-04-13 | — |
| ADR-0004 | Multi-Agent Concurrency Primitives (Bounded-Evidence Only) | Accepted | 2026-04-15 | — |
| ADR-0005 | Shared Harness Substrate for Host-Selected Roles | Accepted | 2026-04-18 | — |
| ADR-0006 | Agent Routing Enforcement (legacy executor metadata) | Deprecated by ADR-0015 | 2026-04-18 | — |
| ADR-0007 | Symbiote Product Metaphor and Candidate Rename | Accepted (pending trademark) | 2026-04-18 | — |
| ADR-0008 | Serena Upper-Compatible Absorption (P1-P4, passive first) | Accepted | 2026-04-19 | — |
| ADR-0009 | Mutation Trust Substrate | Proposed | 2026-04-26 | Internal G4/G7 notes |
| ADR-0010 | Telemetry-Driven Tool Surface Diet | Proposed | 2026-04-30 | — |
| ADR-0011 | Control-Plane Sprawl Resolution | Accepted | 2026-05-01 | — |
| ADR-0012 | Default-Off Semantic on Cargo-Install Path | Accepted | 2026-05-02 | — |
| ADR-0013 | TOML-Driven Codegen for Tool Definitions | Accepted | 2026-05-02 | — |
| ADR-0014 | Bounded Code-Work Orchestrator Direction | Accepted | 2026-05-09 | ADR-0005 wording |
| ADR-0015 | Host-Neutral Execution Contract | Accepted | 2026-07-21 | ADR-0006 |
| ADR-0016 | Default Tool Surface ≤ 20 | Accepted | 2026-07-21 | — |
| ADR-0017 | Single-Writer Project Runtime & Session-Safe Cache | Accepted | 2026-07-21 | — |
| ADR-0018 | Session Identity & Coordination Hardening | Accepted | 2026-07-21 | — |
Status Legend
- Proposed — Under discussion; not yet committed to implementation.
- Accepted — Decision made and implementation in progress or complete.
- Deprecated — No longer applicable; superseded by a newer ADR.
- Rejected — Explicitly decided against.
Contributing
When adding a new ADR:
- Use the next sequential number (e.g.,
ADR-0011-...). - Copy the template from design/adr-template.md if available, or follow the structure of existing ADRs.
- Update this index.
- Link the ADR from relevant code comments where the decision is enforced.