/incremental-dev

description: 増分開発の計画を立案する
allowed-tools: Read, Glob, Grep, Task, Bash, AskUserQuestion, Write
argument-hint: "[開発対象（機能名/改善内容/自然言語）]"

増分開発の対象を分析し、初期調査から追加調査を経て、実装方法毎のPRD（Product Requirements Document）を作成します。すべてのファイルは500行以内に分割して出力します。

context

出力ディレクトリ=".dcs" カレントディレクトリ={{プロジェクトルート}} 分析ファイルリスト=[] 追加調査リスト=[] 実装アプローチリスト=[]

step

• $1 がない場合、「引数に開発対象を指定してください（例: 機能名、改善内容、または自然言語での説明）」と言って終了する
• $1 の内容を簡潔に説明する
• AskUserQuestion ツールを使って以下の質問を順番に実施し、context を更新する：

1. 開発の種類を確認 2. 実装の優先事項を確認 3. 調査の深さを確認 4. 除外条件の有無を確認

• 収集した context の内容をまとめてユーザに宣言する
• step2 を実行する

step2: 初期調査の実施

• 既存の出力ファイルを確認して、重複しないナンバリングを決定する
• {{出力ディレクトリ}}/{{timestamp}}_* を検索
• 今回の内容を簡単に英語化したもの（例: "user_auth", "payment_feature"）を作成
• 同じ timestamp と内容で既存ディレクトリがある場合、末尾の連番を +1 する
• ベースディレクトリを "{{出力ディレクトリ}}/{{timestamp}}_{{内容の英語化}}" とする
• 例: ".dcs/20251025_143000_user_auth"
• 例: ".dcs/20251025_143000_payment_feature"
• 初期調査用ファイルのリストを準備する
• インデックスファイル: "{{ベースディレクトリ}}/index.md"
• 初期調査サマリー: "{{ベースディレクトリ}}/survey_summary.md"
• 既存実装調査: "{{ベースディレクトリ}}/existing_impl.md"
• 技術スタック: "{{ベースディレクトリ}}/tech_stack.md"
• 依存関係分析: "{{ベースディレクトリ}}/dependencies.md"
• 複雑度評価: "{{ベースディレクトリ}}/complexity.md"
• 課題と制約: "{{ベースディレクトリ}}/constraints.md"
• すべてのファイル名を 分析ファイルリスト に追加する
• <initial_survey_template> の内容を context の情報で埋めて、Task ツールで直接実行する
• subagent_type: "general-purpose"
• description: "増分開発 初期調査の実行"
• prompt: テンプレートの内容を context で埋めた完全なプロンプト
• Task の実行結果を受け取る
• step3 を実行する

step3: 追加調査内容の決定とヒアリング

• 出力されたファイルを Read で確認する
• 初期調査サマリーから追加調査が必要な項目を抽出する
• 追加調査の観点に基づいて、調査項目をリストアップする（3〜5項目程度）
• 追加調査項目をユーザに提示し、AskUserQuestion で以下を確認する：
• どの追加調査を実施するか（multiSelect: true）
• 実装アプローチの候補（複数選択可能）
• ユーザの選択に基づいて 追加調査リスト と 実装アプローチリスト を更新する
• step4 を実行する

step4: 追加調査の実施

• 追加調査リスト が空の場合、step5 にスキップする
• 追加調査リスト の各項目に対して、以下を実行する：
• 追加調査用のファイル名を決定する
• "{{ベースディレクトリ}}/detail_{{調査項目の英語化}}_{{連番}}.md"
• 例: ".dcs/20251025_143000_user_auth/detail_security_2.md"
• ファイル名を 分析ファイルリスト に追加する
• <additional_survey_template> の内容を使って、Task ツールで追加調査を実行する
• subagent_type: "general-purpose"
• description: "追加調査: {{調査項目名}}"
• prompt: テンプレートの内容を context で埋めた完全なプロンプト
• Task の実行結果を受け取る
• すべての追加調査が完了したら、step5 を実行する

step5: PRDの作成

• 実装アプローチリスト が空の場合、デフォルトのアプローチを1つ設定する
• 実装アプローチリスト の各アプローチに対して、以下を実行する：
• PRD用のファイル名を決定する
• インデックス: "{{ベースディレクトリ}}/prd_{{アプローチの英語化}}_index.md"
• 要件定義: "{{ベースディレクトリ}}/prd_{{アプローチの英語化}}_requirements.md"
• 技術設計: "{{ベースディレクトリ}}/prd_{{アプローチの英語化}}_design.md"
• 実装計画: "{{ベースディレクトリ}}/prd_{{アプローチの英語化}}_plan.md"
• テスト戦略: "{{ベースディレクトリ}}/prd_{{アプローチの英語化}}_tests.md"
• リスクと対策: "{{ベースディレクトリ}}/prd_{{アプローチの英語化}}_risks.md"
• すべてのPRDファイル名を 分析ファイルリスト に追加する
• <prd_template> の内容を使って、Task ツールでPRDを作成する
• subagent_type: "general-purpose"
• description: "PRD作成: {{アプローチ名}}"
• prompt: テンプレートの内容を context で埋めた完全なプロンプト
• Task の実行結果を受け取る
• すべてのPRDが完了したら、step6 を実行する

