The most important point of this skill: automatically reflect retrospective learnings into CLAUDE.md, rules, and agents to enable autonomous organizational evolution.
Data collection
Sprint Review Report
!cat docs/sprint-reviews/*.md 2>/dev/null | tail -100 || echo "sprint-review を先に実行してください"
Sprint log (agent activity record)
!cat .claude/sprint-log.md 2>/dev/null
List of changes in the current sprint
!git log --oneline --since="2 weeks ago" 2>/dev/null
Current rules
!cat .claude/rules/code-style.md 2>/dev/null | head -30
Step 1: Ask the scrum-master agent to organize the KPT
Ask the scrum-master agent to do the following: "Based on the above data, please organize the KPT (Keep/Problem/Try) for the current sprint. For Problem and Try, please also include mapping to specific improvement files."
Step 2: Reflect Try actions in the appropriate files
Based on the scrum-master's KPT results, update each file according to the following classifications:
Improvement of coding rules
Target: .claude/rules/code-style.md / .claude/rules/testing.md / .claude/rules/security.md
Example: "Design Supabase RLS policies before implementation" → .claude/rules/security.md append to
Improvement of agent behavior
Target: .claude/agents/[agent-name]/AGENT.md
Example: "reviewer overlooked the RLS check" → .claude/agents/reviewer/AGENT.md add to the checklist
Improvement of Hooks
Target: .claude/hooks/ Shell scripts under
Example: "Automate backup before migration" → pre-tool/auto-backup.sh add
Update the iron rules in CLAUDE.md
Most important: CLAUDE.md Append the current sprint's lessons to the "Rules learned in sprints" section of
<!-- CLAUDE.md の「スプリントで学んだルール」に追記するフォーマット -->
- [Sprint N - YYYY-MM-DD] [学んだルール]
Step 3: Record improvement items for the next sprint in sprint-state.md
.claude/sprint-state.md Add a "Improvement actions for the next sprint" section to
Step 4: git commit the changes
TODAY=$(date +%Y-%m-%d)
SPRINT=$(grep 'Sprint番号' .claude/sprint-state.md | grep -o '[0-9]*' | head -1)
git add \
CLAUDE.md \
.claude/rules/ \
.claude/agents/ \
.claude/hooks/ \
.claude/sprint-state.md \
.claude/sprint-log.md
git commit -m "chore: apply retro learnings from Sprint ${SPRINT} ($TODAY)" 2>/dev/null || echo "変更なし"
Step 5: Ask the reporter agent to save the minutes
Ask the reporter agent to do the following:
"Save the retrospective minutes for the current sprint as docs/sprint-reviews/sprint-N-retro.md and send a completion notification to Slack."
Completion check
Please confirm the following:
- The "Rules learned in sprints" section of CLAUDE.md has been updated
- The relevant rules/*.md have been updated (if any)
- The relevant agents/*.md have been updated (if any)
- git commit has been completed
- The sprint-state.md template for the next sprint is ready