task-planning

タスク計画

概要

仕様と実装計画を、依存関係に基づいて順序付けた具体的なタスクに変換します。体系的な実装を導く、段階的なタスク分解を作成します。

使用する場面

• 仕様を実装タスクに変換する
• 機能の実装順序を計画する
• 並行して実行できる作業を特定する
• 複雑な機能を段階に分解する

使用しない場面

• 仕様を書く場合 — spec-writing を使用してください

タスクのフェーズ

タスクは、セットアップから仕上げまでの5フェーズ構成に従います。

• フェーズ1：セットアップ - プロジェクトの初期化、依存関係、設定
• フェーズ2：基盤 - データモデル、インターフェース、テスト基盤
• フェーズ3：コア実装 - ビジネスロジック、API、サービス
• フェーズ4：統合 - 外部サービス、ミドルウェア、ロギング
• フェーズ5：仕上げ - 最適化、ドキュメント、最終テスト

各フェーズの詳細な定義、選択ガイドライン、アンチパターンについては、modules/phase-structure.md を参照してください。

タスクの形式

各タスクには以下を含めます。

• ID：一意の識別子（T001）
• 説明：明確なアクションの記述
• フェーズ：属するフェーズ
• 依存関係：先に完了している必要があるタスク
• 並列マーカー：並行して実行できる場合は [P]
• ファイル：影響を受けるファイルパス
• 完了基準：完了を確認する方法

依存関係のルール

依存関係によって実行順序を定義し、並列化できる作業を特定します。

• 順次実行タスク：依存関係がある場合は、厳密な順序で実行します
• 並列タスク [P]：競合しない条件をすべて満たす場合、並行して実行できます
• ファイルの調整：同じファイルに影響するタスクは、必ず順次実行する必要があります

並列実行における非競合の基準：

• ✅ ファイル：タスク間で重複するファイルがない
• ✅ 状態：共有設定やグローバル状態がない
• ✅ 依存関係：すべての前提条件が満たされている
• ✅ コードパス：マージの競合が発生しない
• ✅ 出力：各タスクが他のタスクの結果を必要としない

上記の基準をすべて満たす場合に限り、タスクに [P] を付けてください。

ファンアウト／ファンインのパターン、タスクIDの規則、検証ルールについては、modules/dependency-patterns.md を参照してください。

タスク項目の例

## Phase 3: Core Implementation

### T007 - Implement user authentication service [P]
**Dependencies**: T003, T004
**Files**: src/services/auth.ts, src/types/user.ts
**Criteria**: All auth tests pass, tokens are valid JWT

検証： pytest -v を実行して、テストが成功することを確認します。

品質チェックリスト

• すべての要件がタスクに割り当てられている
• 依存関係が明示されている
• 並列実行の機会が特定されている
• タスクの規模が適切である（大きすぎず、小さすぎない）
• 各タスクに明確な完了基準がある

関連スキル

• spec-writing：元となる仕様の作成
• speckit-orchestrator：ワークフローの調整

終了基準

• すべてのタスクに TNNN 形式（T001）の一意なIDがあり、 説明、フェーズ（1～5）、依存関係リスト、並列マーカー （[P] または順次実行）、ファイル、完了基準の各項目が含まれている
• [P] が付いたタスクは、競合しない5つの基準をすべて満たしている： ファイルの重複がない、共有状態がない、依存関係が満たされている、 マージ競合が発生しない、互いの出力に依存しない
• 元の仕様にあるすべての機能要件が、少なくとも1つのタスクに割り当てられている。 割り当てられていない要件にはフラグが立てられている
• 出力を確定する前に、品質チェックリストのすべての項目を満たしている
• 各フェーズ内のタスクは、同じフェーズ内でタスク番号が大きいタスクに 依存しない順序に並べられている