step6: 最終サマリーの作成

• <final_summary_template> の内容を使って、Task ツールで最終サマリーファイルを作成する
• subagent_type: "general-purpose"
• description: "増分開発 最終サマリーの作成"
• prompt: サマリーテンプレートの内容を context で埋めた完全なプロンプト
• 最終サマリーファイル名: "{{ベースディレクトリ}}/final_summary.md"
• 全ての分析ファイルのパスをフェーズ別に整理して表示する
• 初期調査ファイル一覧
• 追加調査ファイル一覧（該当する場合）
• PRDファイル一覧（アプローチ毎）
• 最終サマリー
• 開発計画完了をユーザに報告する

rules

確認ポイント

AskUserQuestion ツールを使って、以下の質問を順番に実施する：

質問1: 開発の種類

• **質問**: どのような開発を行いますか？
• **header**: "開発種類"
• **options**:
• "新機能追加" - 新しい機能を追加する
• "既存機能改善" - 既存機能の拡張や改良
• "リファクタリング" - コード品質向上のための再構成
• "バグ修正" - バグの修正とその影響範囲の調査

質問2: 実装の優先事項

• **質問**: 実装において最も優先したい事項は何ですか？
• **header**: "優先事項"
• **multiSelect**: true
• **options**:
• "品質" - コード品質とテストカバレッジを重視
• "速度" - 実装速度と早期リリースを重視
• "保守性" - 将来の保守やメンテナンス性を重視
• "パフォーマンス" - 実行速度や効率を重視

質問3: 調査の深さ

• **質問**: どの程度の深さで調査を行いますか？
• **header**: "調査深度"
• **options**:
• "簡易" - 基本的な影響範囲の確認のみ
• "標準" - 通常レベルの詳細調査
• "詳細" - 深い分析と複数の追加調査
• "徹底" - 最も詳細な調査と複数の実装案検討

質問4: 除外条件

• **質問**: 調査から除外したい対象はありますか？
• **header**: "除外条件"
• **multiSelect**: true
• **options**:
• "テストコード" - テストファイルを除外
• "ドキュメント" - ドキュメントファイルを除外
• "特定ディレクトリ" - 特定のディレクトリを除外（追記で指定）
• "除外なし" - すべて分析対象にする

contextとして以下を保持する

• 開発対象（具体的な機能名や改善内容）
• 開発の種類
• 実装の優先事項
• 調査の深さ
• 除外条件

ファイル名のルール

timestamp の形式

• yyyyMMddHHmmss 形式（例: 20251025143000）

内容の英語化のルール

• 開発対象を簡潔な英語に変換する
• スネークケース（snake_case）を使用
• 最大30文字程度に収める
• 例:
• "ユーザー認証機能" → "user_auth"
• "決済機能の改善" → "payment_improve"
• "データベースリファクタリング" → "db_refactor"
• "APIエンドポイント追加" → "api_endpoint"

セクション別ファイル名のルール

• 各セクションは500行以内を目標とする
• 各セクションには専用のサフィックスを付与

**初期調査**:

• `index.md` - インデックス（全体概要とファイル一覧）
• `survey_summary.md` - 初期調査サマリー
• `existing_impl.md` - 既存実装調査
• `tech_stack.md` - 技術スタック
• `dependencies.md` - 依存関係分析
• `complexity.md` - 複雑度評価
• `constraints.md` - 課題と制約

**追加調査**（必要に応じて）:

• `detail_{topic}_{n}.md` - 追加調査の詳細（topic=調査項目、n=連番）

**PRD**（アプローチ毎）:

• `prd_{approach}_index.md` - PRDインデックス
• `prd_{approach}_requirements.md` - 要件定義
• `prd_{approach}_design.md` - 技術設計
• `prd_{approach}_plan.md` - 実装計画
• `prd_{approach}_tests.md` - テスト戦略
• `prd_{approach}_risks.md` - リスクと対策

**最終サマリー**:

• `final_summary.md` - 全体サマリー

完全なファイル名の例

**初期調査**:

• `.dcs/20251025143000_user_auth/index.md`
• `.dcs/20251025143000_user_auth/survey_summary.md`
• `.dcs/20251025143000_user_auth/existing_impl.md`
• `.dcs/20251025143000_user_auth/tech_stack.md`
• ...

**追加調査**:

• `.dcs/20251025143000_user_auth/detail_security_2.md`
• `.dcs/20251025143000_user_auth/detail_performance_3.md`

**PRD**（アプローチA）:

• `.dcs/20251025143000_user_auth/prd_jwt_index.md`
• `.dcs/20251025143000_user_auth/prd_jwt_requirements.md`
• `.dcs/20251025143000_user_auth/prd_jwt_design.md`
• ...

**PRD**（アプローチB）:

• `.dcs/20251025143000_user_auth/prd_session_index.md`
• `.dcs/20251025143000_user_auth/prd_session_requirements.md`
• ...

**最終サマリー**:

• `.dcs/20251025143000_user_auth/final_summary.md`

ファイルパスの記載ルール

• **カレントディレクトリを基準とした相対パスを使用する**
• フルパス（絶対パス）は記載しない
• 例:

-