From 44fa97ce901bbfc5957e6d9ba90a53086bb5950b Mon Sep 17 00:00:00 2001 From: Peter Stone Date: Sat, 7 Feb 2026 21:24:39 -1000 Subject: Add self-improvement cycles to all role definitions Each role now has a structured post-task cycle: reflect on specific questions, perform 1-3 concrete improvements (test helpers, scripts, checklists, docs, role definitions), and record changes in SESSION_STATE. Updated CLAUDE.md and DESIGN.md to reference the cycle in the multi-agent workflow documentation. Co-Authored-By: Claude Opus 4.6 --- DESIGN.md | 11 +++++++++++ 1 file changed, 11 insertions(+) (limited to 'DESIGN.md') diff --git a/DESIGN.md b/DESIGN.md index a62ec47..e139ab7 100644 --- a/DESIGN.md +++ b/DESIGN.md @@ -71,6 +71,17 @@ Tasks flow through these states: 5. **Reviewer** reads code, runs tests, writes `review_feedback.md` 6. **Reviewer** marks `[APPROVED]` or `[NEEDS_FIX]` with specific feedback 7. If `[NEEDS_FIX]`, **Implementor** addresses feedback, returns to step 4 +8. **All roles** run self-improvement cycle: reflect, perform 1-3 improvements, record in `SESSION_STATE.md` + +### Self-Improvement Cycle + +After completing each task, every role performs a structured improvement cycle: + +1. **Reflect** — Answer role-specific questions about what went well and what caused friction +2. **Improve (1-3 actions)** — Make concrete changes: extract test helpers, add scripts, update checklists, fix role definitions, document bug patterns, create ADRs for implicit decisions +3. **Record** — Log improvements in `SESSION_STATE.md` → "Process Improvements" for cross-session visibility + +See each role file (`*_ROLE.md`) for the full role-specific checklist of reflection questions and improvement actions. ### Principles -- cgit v1.2.3