musubix2 0.3.6 → 0.3.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -30,10 +30,55 @@ TypeScript / Node.js 20+ / ESM のモノレポ構成で、25 パッケージを
30
30
  | Article VIII | ADR 記録 | design-generator |
31
31
  | Article IX | 品質ゲート | test-engineer |
32
32
 
33
- ## SDD ワークフロー(5フェーズ)
33
+ ## ⚠️ SDD ワークフロー強制ルール(不可侵)
34
+
35
+ **機能追加・変更・拡張の依頼を受けた場合、以下のフェーズを順守すること。**
36
+ **いかなる理由があっても Phase をスキップして実装を開始してはならない。**
37
+
38
+ ```
39
+ Phase 1: Requirements(要件定義)
40
+ → ユーザーレビュー → 承認 ⏸️
41
+ Phase 2: Design(設計)
42
+ → ユーザーレビュー → 承認 ⏸️
43
+ Phase 3: Task Breakdown(タスク分解)
44
+ → ユーザーレビュー → 承認 ⏸️
45
+ Phase 4: Implementation(実装)
46
+ → テスト → 品質ゲート
47
+ Phase 5: Complete
48
+ ```
49
+
50
+ ### 禁止事項
51
+
52
+ 1. **要件定義なしの実装開始は禁止**。ユーザーが「実装して」と言っても、まず要件を確認する
53
+ 2. **設計なしのコード生成は禁止**。要件が承認されるまで設計に進まない
54
+ 3. **タスク分解なしの実装は禁止**。設計が承認されるまでタスク分解に進まない
55
+ 4. **レビューなしの Phase 遷移は禁止**。各 Phase の成果物はユーザーに提示し、承認を得る
56
+
57
+ ### タスク分類と適用フロー
58
+
59
+ | 種別 | 適用フロー |
60
+ |------|-----------|
61
+ | **機能追加・変更** | Phase 1 → 2 → 3 → 4 → 5(フル SDD) |
62
+ | **バグ修正** | 問題分析 → 修正 → テスト(簡易フロー) |
63
+ | **ドキュメント修正** | 直接修正 |
64
+ | **設定・運用変更** | 直接修正 |
65
+
66
+ ### ワークフロー強制の判定基準
34
67
 
35
68
  ```
36
- Phase 1: Requirements → Phase 2: Design → Phase 3: Tasks → Phase 4: Implementation → Phase 5: Complete
69
+ ユーザーからの依頼を受信
70
+
71
+ ├── 新機能・機能変更・機能拡張?
72
+ │ └── YES → Phase 1(要件定義)から開始。実装に直行しない。
73
+
74
+ ├── バグ修正?
75
+ │ └── YES → 問題分析 → 修正 → テスト
76
+
77
+ ├── ドキュメント・設定変更?
78
+ │ └── YES → 直接修正
79
+
80
+ └── 不明?
81
+ └── ユーザーに確認してから判断
37
82
  ```
38
83
 
39
84
  - **Phase 遷移には前フェーズの承認が必須**(REQ-SDD-002a/b/c)
@@ -38,6 +38,68 @@ SDD(Specification Driven Development)ワークフローのルーティング
38
38
  - `steering/` を参照済みであること(Article VI: プロジェクトメモリ)
39
39
  - 対象プロジェクトに SDD ワークフローが適用されていること
40
40
 
41
+ ## ⚠️ ワークフロー強制ルール(不可侵)
42
+
43
+ **機能追加・変更・拡張の依頼に対して、実装を直接開始することは禁止である。**
44
+ **必ず以下の順序を守り、各 Phase でユーザーの承認を得ること。**
45
+
46
+ ### 強制フロー
47
+
48
+ ```
49
+ 1. 要件定義(Phase 1)
50
+ └── requirements-analyst で EARS 要件を作成
51
+ └── 情報不足の場合は RequirementsInterviewer で 1問1答ヒアリング
52
+ └── ユーザーに要件定義書を提示 → レビュー → ⏸️ 承認待ち
53
+
54
+ 2. 設計(Phase 2)
55
+ └── design-generator で設計書を生成
56
+ └── SOLID / C4 / ADR を含む
57
+ └── ユーザーに設計書を提示 → レビュー → ⏸️ 承認待ち
58
+
59
+ 3. タスク分解(Phase 3)
60
+ └── 設計書からタスクを分解(TASK-XXX-NNN 形式)
61
+ └── 依存関係 DAG を生成
62
+ └── ユーザーにタスク一覧を提示 → レビュー → ⏸️ 承認待ち
63
+
64
+ 4. 実装(Phase 4)
65
+ └── タスク順に Red → Green → Blue サイクルで実装
66
+ └── 各タスク完了後にテスト実行
67
+
68
+ 5. 完了(Phase 5)
69
+ └── 全品質ゲート通過を確認
70
+ ```
71
+
72
+ ### 実装直行の判定と阻止
73
+
74
+ ```
75
+ ユーザー: 「〇〇を実装して」「〇〇を追加して」「〇〇を作って」
76
+
77
+ ├── Phase 1 の要件定義書が存在する?
78
+ │ ├── NO → 「まず要件を定義します」 → Phase 1 開始
79
+ │ └── YES → 承認済み?
80
+ │ ├── NO → 「要件のレビューが必要です」 → レビュー依頼
81
+ │ └── YES → Phase 2 チェックへ
82
+
83
+ ├── Phase 2 の設計書が存在し承認済み?
84
+ │ ├── NO → 「設計を行います」 → Phase 2 開始
85
+ │ └── YES → Phase 3 チェックへ
86
+
87
+ ├── Phase 3 のタスク分解が存在し承認済み?
88
+ │ ├── NO → 「タスクを分解します」 → Phase 3 開始
89
+ │ └── YES → Phase 4(実装開始許可)
90
+
91
+ └── 全 Phase 承認済み → 実装開始
92
+ ```
93
+
94
+ ### 例外(フル SDD を適用しないケース)
95
+
96
+ | 種別 | フロー |
97
+ |------|--------|
98
+ | バグ修正 | 問題分析 → 修正 → テスト |
99
+ | ドキュメント修正 | 直接修正 |
100
+ | 設定変更・バージョンバンプ | 直接修正 |
101
+ | リファクタリング(動作変更なし) | テスト確認 → 修正 → テスト |
102
+
41
103
  ## ルーティングルール
42
104
 
43
105
  ### WHEN/DO マッピング