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 <noreply@anthropic.com>

1 files changed, 11 insertions, 0 deletions

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