ADR index
Grouped navigation for architectural decisions. ADR files remain in chronological order under docs/adr/.
Documentation
Governance for readable, auditable external references in ADRs and docs.
| ADR / doc | Title | Status |
|---|---|---|
| 0011 | Use [web:*] source tags with a central mapping file | Accepted |
| 0012 | Fetch and archive web sources via a focused fetcher | Accepted |
| web-source-mapping | Central registry for [web:NNN] tags | — |
Workflow
| ADR | Title | Status |
|---|---|---|
| 0000 | Establish a2c-workflow as the canonical A2C repository | Accepted |
| 0001 | Shared pre-commit policy for A2C-governed repositories | Accepted |
| 0002 | Standardized changelog and release documentation in A2C | Accepted |
| 0003 | Standardized A2C pre-commit hooks for A2C projects | Accepted |
| 0004 | Standardized CI bump and release flow for A2C projects | Superseded |
| 0009 | Release semantics and commit promotion to master | Accepted |
| 0010 | TestPyPI and PyPI publishing gated by release state | Accepted |
| 0013 | Adoption version record and drift warnings | Superseded |
| 0014 | CLI invocation journal | Amended |
| 0015 | Bootstrap dev environment and pre-commit hooks | Accepted |
| 0016 | Stack profile plugin protocol in a2c_core | Amended |
| 0017 | Publishable Python profile and forge-neutral release scaffolding | Amended |
| 0018 | Legacy repository adoption workflow | Amended |
Governance
Architecture-significant requirements, decision evolution, and related control points.
| ADR | Title | Status |
|---|---|---|
| 0019 | Architecture Significant Requirements as first-class artifacts | Accepted |
| 0020 | Intent to ASR, ADR, Spec, Contract, and planning governance chain | Accepted |
| 0021 | Amending Accepted ADRs (Amends vs Supersede) | Accepted |
| 0022 | Narrative architecture story per ProductPhase | Accepted |
| 0023 | Pull requests as architecture control points | Accepted |
| 0024 | Tool state root, write contract, and version migration | Accepted |
| 0025 | Workspace root discovery | Amended |
| 0026 | Exclude user-global esysrepo config from workspace signals | Accepted |
| 0027 | Workspace method install and member enumeration | Proposed |
| 0028 | Selectable IDE adapter materialization (Cursor and Copilot) | Accepted |
Product
| ADR | Title | Status |
|---|---|---|
| 0005 | A2C product repository boundaries | Amended |
| 0006 | Three-package Python structure in a2c-workflow | Accepted |
| 0007 | VS Code extension thin client with bundled platform CLI | Accepted |
Planning
| ADR | Title | Status |
|---|---|---|
| 0008 | Task lifecycle sidecar and immutable task spec | Accepted |
By status
Proposed
- 0027 — Workspace method install and member enumeration — esysrepo then
repofor members;a2c method install/--workspace
Accepted
- 0000 — Establish a2c-workflow as the canonical A2C repository
- 0001 — Shared pre-commit policy for A2C-governed repositories
- 0002 — Standardized changelog and release documentation in A2C
- 0003 — Standardized A2C pre-commit hooks for A2C projects
- 0006 — Three-package Python structure in a2c-workflow
- 0007 — VS Code extension thin client with bundled platform CLI
- 0028 — Selectable IDE adapter materialization (Cursor and Copilot)
- 0008 — Task lifecycle sidecar and immutable task spec
- 0009 — Release semantics and commit promotion to
master - 0010 — TestPyPI and PyPI publishing gated by release state
- 0011 — Use [web:*] source tags with a central mapping file
- 0012 — Fetch and archive web sources via a focused fetcher
- 0015 — Bootstrap dev environment and pre-commit hooks
- 0019 — Architecture Significant Requirements as first-class artifacts
- 0020 — Intent to ASR, ADR, Spec, Contract, and planning governance chain
- 0021 — Amending Accepted ADRs (Amends vs Supersede)
- 0022 — Narrative architecture story per ProductPhase
- 0023 — Pull requests as architecture control points
- 0024 — Tool state root, write contract, and version migration — supersedes 0013; amends 0005, 0014, 0016, 0017, 0018
- 0026 — Exclude user-global esysrepo config from workspace signals — amends 0025
Amended
- 0005 — A2C product repository boundaries — amended by ADR-0024
- 0014 — CLI invocation journal — amended by ADR-0024
- 0016 — Stack profile plugin protocol in a2c_core — amended by ADR-0024
- 0017 — Publishable Python profile and forge-neutral release scaffolding — amended by ADR-0024
- 0018 — Legacy repository adoption workflow — amended by ADR-0024
- 0025 — Workspace root discovery — amended by ADR-0026
Superseded
- 0004 — Standardized CI bump and release flow for A2C projects — superseded by ADR-0009
- 0013 — Adoption version record and drift warnings — superseded by ADR-0024