brainstorm について
brainstormは、対話を通じて既存のロードマップ項目の意図を設計判断にまとめるjackin'の開発スキルです。Designセクションを段階的に更新し、タスク分割や実装は後続の作業に委ねます。
主な機能
- 01ロードマップの背景と関連調査の読み込み
- 02代替案やトレードオフの検討
- 03Designへの判断の段階的な記録
- 04--resumeによる設計の続行
- 05確定した設計更新のコミットとプッシュ
活用シーン
- 01ロードマップ項目の設計方針の検討
- 02後続作業に向けた判断とトレードオフの記録
- 03未完了の設計議論の再開
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ jackin-project/ jackin-dev --skill brainstormインストール後、Claude Code で/brainstormを入力して読み込まれたか確認します。
詳細
ブレインストーミング
既存のロードマップ項目の意図(および収集済みの調査結果)を、担当者との自由なやり取りを通じて具体的な設計上の決定に落とし込み、項目の ## Design セクションに段階的に記述します。
判断を行うタスクです。説明して決定するものであり、スクリプトを作成したり、コードを書いたり、作業をタスクに分割したりしないでください(それは plan の役割であり、ここでは扱いません)。
使用する場面
- 担当者が
/jackin-dev:brainstorm <slug>を実行し、未対応のロードマップ項目を設計する場合。
使用しない場面
- 項目を作成する場合 →
/jackin-dev:propose。 - 大規模な外部調査またはコードベースの調査を行う場合 →
/jackin-dev:research。 - 実装する場合 →
/goal Implement <slug>.md。
引数
--research— 項目の情報が不足しているようであれば、まず/jackin-dev:researchを実行します。--resume— 現在の## Designの状態から続行します。
プロセス
- コンテキストを読み込む。
docs/content/docs/roadmap/<slug>.mdxの Problem、Why It Matters、Design-so-far、Related Files と、すでにリンクされている調査資料を読みます。 - 自由形式で話し合う。 自由なやり取りを通じて、選択肢、トレードオフ、未解決の質問を提示します。制約として、jackin' の設計原則と関連するルールファイル(
ENGINEERING.md、HOST_AND_CONTAINER.md、TUI/ドキュメントのルール)を参照します。質問は一度に1つを基本とし、各項目が固まるたびに確認します。 - 段階的に書き込む。 各ポイントが固まったら、その決定と一行の理由を
.mdxの## Design内の該当箇所に追記または更新します。--resumeを指定すると、そこから再開します。 - 不明点が出た場合。 すばやく情報を集めます(Explore/grep、または
deep-research)。大規模な調査の場合は、別途/jackin-dev:researchで調査資料を作成し、## Designからリンクします。その後、決定を続けます。 - 結論をまとめる。
## Designでアプローチを最初から最後まで網羅できたら、要約し、実装のステップ(/goal Implement <slug>.md)を示します。 - コミットしてプッシュする。 固まった内容のまとまりごとに
docs:でコミットします(コミットのたびにプッシュします)。
よくある間違い
- コードを書く、または
## Tasksを埋める(対象外です)。 - 自由なやり取りをせずに完成した設計を一気に書き込む、または一度に多くの質問をする。
- 決定事項を
## Designではなくチャット内にだけ記録する(再開できる状態にしておく必要があります)。 - ルールファイルの内容を繰り返し記述し、ファイル名での参照にしない。
コメント
Markdown 対応