Work Documentation

Appearance

Backlog Phase Guide ​

本ガイドは、全体計画（docs/plan.md）に対するバックログ（ビュー）として <root>/docs/backlog/phase.md に作成・運用する「フェーズ台帳」の構成規則、記述内容、およびMarkdownテンプレートを定義するものです。

概要と位置づけ ​

phase.md は、全体計画（plan.md）で定義された各フェーズに対して、ユースケース（usecase）、動作機能単位（feature）、および機能仕様書（specification）を紐づけて進捗ステータスを一覧可視化する 全体バックログビュー（参照台帳） です。

主な特性と原則 ​

  • ビュー（参照台帳）の原則: phase.md は各設計書やステータスを一覧化するビューであり、正本ではありません（正本は各ユースケース、仕様書、および各台帳）。
  • 全件網羅性: phase.md には以下のすべてが漏れなく記載されていなければなりません。
    • docs/plan.md に定義されたすべてのフェーズ（<PHASE-ID>）
    • docs/backlog/usecase.md に定義されたすべての usecase および feature
    • 各コンポーネントの backlog/spec.md に定義されたすべての specification（機能仕様書）
  • フェーズ帰属の柔軟性:
    • 各要素（usecase/feature/specification）のフェーズ帰属には機械的な固定ルールはなく、フェーズの目標・概要に合わせて決定します。
    • 基本方針として、usecase/feature/specification の作成時に現在進行中のフェーズへ帰属させます。
    • フェーズは順次だけでなく並行して進行することも想定されます。

セクション構成とテーブルフォーマット ​

phase.md では、plan.md に定義されたフェーズごとにセクション（見出し）を作成し、それぞれに対応する台帳テーブルを記述します。

テーブル列定義 ​

列名必須/任意説明記述例
<USECASE-ID>必須ユースケース定義書へのリンク（存在しない場合は -）USECASE-001
<F-ID>必須feature ID（存在しない場合は -）F-1
<SPEC-ID>必須機能仕様書へのリンクSPEC-001
ステータス必須進捗ステータスTODO / WIP / DONE 等
Timestamp必須最終更新日（YYYY-MM-DD）2026-08-21

ステータスおよび Timestamp 判定ルール ​

  • usecase / feature が存在する場合: feature の実装ステータスおよび更新日（usecase.md 参照）を記述します。
  • usecase / feature が存在しない場合（- の場合）: specification（機能仕様書）の実装ステータスおよび更新日（コンポーネントの spec.md 参照）を記述します。

※ 詳細なステータス定義およびライフサイクル遷移規則は document-status-guide.md を参照してください。

Template ​

以下は docs/backlog/phase.md の標準Markdownテンプレートです。

markdown
---
name: phase.md
description: 全体計画（plan.md）に基づくフェーズ別ユースケース・仕様実装ステータス総合台帳
timestamp: YYYY-MM-DD
ai: ai-coauthored
---

# Phase Backlog

全体計画（[plan.md](../plan.md)）の各フェーズに帰属するユースケース、feature、および機能仕様書の実装状況を一覧管理する総合ビューです。

## PHASE-001: <フェーズ概要>

| UsecaseID | FeatureID | SpecID | ステータス | Timestamp |
| :--- | :--- | :--- | :--- | :--- |
| [`USECASE-001`](../usecases/USECASE-001.md) | `F-1` | [`SPEC-001`](../webui/specs/SPEC-001.md) | WIP | 2026-08-21 |
| [`USECASE-001`](../usecases/USECASE-001.md) | `F-2` | [`SPEC-002`](../webui/specs/SPEC-002.md) | TODO | 2026-08-21 |
| - | - | [`SPEC-003`](../webui/specs/SPEC-003.md) | TODO | 2026-08-21 |

## PHASE-002: <フェーズ概要>

| UsecaseID | FeatureID | SpecID | ステータス | Timestamp |
| :--- | :--- | :--- | :--- | :--- |
| [`USECASE-002`](../usecases/USECASE-002.md) | `F-1` | [`SPEC-004`](../webui/specs/SPEC-004.md) | DRAFT | 2026-08-21 |