Summary
Tracking issue for the complete ADR governance framework — 13 architectural decision records that define the operating system for autonomous agents and humans working on this codebase.
Sub-issues (implementation tracking)
✅ feat(docs): ADR framework + ADR-001 stacked pull requests methodology #129 — ADR-001 stacked pull requests (PR docs: establish ADR framework and ADR-001 stacked pull requests #130 , merged)
✅ feat(bootstrap): ADR framework and least-privilege decision record #121 — ADR-002 least-privilege bootstrap (PR docs: ADR-002 least-privilege CDK bootstrap policies #133 , merged)
✅ RFC: ADR-003 — Contribution governance for async agents and humans #134 — ADR-003 contribution governance (PR docs: ADR-003 contribution governance + ADR-004 tabula rasa documentation #143 , merged)
✅ RFC: ADR-004 — Tabula rasa documentation standard (zero-context self-sufficiency) #135 — ADR-004 tabula rasa documentation (PR docs: ADR-003 contribution governance + ADR-004 tabula rasa documentation #143 , merged)
🔄 RFC: ADR-005 — Feedback loop: PR reviews, issue revision, and ADR evolution #136 — ADR-005 feedback loop (PR docs: ADR-005 through ADR-013 (feedback, flags, knowledge, DoD, security, recovery, conflicts, knowledge stack, validation pyramid) #144 , ready for review)
🔄 RFC: ADR-006 — Feature flags for concurrent development with partial conflicts #137 — ADR-006 feature flags (PR docs: ADR-005 through ADR-013 (feedback, flags, knowledge, DoD, security, recovery, conflicts, knowledge stack, validation pyramid) #144 , ready for review)
🔄 RFC: ADR-007 — Knowledge acquisition through progressive failure (self-improving documentation) #138 — ADR-007 knowledge acquisition (PR docs: ADR-005 through ADR-013 (feedback, flags, knowledge, DoD, security, recovery, conflicts, knowledge stack, validation pyramid) #144 , ready for review)
🔄 RFC: ADR-008 — Definition of Done (progressive maturity) #139 — ADR-008 definition of done (PR docs: ADR-005 through ADR-013 (feedback, flags, knowledge, DoD, security, recovery, conflicts, knowledge stack, validation pyramid) #144 , ready for review)
🔄 RFC: ADR-009 — Security posture and blast radius for development-time agents #140 — ADR-009 security posture (PR docs: ADR-005 through ADR-013 (feedback, flags, knowledge, DoD, security, recovery, conflicts, knowledge stack, validation pyramid) #144 , ready for review)
🔄 RFC: ADR-010 — Error recovery and rollback protocol #141 — ADR-010 error recovery (PR docs: ADR-005 through ADR-013 (feedback, flags, knowledge, DoD, security, recovery, conflicts, knowledge stack, validation pyramid) #144 , ready for review)
🔄 RFC: ADR-011 — Conflict resolution protocol (technical disagreements and merge conflicts) #142 — ADR-011 conflict resolution (PR docs: ADR-005 through ADR-013 (feedback, flags, knowledge, DoD, security, recovery, conflicts, knowledge stack, validation pyramid) #144 , ready for review)
🔄 docs: ADR-012 operational knowledge stack (Decision → Guide → Skill) #148 — ADR-012 operational knowledge stack (PR docs: ADR-005 through ADR-013 (feedback, flags, knowledge, DoD, security, recovery, conflicts, knowledge stack, validation pyramid) #144 , ready for review)
🔄 docs: ADR-013 tiered validation pyramid for agentic-first development #149 — ADR-013 tiered validation pyramid (PR docs: ADR-005 through ADR-013 (feedback, flags, knowledge, DoD, security, recovery, conflicts, knowledge stack, validation pyramid) #144 , ready for review)
Delivery (per ADR-001 §8)
All PRs target main directly. Predecessors merge first; successors retarget and rebase.
PR
Content
Status
#130
ADR-001 + framework
✅ Merged
#133
ADR-002
✅ Merged
#143
ADR-003 + ADR-004
✅ Merged
#144
ADR-005 through ADR-013
🔄 Ready for review
Progress
4/13 ADRs merged. Final PR (#144 ) covers the remaining 9 ADRs — ready for review and merge.
Summary
Tracking issue for the complete ADR governance framework — 13 architectural decision records that define the operating system for autonomous agents and humans working on this codebase.
Sub-issues (implementation tracking)
Delivery (per ADR-001 §8)
All PRs target
maindirectly. Predecessors merge first; successors retarget and rebase.Progress
4/13 ADRs merged. Final PR (#144) covers the remaining 9 ADRs — ready for review and merge.