| 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。
本スキルは bundled resources（references/）で自己完結する。
パス表記の規約（重要）: 本 SKILL.md 中の references/… は、すべて 本スキル
ディレクトリからの相対パス（= <skill_dir>/…）であって、導入先リポジトリのルートからの
相対パスではない。実行時はまず <skill_dir>（このファイルが置かれているディレクトリ）を
解決してから使う:
| 環境 | <skill_dir> |
|---|
| plugin 導入先（Claude marketplace） | <plugin_root>/skills/ai-dev-brainstorm/ |
install.sh --claude 導入先 | .claude/skills/ai-dev-brainstorm/ |
| Codex 導入先 | .codex/skills/ai-dev-brainstorm/ |
| 上流リポジトリ（正本側） | .agents/skills/ai-dev-brainstorm/ |
導入先が独自の正本（上流リポジトリの docs/ 配下に相当するもの）を別途保持している
場合は、そちらを優先すること。
Read First
参照解決順（導入先で必ずこの順に探す）
本 Skill は 上流リポジトリ基準の docs/** パスを直接参照しない（#1232）。docs/** は
install.sh --claude / plugin（Claude marketplace）/ Codex の 3 経路とも配布対象外であり、
書いた時点で導入先では必ず空振りするためである。参照の解決は次の順で行う:
<skill_dir> 配下の同梱物（references/）を第一に読む — ワークフロー正本と実行契約は
本スキルに同梱されている（「同梱リファレンス」節の一覧）- 導入先リポジトリが独自の正本（上流の
docs/ 配下に相当するもの）を保持していれば、
そちらを優先する
- rules（
rules/*.md）だけは配布経路によって着地が異なるため、次の順で探す:
- 導入先リポジトリの相対パス（例:
.claude/rules/working-context.md）。
ただし 本 skill が参照する節（例: working-context.md の「pbi-input.md」節）が実在することを確認する。同名でも別内容なら PlanGate の正本ではないため次へ進む
- 無ければ plugin root 配下（例:
<plugin_root>/rules/working-context.md）。
<plugin_root> は Bash で ls "${CLAUDE_PLUGIN_ROOT}/rules/" を実行して展開・確認した
絶対パス（Read ツールは絶対パスを要求し環境変数を展開しないため、${CLAUDE_PLUGIN_ROOT}/...
という文字列をそのまま Read しない）。変数が空・未設定ならキャッシュを glob で推測せず次へ進む
- いずれでも解決できなければ 「正本
<path> を参照できなかった」と明示し、同梱
references/ と本 Skill の記述を代替正本として扱い、推測で内容を補わない
plugin root 直下に docs/ を探しに行かないこと: plugin が配布するのは
agents / commands / skills / rules 等の定義ディレクトリのみで docs/ を配布対象として
認識せず、plugin root 配下に相当する配布物が存在しないため必ず空振りする。
導入経路ごとに配置されるものが違う:
| 参照 | install.sh --claude 経由 | plugin（Claude marketplace）経由 | Codex 経由 |
|---|
rules/*.md | .claude/rules/ に着地（解決可） | <plugin_root>/rules/ で解決 | 未配置（解決不可 → 手順 4 へ） |
| ワークフロー正本・実行契約 | <skill_dir>/references/ に同梱（解決可） | <skill_dir>/references/ に同梱（解決可） | <skill_dir>/references/ に同梱（解決可） |
scripts/** / bin/** | コピー対象外（解決不可） | 目的の CLI は不在（解決不可） | 未配置（解決不可） |
例外（上流リポジトリ内のドッグフーディング経路 / #1249 MINOR-3）: 上表「Codex 経由」の
「同梱（解決可）」が成立するのは 配布物経由（plugin/plangate/scripts/install-plangate-skills.sh。
source は plugin/plangate/skills/）に限る。上流リポジトリ自身が .codex/skills/ を作る
scripts/install-plangate-skills-to-codex.sh は source が .agents/skills/ であり、そこには
本 skill の references/ が 存在しない（references/ は scripts/sync-plugin-plangate.sh が
plugin/plangate/skills/** にだけ生成する）。したがって上流 repo の
.codex/skills/<skill>/references/ は 構造上つねに不在であり、この経路では契約 doc・
テンプレートは手順 4（解決できなかったと明示）に落ちる。上流では docs/** の正本を直接
読めるため実害は無いが、上表の「解決可」を上流の .codex/ にまで拡大解釈しないこと。
経路自体の是正（source の一本化）は #1086 の裁定待ち。
install.sh --claude のコピー対象は agents / skills / commands / rules の 4 ディレクトリ
のみ。Codex 経由（install_codex()）は install-plangate-skills.sh を呼ぶだけで skills しか
配置されないため、rules 参照は解決順 3-1・3-2 とも成立せず必ず手順 4 に落ちる。
同梱リファレンス（<skill_dir>/references/）
| ファイル | 役割 |
|---|
references/ai-driven-development.md | ワークフロー全体像・ゲート条件・成果物の保存先 |
references/core-contract.md | 実行契約（Iron Law / Stop rules / Output discipline）の正本 |
references/plangate.md | PlanGate 概要ガイド |
読む順序
CLAUDE.mdAGENTS.md.claude/rules/working-context.md → fallback <plugin_root>/rules/working-context.md
（PBI INPUT PACKAGE の必須要素・ディレクトリ構造の正本）
- どちらでも解決できない場合は下記「Rules」節を代替正本とし、
pbi-input.md に「正本
working-context.md を参照できなかった」旨を記録する
references/ai-driven-development.md（同梱。導入先が独自正本を持つ場合はそちらを優先）
- 最低限:
## ワークフロー全体像、## ゲート条件、## 成果物の保存先
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 の手順が担っている。
- 本 skill の手順をそのまま実行する — 「Read First」の読む順序 →「Rules」
（1 問ずつ・最大 3 問・plan/todo/test-cases は作らない）→「Output」という順序と
出力契約は CLI の有無に関わらず不変
- 作業ディレクトリは自分で用意する — CLI が行うのは
docs/working/TASK-XXXX/ の
作成と status.md スタブ生成だけ。導入先では同じパス（または導入先の working context
に相当するパス）を手で作り、pbi-input.md と status.md をそこに置く
- 後続ゲートを省略しない — brainstorm の出力は
pbi-input.md までであり、
plan / C-1 / C-2 / C-3 は CLI が無くても従来どおり必要。CLI が使えないことを理由に
ai-dev-plan 以降のゲートを飛ばさない
- CLI 実行そのものが必要なら、上流リポジトリ（
s977043/plangate）を clone して
そこから実行する
次フェーズへ
brainstorm 完了後は ai-dev-plan skill で B-1→B-2→B-3 フローを実行する。
