project-planning について
project-planning は、確定した仕様をアーキテクチャの決定、実装タスク、スプリント計画にまとめるスキルです。簡易的な計画を支援し、詳細なタスク計画は spec-kit:task-planning に委ねます。
主な機能
- 01要件のタスク分解
- 02依存関係とクリティカルパスの整理
- 03アーキテクチャとインターフェースの定義
- 04トレードオフとリスクの記録
- 05計画後の実行フェーズへの移行
活用シーン
- 01仕様確定後の実装計画
- 02開発タスクへの作業分解
- 03スプリント間のタスク配分
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ athola/ claude-night-market --skill project-planningインストール後、Claude Code で/project-planningを入力して読み込まれたか確認します。
詳細
委任
詳細なタスク計画のワークフローについては、このスキルは標準的な実装として spec-kit:task-planning に委任します。簡易的な計画にはこのスキルを、綿密なプロジェクト計画には spec-kit を使用してください。
使用するタイミング
- 仕様策定フェーズが完了した後
- システムアーキテクチャの設計が必要な場合
- 実装に向けたタスクの分解が必要な場合
- スプリントとリソース配分を計画する場合
- 要件を具体的なタスクに落とし込む場合
- コンポーネントのインターフェースと依存関係を定義する場合
使用しないタイミング
- まだ仕様がない場合(まず
Skill(attune:project-specification)を使用してください) - まだ問題領域を探索している場合(代わりに
Skill(attune:project-brainstorming)を使用してください) - 既存の計画を実行する準備ができている場合(代わりに
Skill(attune:project-execution)を使用してください) - 進行中のプロジェクトを調整する必要がある場合(再開せず、計画を段階的に更新してください)
連携
superpowers と併用する場合:
- 構造化された計画には
Skill(superpowers:writing-plans)を使用します - チェックポイントに基づく実行パターンを適用します
- 依存関係分析フレームワークを使用します
superpowers を併用しない場合:
- 単独で使える計画手法
- タスク分解テンプレート
- 依存関係を追跡するパターン
品質チェック
計画を完了する前に、次の項目を確認してください。
- ✅ すべてのアーキテクチャコンポーネントが文書化されている
- ✅ タスクより前に File Structure セクションがある
- ✅ すべてのタスクファイルが File Structure の表に記載されている
- ✅ すべての FR がタスクに対応付けられている
- ✅ すべてのタスクに受け入れ基準がある
- ✅ 依存関係に循環がない
- ✅ 工数見積もりが提示されている
- ✅ クリティカルパスが特定されている
- ✅ リスクが評価され、軽減策が提示されている
- ✅ スプリントの作業量がキャパシティに応じて配分されている
トレードオフを記録する(意思決定ジャーナル)
アーキテクチャとスコープに関する意思決定は計画時に行われます。選択したパターン、受け入れた依存関係、後回しにした作業など、実質的な選択肢があった決定を docs/tradeoffs.md に記録してください(下書きを作成して確認します)。
- leyline がインストールされている場合は、
Skill(leyline:decision-journal)を呼び出して、トレードオフの項目(決定内容、比較検討した選択肢、断念したもの。phaseはplanに設定)を追記します。下書きを表示し、確認を受けてから追記してください。 - 代替手段(leyline がない場合):ファイル内の ENTRY TEMPLATE を使用して
docs/tradeoffs.mdに追記し、次のTR-NNNID を割り当てます。
完了後:ワークフローの続行(必須)
自動トリガー:品質チェックに合格し、docs/implementation-plan.md が保存された後、次のフェーズを必ず自動的に呼び出してください。
続行を呼び出す際:
docs/implementation-plan.mdが存在し、空でないことを確認します- 次のチェックポイントメッセージをユーザーに表示します。
Implementation plan complete. Saved to docs/implementation-plan.md. Proceeding to execution phase... - 次のフェーズを呼び出します。
Skill(attune:project-execution)
スキップ条件(次のいずれかに該当する場合のみ、続行をスキップしてください):
- ユーザーが
--standaloneフラグを指定した docs/implementation-plan.mdが存在しない、または空である(フェーズ失敗)- ユーザーが計画後に停止するよう明示的に要求した
ユーザーに確認を求めないでください:これは軽量なチェックポイントであり、対話的な承認ゲートではありません。必要であれば、ユーザーはいつでも中断できます。
終了条件
-
docs/implementation-plan.mdが存在し、空でなく、品質チェック(依存関係に循環がないこと、FR がタスクに対応付けられていること、クリティカルパスが特定されていること)に合格している。 - 代替案を含むアーキテクチャとスコープの決定が
docs/tradeoffs.mdに記録されている。 - スキップ条件に該当しない限り、実行フェーズが自動的に呼び出されている。
関連スキル
Skill(superpowers:writing-plans)- 計画手法(利用可能な場合)Skill(spec-kit:task-planning)- タスク分解(利用可能な場合)Skill(attune:project-specification)- 前のフェーズSkill(attune:project-execution)- 計画後に自動的に呼び出される次のフェーズSkill(attune:mission-orchestrator)- ライフサイクル全体のオーケストレーション
関連コマンド
/attune:blueprint- このスキルを呼び出す/attune:execute- ワークフローの次のステップ
例
完全な例については、/attune:blueprint コマンドのドキュメントを参照してください。
トラブルシューティング
よくある問題
タスクグラフに循環依存が見つかった場合は、いずれかのタスクをより小さなサブタスクに分割してください。スプリントのキャパシティを継続的に超過している場合は、フィボナッチスケールを使ってタスクを再見積もりするか、スプリントのスコープを縮小してください。