summaryrefslogtreecommitdiff
path: root/DESIGN.md
diff options
context:
space:
mode:
Diffstat (limited to 'DESIGN.md')
-rw-r--r--DESIGN.md11
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