mcpField
P
project-planning

project-planning

github.com/athola開発343244 回インストール3 日前に更新
リポジトリ

project-planning について

project-planning は、確定した仕様をアーキテクチャの決定、実装タスク、スプリント計画にまとめるスキルです。簡易的な計画を支援し、詳細なタスク計画は spec-kit:task-planning に委ねます。

主な機能

  1. 01要件のタスク分解
  2. 02依存関係とクリティカルパスの整理
  3. 03アーキテクチャとインターフェースの定義
  4. 04トレードオフとリスクの記録
  5. 05計画後の実行フェーズへの移行

活用シーン

  1. 01仕様確定後の実装計画
  2. 02開発タスクへの作業分解
  3. 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-NNN ID を割り当てます。

完了後:ワークフローの続行(必須)

自動トリガー:品質チェックに合格し、docs/implementation-plan.md が保存された後、次のフェーズを必ず自動的に呼び出してください。

続行を呼び出す際:

  1. docs/implementation-plan.md が存在し、空でないことを確認します
  2. 次のチェックポイントメッセージをユーザーに表示します。
    Implementation plan complete. Saved to docs/implementation-plan.md.
    Proceeding to execution phase...
    
  3. 次のフェーズを呼び出します。
    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 コマンドのドキュメントを参照してください。

トラブルシューティング

よくある問題

タスクグラフに循環依存が見つかった場合は、いずれかのタスクをより小さなサブタスクに分割してください。スプリントのキャパシティを継続的に超過している場合は、フィボナッチスケールを使ってタスクを再見積もりするか、スプリントのスコープを縮小してください。

コメント