Skip to content

Plan Guide

本ガイドは、プロジェクト全体の戦略的大日程計画を管理するために <root>/docs/plan.md に作成する「全体計画(戦略)」の構成規則、記述内容、およびMarkdownテンプレートを定義するものです。

概要と位置づけ

plan.md は、プロジェクト全体のロードマップと戦略的大日程を管理する最上位の計画ドキュメントです。 全体計画(戦略)は開発進行や要件変化に伴って 何度も変更されることを前提 として運用します。

本ドキュメントは、「マイルストーン」「フェーズ」 の2つの必須セクションのみでシンプルに構成します。


セクション構成と記述ルール

1. マイルストーン (Milestones)

プロジェクトの重要目標時点(リリース、α/β版提供等)を定義します。

IDタグ期日
M-1alpha2026-09-30
M-2beta2026-10-31
M-3release2026-11-30
  • ID: <M-ID(1)> 形式(例: M-1, M-2)。
  • タグ: リリース段階やバージョン名(例: alpha, beta, release, v1, v1.2 等)。
  • 期日: 達成目標日(YYYY-MM-DD 形式で必須記述)。

2. フェーズ (Phases)

マイルストーンを達成するために実施する具体的な開発フェーズを定義します。

ID概要マイルストーン
PHASE-001基本認証およびコアUIの実装M-1
PHASE-002データ同期機能および拡張APIの実装M-2
PHASE-003本番環境向けセキュリティ強化・最適化M-3
  • ID: <PHASE-ID> 形式(例: PHASE-001, PHASE-002)。
  • 概要: フェーズで達成する主目的・範囲の簡潔な1行概要(改行せず1行で記述)。
  • マイルストーン: 紐づくマイルストーンの <M-ID(1)>(例: M-1)。

運用ルール

  1. フェーズの並行進行: 各フェーズは順次実行だけでなく、必要に応じて複数フェーズを並行して進行させることも可能です。
  2. 変更の許容: 状況変化に応じてマイルストーンの期日やフェーズの分割・見直しを柔軟に行います。
  3. backlog との連携: 各フェーズに帰属するユースケース、feature、仕様書の実装ステータスは、全体バックログ台帳である docs/backlog/phase.md にてビューとして一覧管理します。

Template

以下は docs/plan.md を作成する際の標準Markdownテンプレートです。

markdown
---
name: plan.md
description: <プロジェクトの全体計画・マイルストーン概要>
timestamp: YYYY-MM-DD
ai: ai-coauthored
---

# Plan

## マイルストーン

| ID | タグ | 期日 |
| :--- | :--- | :--- |
| `M-1` | `alpha` | `YYYY-MM-DD` |
| `M-2` | `beta` | `YYYY-MM-DD` |
| `M-3` | `release` | `YYYY-MM-DD` |

## フェーズ

| ID | 概要 | マイルストーン |
| :--- | :--- | :--- |
| `PHASE-001` | <フェーズ1の1行概要> | `M-1` |
| `PHASE-002` | <フェーズ2の1行概要> | `<M-ID(1)>` |
| `PHASE-003` | <フェーズ3の1行概要> | `<M-ID(1)>` |