ai-dev-brainstorm

name	ai-dev-brainstorm
description	アイデアや曖昧な要件を PlanGate の PBI INPUT PACKAGE に対話的に整理する。Use when: docs/working/TASK-XXXX/pbi-input.md を新規作成したい時、要件をブレストして PBI に落としたい時。

AI-Driven Brainstorm (PlanGate / Codex 共用)

PlanGate ワークフローの brainstorm フェーズ を Codex / Claude Code 両方で実行する skill。

Read First

参照解決順（導入先で必ずこの順に探す）

本 skill の参照は上流リポジトリ基準の相対パスで書かれている。導入先ではそのままでは 解決できないものがあるため、次の順で探索する:

1. 導入先リポジトリの相対パス（例: .claude/rules/working-context.md）。 ただし 本 skill が参照する節（例: working-context.md の「pbi-input.md」節）が実在することを確認する。同名でも別内容なら PlanGate の正本ではないため 2 へ進む
2. 無ければ plugin root 配下（例: <plugin_root>/rules/working-context.md）。 <plugin_root> は Bash で ls "${CLAUDE_PLUGIN_ROOT}/rules/" を実行して展開・確認した 絶対パス（Read ツールは絶対パスを要求し環境変数を展開しないため、${CLAUDE_PLUGIN_ROOT}/... という文字列をそのまま Read しない）。変数が空・未設定ならキャッシュを glob で推測せず 3 へ進む
3. どちらにも無い場合は 「正本 <path> を参照できなかった」と明示し、推測で内容を補わない

plugin root 配下の探索は docs/** には適用しない（手順 2 は rules/*.md 等の 配布対象にのみ適用する）: plugin が配布するのは agents / commands / skills / rules 等の 定義ディレクトリのみで docs/ を配布対象として認識せず、plugin root 配下に相当する配布物が 存在しないため必ず空振りする。docs/** は手順 1 で解決できなければ手順 2 を飛ばして手順 3 へ進む。

導入経路ごとに配置されるものが違う:

参照	install.sh --claude 経由	plugin（Claude marketplace）経由	Codex 経由
rules/*.md	.claude/rules/ に着地（解決可）	<plugin_root>/rules/ で解決	未配置（解決不可 → 手順 3 へ）
docs/**	コピー対象外（解決不可）	バンドル対象外（解決不可）	未配置（解決不可）
scripts/** / bin/**	コピー対象外（解決不可）	目的の CLI は不在（解決不可）	未配置（解決不可）

install.sh --claude のコピー対象は agents / skills / commands / rules の 4 ディレクトリ のみ。Codex 経由（install_codex()）は install-plangate-skills.sh を呼ぶだけで skills しか 配置されないため、rules 参照は解決順 1・2 とも成立せず必ず手順 3 に落ちる。

読む順序

1. CLAUDE.md
2. AGENTS.md
3. .claude/rules/working-context.md → fallback <plugin_root>/rules/working-context.md （PBI INPUT PACKAGE の必須要素・ディレクトリ構造の正本）
   • どちらでも解決できない場合は下記「Rules」節を代替正本とし、 pbi-input.md に「正本 working-context.md を参照できなかった」旨を記録する
4. docs/ai-driven-development.md（配布対象外。上流リポジトリで作業する場合のみ解決する）
   • 最低限: ## ワークフロー全体像、## ゲート条件、## 成果物の保存先
   • 解決できない場合は 3 の rules を優先正本とする
5. docs/working/TASK-XXXX/status.md（存在する場合）

Output

• docs/working/TASK-XXXX/pbi-input.md
• 必要に応じて docs/working/TASK-XXXX/status.md（フェーズ進捗の初期記録）

Rules

• 1 問ずつ進める（最大 3 問の確認質問・多肢選択推奨）
• まだ plan.md / todo.md / test-cases.md は作成しない
• pbi-input.md の必須要素は .claude/rules/working-context.md の「pbi-input.md」節を参照 （解決できない場合は「参照解決順」に従い <plugin_root>/rules/working-context.md → それも無ければ必須要素を Context / Why・What（In / Out of scope）・受入基準・Notes from Refinement・Estimation Evidence（Risks / Unknowns / Assumptions） として扱い、 正本未参照である旨を pbi-input.md に記録する）
• 既存コードや関連制約はコードベースを確認してから要約する

CLI 呼び出し

下記は 上流リポジトリ（s977043/plangate）を clone し、そのリポジトリルートで 実行する場合にのみ成立する。上の表のとおり scripts/** / bin/** は 3 経路とも 導入先に配布されないため、plugin 経由・Codex 経由の環境では実行できない。

• 実コマンド: ./scripts/ai-dev-workflow TASK-XXXX brainstorm（--dry-run で生成先の確認のみ）
• skill 側はプロンプト規約のみ（Rule 2 遵守）

CLI 不在時のフォールバック（導入先では既定）

CLI が無くても brainstorm は成立する。同コマンドは 作業ディレクトリを作って status.md スタブを置き、「ai-dev-brainstorm skill を適用せよ」というプロンプトでエージェントを起動する だけのランチャであり、対話も生成も本 skill の手順が担っている。

1. 本 skill の手順をそのまま実行する — 「Read First」の読む順序 →「Rules」 （1 問ずつ・最大 3 問・plan/todo/test-cases は作らない）→「Output」という順序と 出力契約は CLI の有無に関わらず不変
2. 作業ディレクトリは自分で用意する — CLI が行うのは docs/working/TASK-XXXX/ の 作成と status.md スタブ生成だけ。導入先では同じパス（または導入先の working context に相当するパス）を手で作り、pbi-input.md と status.md をそこに置く
3. 後続ゲートを省略しない — brainstorm の出力は pbi-input.md までであり、 plan / C-1 / C-2 / C-3 は CLI が無くても従来どおり必要。CLI が使えないことを理由に ai-dev-plan 以降のゲートを飛ばさない
4. CLI 実行そのものが必要なら、上流リポジトリ（s977043/plangate）を clone して そこから実行する

次フェーズへ

brainstorm 完了後は ai-dev-plan skill で B-1→B-2→B-3 フローを実行する。