ryryo フィードバック → 仕様書蓄積（dev:feedback）
出力先
| ファイル | Step |
|---|---|
docs/FEATURES/{feature-slug}/DESIGN.md |
2a |
docs/FEATURES/DESIGN.md |
2a |
docs/FEATURES/{feature-slug}/IMPROVEMENTS.md |
3 |
実行手順（必ずこの順序で実行）
Step 0: SELECT（対象計画の選択）
docs/FEATURES/ 配下を走査し、ユーザーにフィードバック対象を選ばせる。
0a: feature 選択
Glob("docs/FEATURES/*/")で feature ディレクトリ一覧を取得- feature が 1つだけ → 自動選択（確認メッセージのみ出す）
- feature が 2つ以上 → AskUserQuestion で選択させる
- 各 option:
{ label: "{feature-slug}", description: "docs/FEATURES/{feature-slug}" }
- 各 option:
- 選択結果を
feature-slugとして保持
0b: story 選択
Glob("docs/FEATURES/{feature-slug}/stories/*/story-analysis.json")で story 一覧を取得- 各
story-analysis.jsonを Read し、story.title（またはstoryフィールド）を取得して選択肢の description に使う - story が 1つだけ → 自動選択
- story が 2つ以上 → AskUserQuestion で選択させる
- 各 option:
{ label: "{story-slug}", description: story.title }
- 各 option:
- 選択結果を
story-slugとして保持
ゲート: feature-slug + story-slug が確定
0c: ワークスペース初期化
bash .claude/skills/dev/feedback/scripts/init-feedback-workspace.sh {feature-slug}
DESIGN.md / IMPROVEMENTS.md が未作成の場合のみテンプレートを配置する（既存ファイルは上書きしない）。
Step 1: REVIEW（品質ゲート + 変更分析）
references/review-analyze.md を参照し、git diff を分析して品質ゲート判定 + 分析JSONを作成する。
- git diff main...HEAD で差分を取得
- OpenCode CLI（または手動チェックリスト）で実装レビュー
- 変更内容を分析し、学習事項を抽出 → 分析JSON
- レビュー結果をユーザーに提示
- Critical issuesがあれば → AskUserQuestion で次のアクションを確認:
/plan-docで修正計画書を作成（別スレッドで修正作業）/dev:storyで修正タスクリストを生成（別スレッドで修正作業）- そのまま続行（軽微な場合）
ゲート: レビュー + 分析JSON完了
Step 2: DESIGN（DESIGN.md更新 + 整理）
2a: 機能DESIGN.md + 総合DESIGN.md更新
references/update-design.md を参照し、Step 1 の分析結果を元に DESIGN.md を更新する。
- 既存の DESIGN.md を Read（なければ新規作成）
docs/FEATURES/{feature-slug}/DESIGN.mdに追記・保存docs/FEATURES/DESIGN.mdに重要な判断を追記
2b: 総合DESIGNの整理
- → Task（opus） に委譲（code-simplifier スキル）
- 整理観点:
- 用語・表現の一貫性
- セクション構造の論理性
- 冗長さの排除
- 将来の追記性
ゲート: 機能DESIGN.md + 総合DESIGN.md更新完了
Step 3: IMPROVE（ルール化検討 + CLAUDE.md更新検討 + テスト管理）
references/propose-manage.md を参照し、Step 1-2 の結果からルール化・CLAUDE.md更新の候補を検討して IMPROVEMENTS.md を Write する。
- 既存ルール一覧を
Glob(".claude/rules/**/*.md")で収集、CLAUDE.md を Read - OpenCode CLI（またはフォールバック基準）で改善分析
- 候補ごとに具体的な当てはめ先（
.claude/rules/{category}/{name}.mdorCLAUDE.mdの該当セクション）を明記 docs/FEATURES/{feature-slug}/IMPROVEMENTS.mdに保存- TDDタスクがあった場合:
- → AskUserQuestion でテスト整理方針を確認（整理する/すべて保持/スキップ）
- 選択に応じてテストの簡素化・削除を実行
完了条件
- feature-slug + story-slug が確定した（Step 0）
- 実装レビュー + 変更分析が完了した（Step 1）
- 機能DESIGN.mdが更新された（Step 2a）
- 総合DESIGN.mdが更新・整理された（Step 2a + 2b）
- ルール化・CLAUDE.md更新の候補が検討された（Step 3）
- テスト資産が整理された（TDD時）（Step 3）
参照
- agents/: code-simplifier（Step 2b 委譲先）
- references/: review-analyze.md, update-design.md, propose-manage.md
- references/templates/: DESIGN.template.md, IMPROVEMENTS.template.md
- scripts/: init-feedback-workspace.sh