project-planning

[Planning Artifact] の種類とは？

プロジェクト計画の手順では、[Epic]、[Spec]、[Story]、[Task]、[Research]、[Decision] の形式で種類が頻繁に参照されます。

これは、読者またはエージェントに、これらがそれぞれ固有の役割を持つ別個のアーティファクトの種類であることを認識してもらうためです。

• [PRD]：製品要件定義書です。製品が達成すべきことを大まかに示します。ステークホルダーのニーズと期待を捉えます。[PRD] は、マネージャーが 1 つ以上の [Epic] を作成する際の指針となります。
• [Epic]：複数の Story で構成される大規模な作業単位です。[Epic] には必ず [Spec] が伴い、両者は 1 対 1 の関係にあります。
• [Spec]：プロジェクトの要件と目的を詳しく記述したものです。1 つ以上の [Story] の作成につながります。
• [Research]：プロジェクトの意思決定に役立てるために実施する情報収集と分析です。主なフェーズは計画／開始時（PRD／Epic／Spec の作成中）です。副次的なフェーズとして、実装中に不明点が生じた場合に、実行中に随時実施します。[Research] は [Spec]、[Decision]、およびプロジェクトの方向性に情報を提供します。[PRD]、[Epic]、[Spec]、[Decision]、[Story]、または [Task] にリンクされます。
• [Decision]：多くの場合、[Research] に基づいて選択肢を評価したうえで下される結論です。[Decision] は [Spec] やプロジェクトの方向性に影響を与えることがあります。開始／計画時（戦略的な意思決定の場合）、または実行中（実装に関する意思決定の場合）に作成されます。ステータスは「Decided」または「Unresolved」でなければなりません。ステータスが「Unresolved」の [Decision] アーティファクトはすべて、クロージングフェーズ中に [Retrospective] にリンクする必要があります。
• [Story]：シナリオまたはユースケースであり、[Epic] から派生した、管理可能な作業単位です。[Story] には必ず「ユーザーストーリー」が含まれます。[Story] は必ず [Task] によって実装されます。
• [Task]：[Story] の一部として完了する必要がある、具体的な作業単位です。必ず [Story] と [Epic] の両方にリンクされます。また、他の [Task] と興味深い形で関連付けることもできます（例：ブロックしている、依存している、関連している）。
• [Retrospective]：Epic またはプロジェクトのフェーズの終了時に作成される振り返り用のアーティファクトであり、学んだ教訓、成功した点、改善点を記録します。チームとステークホルダーから得られた知見をまとめ、今後のプロジェクトに役立てます。各 [Retrospective] は、対応する [Epic] と、未解決の [Decision] アーティファクトにリンクされます。

ワークフローフェーズ

プロジェクトは、明確に区分された 5 つのフェーズを経て進行します。このスキルを実行するエージェントにとって、各アーティファクトがどのフェーズに属するかを理解することが重要です。

エージェントは、どのアーティファクトをいつ作成するか、ステータスをいつ変更するか、コンテンツをどう検証するかといった戦術的な意思決定を自律的に行いますが、戦略的な意思決定（スコープの変更、スケジュールの変更、技術的なリファクタリング、リソースの制約）については Q にエスカレーションします。

フェーズの概要

1. 計画 — 作業内容を定義するアーティファクトを作成します（PRD → Epic → Spec → Stories → Tasks）

   • → 参照：skill_reference(references/workflow/planning-phase.md)。アーティファクト作成の詳細な順序と検証ゲートを確認できます。

2. 実行 — ステータスの移行を通じて作業を完了させます

   • → 参照：skill_reference(references/workflow/execution-phase.md)。実行に関するガイダンスを確認できます。

3. クロージング — 完了した作業をアーカイブし、Epic／Project を正式に終了します

   • → 参照：skill_reference(references/workflow/closing-phase.md)。クロージングの手順を確認できます。

4. 振り返り — 学びを記録します（Epic または Project の完了後に実施できます）

   • → 参照：skill_reference(references/workflow/retrospective-phase.md)。振り返りに関するガイダンスを確認できます。

エスカレーションマトリクス

次の状況に遭遇した場合は、一時停止して Q にエスカレーションします。

• スコープの変更 — Epic または計画の途中で機能を追加／削除する場合
• スケジュールの変更 — 予想される納期が 1 週間を超えてずれる場合
• 技術的なリファクタリング — 作業中に設計変更が判明した場合
• リソースの制約 — Task／Story の複雑さが対応可能な範囲を超える場合

→ 参照：skill_reference(references/workflow/overview.md)。エスカレーションマトリクス全体、アーティファクトの関係図、エージェントの意思決定モデルを確認できます。

見積もり

見積もりが必要な場合は、次のリソースを参照してください。

• → 参照：skill_reference(references/estimation.md) 詳細な見積もり手法とベストプラクティスについては、こちらをご覧ください。

関係性

成果物間の明確な関係性を維持し、プロジェクトのライフサイクル全体を通じて追跡可能性とコンテキストを確保します。

• → 参照：skill_reference(references/relationships.md) すべての成果物タイプ（PRD、Epic、Research、Story、Task、Retrospective、Decision）における詳細な関係タイプと使用ガイドラインについては、こちらをご覧ください。

成果物のステータス遷移

各成果物タイプには、プロジェクトのライフサイクル全体を通じた状態管理の指針となる、有効なステータス遷移があります。

• → 参照：skill_reference(references/status-flow.md すべての成果物タイプ（PRD、Epic、Research、Story、Task、Retrospective、Decision）における詳細なステータスフロー図と説明については、こちらをご覧ください。

成果物のスキーマとコンテンツ構成

すべての成果物は、整理とリンクに一貫したスキーマパターンを使用します。
各成果物タイプには、固有のフロントマター要件とコンテンツセクションがあります。

→ すべての成果物タイプ（PRD、Epic、Research、Story、Task、Retrospective、Decision）における詳細なスキーマ定義、成果物のコンテンツ構成、リンクタイプの定義については、リンク先のスキルリソースを使用してください。

具体的な成果物スキーマについては、以下を参照してください。

• → PRD skill_reference(schema/01-artifact-prd.md)
• → Epic skill_reference(schema/02-artifact-epic.md)
• → Spec skill_reference(schema/03-artifact-spec.md)
• → Research skill_reference(schema/04-artifact-research.md)
• → Decision skill_reference(schema/05-artifact-decision.md)
• → Story skill_reference(schema/06-artifact-story.md)
• → Task skill_reference(schema/07-artifact-task.md)
• → Retrospective skill_reference(schema/08-artifact-retrospective.md)