フィードバック → 仕様書蓄積(dev:feedback)
エージェント委譲ルール
分析・更新・提案は必ずTaskエージェントに委譲する。自分で実行しない。
呼び出しパターン(全ステップ共通):
agentContent = Read(".claude/skills/dev/feedback/agents/{agent}.md")
Task({ prompt: agentContent + 追加コンテキスト, subagent_type: {type}, model: {指定モデル} })
| Step | agent | model | type | 追加コンテキスト |
|---|---|---|---|---|
| 1 REVIEW | review-analyze.md | sonnet | general-purpose | git diff, feature-slug |
| 2a DESIGN | update-design.md | sonnet | general-purpose | Step 1のJSON + feature-slug |
| 2b DESIGN | (code-simplifier) | opus | code-simplifier | DESIGN.mdのパス + 整理観点 |
| 3 IMPROVE | propose-manage.md | sonnet | general-purpose | Step 1-2の結果 + feature-slug |
出力先
| ファイル | Step |
|---|---|
docs/features/{feature-slug}/DESIGN.md |
2a |
docs/features/DESIGN.md |
2a |
docs/features/{feature-slug}/IMPROVEMENTS.md |
3 |
実行手順(必ずこの順序で実行)
Step 1: REVIEW(品質ゲート + 変更分析)
- → エージェント委譲(review-analyze.md / sonnet)
- 「この実装、マージして大丈夫か?」の品質ゲート判定
- 変更内容を分析し、学習事項を抽出 → 分析JSON
- レビュー結果をユーザーに提示
- Critical issuesがあれば → AskUserQuestion で次のアクションを確認:
/plan-docで修正計画書を作成(別スレッドで修正作業)/dev:storyで修正タスクリストを生成(別スレッドで修正作業)- そのまま続行(軽微な場合)
ゲート: レビュー + 分析JSON完了
Step 2: DESIGN(DESIGN.md更新 + 整理)
2a: 機能DESIGN.md + 総合DESIGN.md更新
- → エージェント委譲(update-design.md / sonnet)
docs/features/{feature-slug}/DESIGN.mdに追記・保存docs/features/DESIGN.mdに重要な判断を追記
2b: 総合DESIGNの整理
- → エージェント委譲(code-simplifier / opus)
- 整理観点:
- 用語・表現の一貫性
- セクション構造の論理性
- 冗長さの排除
- 将来の追記性
ゲート: 機能DESIGN.md + 総合DESIGN.md更新完了
Step 3: IMPROVE(スキル/ルール化検討 + テスト管理)
- → エージェント委譲(propose-manage.md / sonnet)
docs/features/{feature-slug}/IMPROVEMENTS.mdに保存- TDDタスクがあった場合:
- → AskUserQuestion でテスト整理方針を確認(整理する/すべて保持/スキップ)
- 選択に応じてテストの簡素化・削除を実行
完了条件
- 実装レビュー + 変更分析が完了した(Step 1)
- 機能DESIGN.mdが更新された(Step 2a)
- 総合DESIGN.mdが更新・整理された(Step 2a + 2b)
- スキル/ルール化候補が検討された(Step 3)
- テスト資産が整理された(TDD時)(Step 3)
参照
- agents/: review-analyze.md, update-design.md, propose-manage.md