Docs: Added ADRs and improved TOC handling

2026-02-16 21:54:31 -05:00
parent 5254708146
commit 339b7de700
30 changed files with 1546 additions and 189 deletions
@@ -1,9 +1,10 @@
 # ADR-006: Plan Lifecycle

-**Status:** Accepted
-**Date:** 2026-02-16
-**Supersedes:** None
-**Related ADRs:** ADR-007, ADR-008, ADR-009, ADR-010, ADR-015, ADR-016, ADR-017
+**Status:** Accepted  
+**Date:** 2026-02-16  
+**Supersedes:** None  
+**Author(s):** Jeffrey Phillips Freeman <Jeffrey.Freeman@CleverThis.com>  
+**Approver(s):** Jeffrey Phillips Freeman <Jeffrey.Freeman@CleverThis.com>

 ## Context

@@ -108,3 +109,39 @@ None — specification-driven requirement. The four-phase lifecycle with reversi
 - **Reversion boundary tests**: Tests verify that Execute-phase code cannot modify resources outside the sandbox and that reversion correctly preserves and transmits findings to the strategy actor.
 - **BDD scenarios**: Behave feature files describe end-to-end plan lifecycle scenarios including hierarchical decomposition, parallel child plan execution, and phase reversion.
 - **Automation profile integration tests**: Tests verify that each automation profile correctly gates the appropriate phase transitions.
+
+## Related ADRs
+
+| ADR | Title | Relationship |
+|-----|-------|-------------|
+| [ADR-007](ADR-007-decision-tree-and-correction.md) | Decision Tree and Correction | Decisions are recorded at each phase transition in the plan lifecycle |
+| [ADR-008](ADR-008-resource-system.md) | Resource System | Resources are bound to plans and sandboxed per the lifecycle phases |
+| [ADR-009](ADR-009-project-model.md) | Project Model | Plans operate within project scope and inherit project-level configuration |
+| [ADR-010](ADR-010-actor-and-agent-architecture.md) | Actor and Agent Architecture | Actors drive phase transitions and execute plan steps |
+| [ADR-015](ADR-015-sandbox-and-checkpoint.md) | Sandbox and Checkpoint | Sandboxes are created per-plan and checkpoints track execution progress |
+| [ADR-016](ADR-016-invariant-system.md) | Invariant System | Invariants are reconciled at Strategize entry and enforced throughout the lifecycle |
+| [ADR-017](ADR-017-automation-profiles.md) | Automation Profiles | Profiles control which phase transitions require human approval |
+
+## Acceptance
+
+### Votes For
+
+| Voter | Comment |
+|-------|---------|
+| Jeffrey Phillips Freeman <Jeffrey.Freeman@CleverThis.com> | The four-phase lifecycle with reversion rules gives us the right balance of structure and recovery |
+
+**Total: 1**
+
+### Votes Against
+
+| Voter | Comment |
+|-------|---------|
+
+**Total: 0**
+
+### Abstentions
+
+| Voter | Comment |
+|-------|---------|
+
+**Total: 0**