SpecDojo WBS設計ガイド

本ドキュメントは SpecDojo における WBS（Work Breakdown Structure）の設計原則を定義する。

SpecDojoでは、WBSは要求・要件・仕様で定義された

WHAT（何を作るか）

を定義するものであり、

WHEN（いつやるか）
IN WHAT ORDER（どの順序でやるか）

は Schedule が担う。

1. WBSの役割

SpecDojoにおけるWBSの責務は次の通りである。

項目	内容
Deliverable分解	成果物の分解
Scope Baseline	スコープ基準
Done Criteria	完了条件
Deliverable追跡	成果物と作業の対応

WBSは スケジュール情報を持たない。

2. Deliverable Driven 原則

SpecDojoでは

WBS Item = Deliverable責務

と定義する。

つまり

作業 = 成果物生成

である。

例

wbs:
  - id: WBS-AUTH-API-010
    name: login endpoint
    description: email/password を受け取って JWT を返すログインAPIを対象とする
    owner: EN
    deliverables:
      - path: src/auth/login-controller.ts
        kind: create
    done_criteria: login endpoint が動作する

3. WBS Itemの条件

良いWBS Itemは次の条件を満たす。

条件	内容
Deliverable明確	producesが明確
Scope明確	descriptionで対象が分かる
Done Criteria	完了条件が明確
Deterministic	成功条件が曖昧でない
Scope Unit	スコープ単位

4. WBS粒度

WBS粒度は Deliverable単位とする。

理想

1 WBS item = 1責務の成果物

例

良い

login endpoint
password validation
jwt token generation

悪い

authentication system

5. WBS構造

SpecDojoでは WBS は domain単位ファイルで管理する。

例

wbs-auth.yaml
wbs-payment.yaml
wbs-infra.yaml

各WBSは leaf deliverable items を列挙する。

6. WBS ID規則

推奨形式

WBS-<DOMAIN>-<NUMBER>

例

WBS-AUTH-010
WBS-AUTH-020
WBS-PAYMENT-010

componentを含めてもよい

WBS-AUTH-API-010

7. Deliverable定義

Deliverableには次の属性を持たせる。

属性	内容
path	repo path
kind	create / modify / reference
note	任意

例

deliverables:
  - path: src/auth/login-service.ts
    kind: create

8. Done Criteria

Done Criteria は スコープ完了条件である。

例

良い

login API が email/password を受け取り JWT を返す

悪い

login API を実装する

9. description / done criteria / notes の役割分担

description は このWBS Itemが何を対象にしているか を簡潔に説明する。

done_criteria は 何をもって完了とみなすか を記述する。

notes は 補足・例外・注意事項 を書く。

整理すると次の通りである。

属性	役割
name	短い識別ラベル
description	スコープ説明
done_criteria	完了条件
notes	補足メモ

例

wbs:
  - id: WBS-AUTH-API-010
    name: login endpoint
    description: email/password を受け取るログインAPIとJWT返却処理を対象とする
    owner: EN
    deliverables:
      - path: src/auth/login-controller.ts
        kind: create
    done_criteria: login API が email/password を受け取り JWT を返す
    notes: 認証失敗時は 401 を返す

10. WBS Anti-pattern

避けるべき例

巨大スコープ

authentication system

Deliverable無し

improve performance

曖昧

update login logic

11. WBSとScheduleの関係

要求・要件・仕様

WHY / WHAT / RULES

WBS

WHAT

Schedule

WHEN
ORDER

関係

Requirements / Specs → WBS → Schedule

Schedule Task は 必ず WBS を参照する。

例

tasks:
  - id: T-AUTH-API-010
    wbs: WBS-AUTH-API-010

12. 要求・要件・仕様→WBS生成

将来的にAIは

Needs / Requirements / Specs → Deliverables → WBS

を生成できる。

入力例

login API returns JWT

この入力には、背景・受入条件・非機能要件・仕様詳細を含んでよい。

WBS

WBS-AUTH-API-010 create login endpoint
WBS-AUTH-API-020 generate JWT

13. まとめ

SpecDojoのWBSは

Deliverable Driven
Deterministic
Scope Baseline

である。

WBSは

WHAT

を定義する。