@k2works/claude-code-booster 5.0.0 → 6.0.0
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.
- package/lib/assets/.claude/skills/apply-docs-structure/SKILL.md +88 -0
- package/lib/assets/.claude/skills/apply-docs-structure/evals/evals.json +40 -0
- package/lib/assets/.claude/skills/apply-docs-structure/scripts/docs_structure.py +207 -0
- package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +4 -1
- package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +2 -0
- package/lib/assets/.claude/skills/orchestrating-operation/SKILL.md +2 -1
- package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +4 -2
- package/lib/assets/CLAUDE.md +23 -1
- package/lib/assets/docs/index.md +37 -37
- package/lib/assets/docs/log.md +20 -0
- package/lib/assets/docs/reference/AI-DLC/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211.md +782 -0
- package/lib/assets/docs/reference/AI-DLC/347/224/250/350/252/236/351/233/206.md +207 -0
- package/lib/assets/docs/reference/index.md +7 -0
- package/lib/assets/docs/reference//343/202/263/343/203/274/343/203/207/343/202/243/343/203/263/343/202/260/343/201/250/343/203/206/343/202/271/343/203/210/343/202/254/343/202/244/343/203/211_AI-DLC/347/211/210.md +981 -0
- package/lib/assets/docs/reference//343/203/211/343/202/255/343/203/245/343/203/241/343/203/263/343/203/210/346/247/213/346/210/220/343/202/254/343/202/244/343/203/211.md +143 -0
- package/lib/assets/docs/reference//343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211_AI-DLC/347/211/210.md +1167 -0
- package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/203/273/343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/350/250/210/347/224/273/343/202/254/343/202/244/343/203/211_AI-DLC/347/211/210.md +793 -0
- package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211_AI-DLC/347/211/210.md +492 -0
- package/lib/assets/gulpfile.js +2 -2
- package/package.json +1 -1
|
@@ -0,0 +1,793 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: Reference
|
|
3
|
+
title: "リリース・イテレーション計画ガイド(AI-DLC 版)"
|
|
4
|
+
description: "AI-DLC(AI-Driven Development Lifecycle)の原則に基づくリリース計画と Bolt(イテレーション)計画の作成手法。Intent を Unit に分解し、AI が計画を提案して人が承認ゲートで検証する流れ、ストーリーポイントに代わる見積もりと進捗指標、リスク台帳、承認ゲート単位の報告、本プロジェクトの計画スキルへの適用方法をまとめる。"
|
|
5
|
+
tags: [reference]
|
|
6
|
+
status: stable
|
|
7
|
+
generated: { by: claude-code/claude-fable-5-1, at: 2026-09-12T04:20:00Z }
|
|
8
|
+
sources:
|
|
9
|
+
- id: release-iteration-guide
|
|
10
|
+
resource: ./リリース・イテレーション計画ガイド.md
|
|
11
|
+
title: リリース・イテレーション計画ガイド(XP 版)
|
|
12
|
+
author: human:kakimomokuri
|
|
13
|
+
- id: aidlc-guide
|
|
14
|
+
resource: ./AI-DLC導入ガイド.md
|
|
15
|
+
title: AI-DLC 導入ガイド
|
|
16
|
+
author: claude-code/claude-fable-5-1
|
|
17
|
+
- id: aidlc-paper
|
|
18
|
+
resource: https://prod.d13rzhkk8cj2z0.amplifyapp.com/aidlc.pdf
|
|
19
|
+
title: AI-Driven Development Lifecycle (AI-DLC) Method Definition
|
|
20
|
+
author: human:raja-sp
|
|
21
|
+
- id: aidlc-workflows
|
|
22
|
+
resource: https://github.com/awslabs/aidlc-workflows
|
|
23
|
+
title: awslabs/aidlc-workflows(User Guide)
|
|
24
|
+
author: org:awslabs
|
|
25
|
+
verified:
|
|
26
|
+
- { by: human:kakimomokuri, at: 2026-09-12T06:25:42Z }
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
# リリース・イテレーション計画ガイド(AI-DLC 版)
|
|
30
|
+
|
|
31
|
+
## はじめに
|
|
32
|
+
|
|
33
|
+
このガイドは、[リリース・イテレーション計画ガイド](リリース・イテレーション計画ガイド.md)(XP 版)を AI-DLC の原則で読み替えたものです。AI-DLC の背景と用語は [AI-DLC 導入ガイド](AI-DLC導入ガイド.md) を参照してください。
|
|
34
|
+
|
|
35
|
+
XP 版との最大の違いは、**計画を作るのが AI で、検証と承認をするのが人** になることです。人がストーリーを見積もり、タスクに分解し、コミットする代わりに、AI が Intent を Unit と Bolt に分解して計画を提案し、人は承認ゲートで検証・修正・承認します。XP 版で扱っていた見積もり・ベロシティ・バーンダウンといった道具は、AI-DLC ではその前提が変わるため、何を残し何を置き換えるかを本ガイドで明確にします。
|
|
36
|
+
|
|
37
|
+
| 観点 | XP 版 | AI-DLC 版 |
|
|
38
|
+
| :--- | :--- | :--- |
|
|
39
|
+
| 計画の作成者 | チーム(人) | AI が提案し、人が検証・承認する |
|
|
40
|
+
| 計画の単位 | ユーザーストーリー → タスク | Intent → Unit → Bolt → ステップ |
|
|
41
|
+
| イテレーション | 1〜4 週間 | Bolt:時間〜日単位 |
|
|
42
|
+
| 見積もり | ストーリーポイント・理想時間 | 複雑さ・リスク・不確実性の評価と、スコープ・深さ・テスト戦略の選択 |
|
|
43
|
+
| コミットメント | チームが「できる」と宣言する | 人が承認ゲートで計画を承認する |
|
|
44
|
+
| 進捗の可視化 | ベロシティ・バーンダウン | Unit と Bolt の状態、承認ゲートの通過数、リードタイム、ビジネス価値 |
|
|
45
|
+
| 日次の儀式 | デイリースタンドアップ | 承認ゲートでのリアルタイム検証(Mob Elaboration・Mob Construction) |
|
|
46
|
+
| 記録 | タスクボード・終了報告 | 状態ファイル・監査ログ・承認ゲート単位の報告 |
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## 計画の基本概念
|
|
51
|
+
|
|
52
|
+
### AI-DLC における計画づくりの原則
|
|
53
|
+
|
|
54
|
+
XP 版の 3 原則(計画づくりの重視・変化の促進・フィーチャ中心)はそのまま有効です。AI-DLC はそこに次の 4 つを加えます。
|
|
55
|
+
|
|
56
|
+
- **AI が計画し、人が検証する**:
|
|
57
|
+
|
|
58
|
+
AI が Level 1 計画(ワークフロー全体)を提案し、人が検証・修正する。各ステップはさらに AI が Level 2 に分解し、人が再び検証する
|
|
59
|
+
|
|
60
|
+
- **検証は損失関数**:
|
|
61
|
+
|
|
62
|
+
各承認ゲートでの人の検証は、誤りが下流で膨らむ前に刈り取るための仕組み。ゲートを省くほど速くなるが、手戻りのリスクが増える
|
|
63
|
+
|
|
64
|
+
- **固定のワークフローを持たない**:
|
|
65
|
+
|
|
66
|
+
新規開発・機能追加・リファクタリング・欠陥修正で同じ計画テンプレートを使わない。AI が Intent に応じたステージ構成を提案する
|
|
67
|
+
|
|
68
|
+
- **価値で測る**:
|
|
69
|
+
|
|
70
|
+
AI が難易度の境界を薄めるため、ストーリーポイントとベロシティは絶対的な指標ではなくなる。ビジネス価値・リードタイム・品質で計画を評価する
|
|
71
|
+
|
|
72
|
+
```plantuml
|
|
73
|
+
@startuml
|
|
74
|
+
title プランニングの階層(AI-DLC 版)
|
|
75
|
+
|
|
76
|
+
folder "戦略" {
|
|
77
|
+
folder "ポートフォリオ" {
|
|
78
|
+
folder "プロダクト" {
|
|
79
|
+
folder "Intent(意図)" {
|
|
80
|
+
folder "リリース計画(Unit の集合、週〜月)" {
|
|
81
|
+
folder "Bolt 計画(時間〜日)" {
|
|
82
|
+
folder "ステップ(承認ゲート単位)" {
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
@enduml
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### AI-DLC の計画づくりプロセス
|
|
94
|
+
|
|
95
|
+
```plantuml
|
|
96
|
+
@startuml
|
|
97
|
+
|
|
98
|
+
[*] --> リリース
|
|
99
|
+
|
|
100
|
+
state リリース {
|
|
101
|
+
満足条件1: (Intent、ビジネス価値、スケジュール、リスク)
|
|
102
|
+
満足条件1 --> Level1計画
|
|
103
|
+
Level1計画: AI が提案、人が承認
|
|
104
|
+
Level1計画 --> 満足条件1
|
|
105
|
+
Level1計画 --> Unit分解
|
|
106
|
+
Unit分解: Mob Elaboration
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
state Bolt {
|
|
110
|
+
Unit分解 --> 満足条件2
|
|
111
|
+
満足条件2: (Unit のストーリー、受入条件、NFR、リスク)
|
|
112
|
+
満足条件2 --> Bolt計画
|
|
113
|
+
Bolt計画: AI が計画、人が承認ゲートで検証
|
|
114
|
+
Bolt計画 --> 満足条件2
|
|
115
|
+
Bolt計画 --> 構築
|
|
116
|
+
構築: Mob Construction
|
|
117
|
+
構築 --> Deployment_Unit
|
|
118
|
+
Deployment_Unit --> 満足条件2 : フィードバック
|
|
119
|
+
Deployment_Unit --> 満足条件1 : フィードバック
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
リリース --> [*]
|
|
123
|
+
|
|
124
|
+
@enduml
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## 1. リリース計画作成プロセス
|
|
130
|
+
|
|
131
|
+
### 1.1 リリース計画の目的
|
|
132
|
+
|
|
133
|
+
リリース計画の目的は XP 版と同じく「いつどれだけの成果が出せるか」を判断することです。AI-DLC では、これを **Intent をどの Unit に分解し、どの順序で Bolt を回すか** として表現します。
|
|
134
|
+
|
|
135
|
+
### 1.2 リリース計画作成手順
|
|
136
|
+
|
|
137
|
+
```plantuml
|
|
138
|
+
@startuml
|
|
139
|
+
title リリース計画作成手順(AI-DLC 版)
|
|
140
|
+
|
|
141
|
+
state "満足条件を決める" as cond
|
|
142
|
+
state "Level 1 計画を生成する" as l1gen
|
|
143
|
+
state "Level 1 計画を検証する" as l1check
|
|
144
|
+
state "Intent を Unit に分解する" as decompose
|
|
145
|
+
state "Unit を検証する" as unitcheck
|
|
146
|
+
state "Unit の複雑さとリスクを評価する" as evaluate
|
|
147
|
+
state "スコープ・深さ・テスト戦略を選ぶ" as select
|
|
148
|
+
state "Unit に優先順位を付ける" as prioritize
|
|
149
|
+
state "Bolt の並びとリリース日を決める" as bolts
|
|
150
|
+
state "満足条件を満たすか" as satisfied <<choice>>
|
|
151
|
+
state "リリース計画完成" as done
|
|
152
|
+
state fork_state <<fork>>
|
|
153
|
+
state join_state <<join>>
|
|
154
|
+
|
|
155
|
+
[*] --> cond
|
|
156
|
+
cond --> l1gen : AI
|
|
157
|
+
l1gen --> l1check : 人
|
|
158
|
+
l1check --> decompose : AI(Mob Elaboration)
|
|
159
|
+
decompose --> unitcheck : 人(モブ)
|
|
160
|
+
|
|
161
|
+
unitcheck --> fork_state
|
|
162
|
+
fork_state --> evaluate
|
|
163
|
+
fork_state --> select
|
|
164
|
+
fork_state --> prioritize
|
|
165
|
+
|
|
166
|
+
evaluate --> join_state
|
|
167
|
+
select --> join_state
|
|
168
|
+
prioritize --> join_state
|
|
169
|
+
|
|
170
|
+
join_state --> bolts : AI が提案、人が承認
|
|
171
|
+
bolts --> satisfied
|
|
172
|
+
satisfied --> done : Yes
|
|
173
|
+
satisfied --> cond : No
|
|
174
|
+
done --> [*]
|
|
175
|
+
@enduml
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
#### ステップ 1:満足条件の決定
|
|
179
|
+
|
|
180
|
+
プロダクトオーナーと協力して以下を定義します。XP 版のスコープ・スケジュール・リソースに、AI-DLC の Intent とリスクが加わります。
|
|
181
|
+
|
|
182
|
+
- **Intent**:
|
|
183
|
+
|
|
184
|
+
達成したいことの高水準の宣言。ビジネス目標・機能・技術的成果のいずれか
|
|
185
|
+
|
|
186
|
+
- **ビジネス価値**:
|
|
187
|
+
|
|
188
|
+
Intent が実現したときに何がどう良くなるか。測定基準まで定義する
|
|
189
|
+
|
|
190
|
+
- **スケジュール**:
|
|
191
|
+
|
|
192
|
+
いつまでに何を届けるか
|
|
193
|
+
|
|
194
|
+
- **リソース**:
|
|
195
|
+
|
|
196
|
+
モブの構成(フルスタック開発者・ビジネス担当・スペシャリスト)と、AI に渡せるコード・データの範囲
|
|
197
|
+
|
|
198
|
+
- **リスク**:
|
|
199
|
+
|
|
200
|
+
組織のリスク台帳と対応づけた制約(セキュリティ・コンプライアンス・既存制度)
|
|
201
|
+
|
|
202
|
+
#### ステップ 2:Level 1 計画の生成と検証
|
|
203
|
+
|
|
204
|
+
AI に Intent を渡し、実現までのワークフロー(Level 1 計画)を提案させます。人はこの計画を検証し、不要なステージを削り、足りないステージを足します。
|
|
205
|
+
|
|
206
|
+
```markdown
|
|
207
|
+
# Level 1 計画のプロンプト骨格
|
|
208
|
+
あなたは経験豊富なソフトウェアアーキテクトです。
|
|
209
|
+
次の Intent を実現するためのワークフローを、チェックボックス付きの
|
|
210
|
+
Markdown 計画として書いてください。
|
|
211
|
+
人の確認が必要なステップにはその旨を注記し、重要な判断は勝手にしないでください。
|
|
212
|
+
計画ができたらレビューと承認を求め、承認後に 1 ステップずつ実行してください。
|
|
213
|
+
|
|
214
|
+
Intent: <<達成したいことの宣言>>
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
Level 1 計画の検証観点は次のとおりです。
|
|
218
|
+
|
|
219
|
+
- 既存プロジェクト(ブラウンフィールド)なら、コードをモデルに昇格させるステップが含まれているか
|
|
220
|
+
- UI を持たない Intent にモックアップのステップが入っていないか
|
|
221
|
+
- セキュリティ・コンプライアンスの検証ステップが、組織のリスク台帳と対応しているか
|
|
222
|
+
- デプロイと可観測性のステップが、実装のスピードに見合っているか
|
|
223
|
+
|
|
224
|
+
#### ステップ 3:Intent の Unit への分解(Mob Elaboration)
|
|
225
|
+
|
|
226
|
+
AI に Intent を **Unit** へ分解させます。Unit は疎結合・高凝集な作業単位で、独立して開発・デプロイできることが条件です。モブ全員が同じ画面で AI の質問に答え、分解結果を検証します。
|
|
227
|
+
|
|
228
|
+
Unit ごとに次の成果物が揃っていることを確認します。
|
|
229
|
+
|
|
230
|
+
| 成果物 | 内容 |
|
|
231
|
+
| :--- | :--- |
|
|
232
|
+
| ユーザーストーリー | Unit の機能スコープ。人と AI の契約 |
|
|
233
|
+
| 受入条件 | ストーリーの完了を判断する条件 |
|
|
234
|
+
| NFR 定義 | Unit に固有の非機能要件 |
|
|
235
|
+
| リスク記述 | リスク台帳との対応 |
|
|
236
|
+
| 測定基準 | ビジネス意図にトレースできる指標 |
|
|
237
|
+
| 推奨 Bolt | Unit を構築するための Bolt の提案 |
|
|
238
|
+
|
|
239
|
+
分解の検証観点は次のとおりです。
|
|
240
|
+
|
|
241
|
+
- **独立性**: ある Unit の変更が他の Unit の再設計を要求しないか
|
|
242
|
+
- **粒度**: 1 つの Unit が 1 つのモブで数時間〜数日の Bolt 数回で完了する大きさか
|
|
243
|
+
- **過剰設計・設計不足**: AI が勝手に足した機能、逆に落とした制約はないか
|
|
244
|
+
- **トレーサビリティ**: すべてのストーリーが Intent に、すべての Unit が測定基準にたどれるか
|
|
245
|
+
|
|
246
|
+
#### ステップ 4:Unit の複雑さとリスクの評価
|
|
247
|
+
|
|
248
|
+
XP 版のストーリーポイント見積もりに相当するステップです。AI-DLC ではポイントを付けるのではなく、**AI がどれだけ自律的に進められるか** を評価します。参照実装のコンポーザーが使う 5 つの「実装エントロピー」を評価軸として使います。
|
|
249
|
+
|
|
250
|
+
| 評価軸 | 問い | 高いときの対応 |
|
|
251
|
+
| :--- | :--- | :--- |
|
|
252
|
+
| 意図の曖昧さ | ストーリーと受入条件は一意に解釈できるか | Mob Elaboration で追加の質問に答える |
|
|
253
|
+
| 構造的不確実性 | 変更対象のコードや境界は把握できているか | リバースエンジニアリングのステップを足す |
|
|
254
|
+
| 検証の不確実性 | 完了をテストで判定できるか | テスト戦略を上げる。受入テストを先に書く |
|
|
255
|
+
| リスク | セキュリティ・データ・既存制度への影響は | リスク台帳と照合し、承認ゲートを増やす |
|
|
256
|
+
| 未解決の仮定 | AI や人が置いた仮定は確認済みか | 仮定を明示し、確認してから着手する |
|
|
257
|
+
|
|
258
|
+
各軸を LOW/MED/HIGH の 3 段階で評価し、HIGH が多い Unit ほど承認ゲートを密にします。
|
|
259
|
+
|
|
260
|
+
#### ステップ 5:スコープ・深さ・テスト戦略の選択
|
|
261
|
+
|
|
262
|
+
Unit(または Intent 全体)に対して、どのステージを実行し、どの詳細度で成果物を作り、どれだけテストするかを決めます。
|
|
263
|
+
|
|
264
|
+
| 軸 | 選択肢 | 選び方 |
|
|
265
|
+
| :--- | :--- | :--- |
|
|
266
|
+
| スコープ | 全ステージ/設計中心/実装中心/修正のみ | 新機能は全ステージ、欠陥修正やリファクタリングは実装中心 |
|
|
267
|
+
| 深さ | Minimal/Standard/Comprehensive | 規制対象や監査が必要なら Comprehensive、PoC なら Minimal |
|
|
268
|
+
| テスト戦略 | Minimal(要件ごとに 1)/Standard(コンポーネントごとに 5〜8)/Comprehensive(10〜15) | 本番機能は Standard 以上。学習・検証目的なら Minimal |
|
|
269
|
+
|
|
270
|
+
これが XP 版の「ベロシティを見積もる」と「イテレーションの長さを決める」に相当します。AI の生成量はスコープと深さでほぼ決まるため、Bolt の長さは「ゲートを何回通すか」で調整します。
|
|
271
|
+
|
|
272
|
+
#### ステップ 6:優先順位の決定
|
|
273
|
+
|
|
274
|
+
XP 版の 4 つの評価軸(金銭価値・コスト・知識習得・リスク軽減)はそのまま使います。AI-DLC では次を加えます。
|
|
275
|
+
|
|
276
|
+
- **依存関係**:
|
|
277
|
+
|
|
278
|
+
AI に Unit 間の依存 DAG を作らせ、依存の少ない Unit から着手する。依存を共有しない Unit は並列に回せる
|
|
279
|
+
|
|
280
|
+
- **ウォーキングスケルトン**:
|
|
281
|
+
|
|
282
|
+
最初の Bolt はエンドツーエンドで動く最小の縦割りにする。ここで AI の出力の質を確認し、以降のゲートの密度を決める
|
|
283
|
+
|
|
284
|
+
- **AI 自律度**:
|
|
285
|
+
|
|
286
|
+
ステップ 4 の評価が LOW の Unit は早く終わる。HIGH の Unit は人の時間を多く使うため、モブの集中時間が確保できるタイミングに置く
|
|
287
|
+
|
|
288
|
+
#### ステップ 7:Bolt の並びとリリース日の決定
|
|
289
|
+
|
|
290
|
+
AI に Unit の依存 DAG と優先順位から **Bolt 計画** を提案させ、人が承認します。Bolt 計画は次を含みます。
|
|
291
|
+
|
|
292
|
+
- 各 Bolt に含める Unit(1 つ以上)
|
|
293
|
+
- Bolt の完了条件(Definition of Done)
|
|
294
|
+
- 確認したい仮説(この Bolt で何が分かれば次に進めるか)
|
|
295
|
+
- 担当(モブ、または並列時の担当者)
|
|
296
|
+
- 並列に回す Bolt と、順序が固定される Bolt
|
|
297
|
+
|
|
298
|
+
### 1.3 リリース計画の更新
|
|
299
|
+
|
|
300
|
+
- **各 Bolt の承認ゲート通過時** に見直す。XP 版の「各イテレーション開始時」より高頻度になる
|
|
301
|
+
- ウォーキングスケルトンの結果で、以降の深さ・テスト戦略・ゲート密度を調整する
|
|
302
|
+
- Unit の完了実績(Bolt 数・リードタイム・手戻り回数)で残りの Unit の評価を更新する
|
|
303
|
+
- スコープ変更は Level 1 計画に反映し、削ったステージ・足したステージを記録する
|
|
304
|
+
|
|
305
|
+
---
|
|
306
|
+
|
|
307
|
+
## 2. Bolt(イテレーション)計画作成プロセス
|
|
308
|
+
|
|
309
|
+
### 2.1 リリース計画との違い
|
|
310
|
+
|
|
311
|
+
| 項目 | リリース計画 | Bolt 計画 |
|
|
312
|
+
| :--- | :--- | :--- |
|
|
313
|
+
| 対象期間 | 週〜月 | 時間〜日 |
|
|
314
|
+
| 構成要素 | Unit | Unit 内のストーリーとステップ |
|
|
315
|
+
| 作成者 | AI が Level 1 計画を提案、モブが検証 | AI がステップ計画を提案、担当者が承認ゲートで検証 |
|
|
316
|
+
| 見積単位 | 複雑さ・リスク・自律度 | 承認ゲートの回数と人の集中時間 |
|
|
317
|
+
|
|
318
|
+
### 2.2 Bolt 計画作成手順
|
|
319
|
+
|
|
320
|
+
#### 承認駆動方式
|
|
321
|
+
|
|
322
|
+
XP 版のコミットメント駆動方式を、AI-DLC では **承認駆動** に置き換えます。チームが「できる」と宣言する代わりに、人が AI の計画を承認します。
|
|
323
|
+
|
|
324
|
+
```plantuml
|
|
325
|
+
@startuml
|
|
326
|
+
title 承認駆動の Bolt 計画作成手順
|
|
327
|
+
|
|
328
|
+
[*] --> Boltゴールを決める
|
|
329
|
+
Boltゴールを決める --> Unitのストーリーを渡す
|
|
330
|
+
Unitのストーリーを渡す --> AIがステップ計画を書く
|
|
331
|
+
AIがステップ計画を書く --> 計画を検証する
|
|
332
|
+
|
|
333
|
+
state 計画を検証する <<choice>>
|
|
334
|
+
計画を検証する --> AIがステップ計画を書く : 変更依頼
|
|
335
|
+
計画を検証する --> 承認 : 承認
|
|
336
|
+
計画を検証する --> 現状で受け入れ : 3 回以上の変更依頼
|
|
337
|
+
|
|
338
|
+
承認 --> Bolt計画完成
|
|
339
|
+
現状で受け入れ --> Bolt計画完成
|
|
340
|
+
Bolt計画完成 --> [*]
|
|
341
|
+
@enduml
|
|
342
|
+
```
|
|
343
|
+
|
|
344
|
+
#### ステップ 1:Bolt ゴールの設定
|
|
345
|
+
|
|
346
|
+
- 1〜2 行で Bolt で達成することを記述します
|
|
347
|
+
- **確認したい仮説** を必ず含めます。「この Bolt が終われば ○○ が分かる」の形にします
|
|
348
|
+
- 最初の Bolt はウォーキングスケルトンにします
|
|
349
|
+
|
|
350
|
+
```markdown
|
|
351
|
+
# Bolt ゴールの例
|
|
352
|
+
注文 Unit の「カートに商品を追加する」ストーリーを、API からデータベースまで
|
|
353
|
+
通して動かす。これで AI が生成するドメインモデルとリポジトリの品質が
|
|
354
|
+
このコードベースで十分かどうかが分かる。
|
|
355
|
+
```
|
|
356
|
+
|
|
357
|
+
#### ステップ 2:AI によるステップ計画
|
|
358
|
+
|
|
359
|
+
XP 版の「ストーリーのタスク分解」を AI が行います。第 7 章のプロンプトパターン([AI-DLC 導入ガイド](AI-DLC導入ガイド.md#7-プロンプトパターン))で計画を書かせます。
|
|
360
|
+
|
|
361
|
+
```markdown
|
|
362
|
+
# Bolt 計画のプロンプト骨格
|
|
363
|
+
あなたは経験豊富なソフトウェアエンジニアです。
|
|
364
|
+
docs/requirements/<unit>.md のストーリーと受入条件を参照し、
|
|
365
|
+
このストーリーを実装するステップをチェックボックス付きの
|
|
366
|
+
Markdown 計画として docs/development/bolt_<n>_plan.md に書いてください。
|
|
367
|
+
- 各ステップはテストファースト(Red-Green-Refactor)で進めること
|
|
368
|
+
- 人の確認が必要なステップにはその旨を注記すること
|
|
369
|
+
- 重要な判断(新規ライブラリ、スキーマ変更、外部連携)は勝手にしないこと
|
|
370
|
+
計画ができたらレビューと承認を求め、承認後に 1 ステップずつ実行し、
|
|
371
|
+
完了したステップのチェックボックスを更新してください。
|
|
372
|
+
```
|
|
373
|
+
|
|
374
|
+
**良いステップの特徴**(XP 版の「良いタスクの特徴」に相当)
|
|
375
|
+
|
|
376
|
+
- 1 回の AI とのやり取りで完結する粒度
|
|
377
|
+
- 完了をテストで判定できる
|
|
378
|
+
- 入力となる成果物(ストーリー・ドメインモデル・既存コード)がパスで明示されている
|
|
379
|
+
- 人の確認ポイントが明記されている
|
|
380
|
+
|
|
381
|
+
#### ステップの種類
|
|
382
|
+
|
|
383
|
+
- 設計ステップ(ドメインモデル・論理設計・ADR)
|
|
384
|
+
- 実装ステップ(テスト → 実装 → リファクタリング)
|
|
385
|
+
- 統合ステップ(他 Unit との契約・統合テスト)
|
|
386
|
+
- 検証ステップ(テスト実行・結果分析・修正提案)
|
|
387
|
+
- スパイク(AI に選択肢と根拠を出させる調査)
|
|
388
|
+
|
|
389
|
+
#### ステップ 3:計画の検証と承認
|
|
390
|
+
|
|
391
|
+
人は AI の計画を次の観点で検証します。
|
|
392
|
+
|
|
393
|
+
| 観点 | 確認内容 |
|
|
394
|
+
| :--- | :--- |
|
|
395
|
+
| 順序 | テストが実装より先か。依存する成果物が先に作られるか |
|
|
396
|
+
| 確認ポイント | 新規ファイル作成・構造変更・セキュリティ・本番環境に関わるステップに確認が入っているか |
|
|
397
|
+
| スコープ | ストーリーに無い機能を足していないか。受入条件を落としていないか |
|
|
398
|
+
| 参照 | 既存の実装・規約・ドメイン用語を参照しているか |
|
|
399
|
+
| 仮定 | AI が置いた仮定が明示され、確認済みか |
|
|
400
|
+
|
|
401
|
+
変更依頼が 3 回以上続く場合は「現状で受け入れて進む」ことも選択肢にします。完璧な計画を求めて止まるより、ウォーキングスケルトンで早く確かめるほうが情報が得られます。
|
|
402
|
+
|
|
403
|
+
### 2.3 Bolt の実行
|
|
404
|
+
|
|
405
|
+
#### 承認ゲートによるリアルタイム検証
|
|
406
|
+
|
|
407
|
+
XP 版のデイリースタンドアップは、AI-DLC では **承認ゲート** に置き換わります。AI がステップを完了するたびに人が検証するため、進捗共有のための定例会議は不要になります。
|
|
408
|
+
|
|
409
|
+
各ゲートで確認することは次のとおりです。
|
|
410
|
+
|
|
411
|
+
- **昨日やったこと** → AI が完了したステップと成果物
|
|
412
|
+
- **今日やること** → 次のステップと、そこで人が判断すべきこと
|
|
413
|
+
- **障害・ブロッカー** → AI が停止した理由(テスト失敗・未確認の仮定・権限)
|
|
414
|
+
|
|
415
|
+
#### ゲート密度の選択
|
|
416
|
+
|
|
417
|
+
ウォーキングスケルトンのゲートを通過した時点で、残りのステップをどう進めるかを 1 回だけ決めます。
|
|
418
|
+
|
|
419
|
+
| 選択 | 内容 | 向いている場合 |
|
|
420
|
+
| :--- | :--- | :--- |
|
|
421
|
+
| 各ステップでゲート | すべてのステップで人が検証する | エントロピー評価が HIGH、初めてのコードベース、規制対象 |
|
|
422
|
+
| 自律実行 | 失敗時と最終ステップだけ人が検証する | エントロピー評価が LOW、ウォーキングスケルトンの品質が十分 |
|
|
423
|
+
|
|
424
|
+
自律実行を選んでも、テスト失敗・未確認の仮定・確認必須の操作では必ず停止します。
|
|
425
|
+
|
|
426
|
+
#### 状態ボードの活用
|
|
427
|
+
|
|
428
|
+
XP 版のタスクボードは、ステップの状態を表す **状態ファイル** に置き換えます。
|
|
429
|
+
|
|
430
|
+
```markdown
|
|
431
|
+
# Bolt 3 計画(docs/development/bolt_3_plan.md)
|
|
432
|
+
- [x] 1. カート集約のドメインモデルを設計する
|
|
433
|
+
- [x] 2. カートへの追加のテストを書く(Red)
|
|
434
|
+
- [?] 3. カート追加を実装する(Green) ← 承認待ち
|
|
435
|
+
- [ ] 4. リファクタリングする
|
|
436
|
+
- [ ] 5. リポジトリのテストを書く(Red) ※ DB スキーマ変更のため要確認
|
|
437
|
+
- [ ] 6. リポジトリを実装する(Green)
|
|
438
|
+
- [S] 7. キャッシュ層を追加する ← スコープ外としてスキップ
|
|
439
|
+
```
|
|
440
|
+
|
|
441
|
+
| 記号 | 状態 |
|
|
442
|
+
| :--- | :--- |
|
|
443
|
+
| `[ ]` | 未着手 |
|
|
444
|
+
| `[-]` | 進行中 |
|
|
445
|
+
| `[?]` | 承認待ち(ゲートが開いている) |
|
|
446
|
+
| `[R]` | 修正中(変更依頼を受けて AI が修正している) |
|
|
447
|
+
| `[x]` | 完了 |
|
|
448
|
+
| `[S]` | スキップ |
|
|
449
|
+
|
|
450
|
+
---
|
|
451
|
+
|
|
452
|
+
## 3. 見積もりのベストプラクティス
|
|
453
|
+
|
|
454
|
+
### 3.1 ストーリーポイントを再考する
|
|
455
|
+
|
|
456
|
+
AI-DLC の論文は、AI が「簡単・普通・難しい」の境界を薄めるなら、ストーリーポイントとベロシティは以前ほど重要ではなくなると指摘しています。ただし、ポイントが不要になるわけではなく、**何を測っているかが変わる** と理解するのが正確です。
|
|
457
|
+
|
|
458
|
+
| 指標 | XP 版で測っていたもの | AI-DLC で測るもの |
|
|
459
|
+
| :--- | :--- | :--- |
|
|
460
|
+
| ストーリーポイント | 人が実装する相対的な規模 | 人が検証に費やす時間の相対的な大きさ(AI 自律度の逆数) |
|
|
461
|
+
| ベロシティ | イテレーションあたりの完了ポイント | Bolt あたりの完了 Unit 数、または承認ゲートの通過数 |
|
|
462
|
+
| 理想時間 | 割り込みを除いた作業時間 | モブの連続した集中時間(承認ゲートに立ち会える時間) |
|
|
463
|
+
|
|
464
|
+
**推奨**: ポイントを付ける場合は「AI が生成する量」ではなく「人が検証する負荷」で付けます。ステップ 4 のエントロピー評価がそのまま使えます。
|
|
465
|
+
|
|
466
|
+
### 3.2 見積もり精度の向上
|
|
467
|
+
|
|
468
|
+
#### 不確実性コーンの変形
|
|
469
|
+
|
|
470
|
+
XP 版の不確実性コーンは、AI-DLC では各フェーズの承認ゲートを通過するたびに狭まります。ただし、コーンを狭めるのは時間の経過ではなく **人が検証した成果物の蓄積** です。
|
|
471
|
+
|
|
472
|
+
```plantuml
|
|
473
|
+
@startuml
|
|
474
|
+
title 不確実性コーン(AI-DLC 版)
|
|
475
|
+
|
|
476
|
+
left to right direction
|
|
477
|
+
|
|
478
|
+
rectangle "Intent 表明\n仮定だらけ" as start #lightcoral
|
|
479
|
+
rectangle "Level 1 計画承認\nワークフローが確定" as l1 #orange
|
|
480
|
+
rectangle "Unit 分解承認\nストーリー・NFR・リスクが確定" as unit #yellow
|
|
481
|
+
rectangle "ドメインモデル承認\n業務ロジックが確定" as domain #lightgreen
|
|
482
|
+
rectangle "ウォーキングスケルトン承認\nAI の出力品質が確定" as ws #lightblue
|
|
483
|
+
|
|
484
|
+
start --> l1 : 承認ゲート
|
|
485
|
+
l1 --> unit : 承認ゲート
|
|
486
|
+
unit --> domain : 承認ゲート
|
|
487
|
+
domain --> ws : 承認ゲート
|
|
488
|
+
|
|
489
|
+
note bottom of start : 最も不確実
|
|
490
|
+
note bottom of ws : 以降は自律実行を検討できる
|
|
491
|
+
@enduml
|
|
492
|
+
```
|
|
493
|
+
|
|
494
|
+
#### 見積もりの改善方法
|
|
495
|
+
|
|
496
|
+
- Bolt ごとに「エントロピー評価」「ゲート回数」「変更依頼回数」「リードタイム」を記録する
|
|
497
|
+
- 評価と実績の差分を分析する。LOW と評価したのに変更依頼が多かった Unit は、評価軸のどれを見落としたかを特定する
|
|
498
|
+
- 人が AI の振る舞いを修正した内容をガードレール(`CLAUDE.md`・`PROJECT.md`・スキル)に反映し、次の Bolt の評価に織り込む
|
|
499
|
+
|
|
500
|
+
### 3.3 再評価のタイミング
|
|
501
|
+
|
|
502
|
+
以下の場合に Unit の評価を見直します。
|
|
503
|
+
|
|
504
|
+
- ウォーキングスケルトンで AI の出力品質が想定と違った
|
|
505
|
+
- リバースエンジニアリングで既存コードの構造が想定と違った
|
|
506
|
+
- 深さ・テスト戦略を変更した
|
|
507
|
+
- ガードレールが追加され、AI の振る舞いが変わった
|
|
508
|
+
|
|
509
|
+
**注意**: 進捗の遅れのみでは再評価しません。遅れの原因が「人が承認ゲートに立ち会えない」ことなら、評価ではなくモブの集中時間の確保を見直します。
|
|
510
|
+
|
|
511
|
+
---
|
|
512
|
+
|
|
513
|
+
## 4. 進捗管理とモニタリング
|
|
514
|
+
|
|
515
|
+
### 4.0 全体スケジュール管理
|
|
516
|
+
|
|
517
|
+
#### リリース全体のガントチャート
|
|
518
|
+
|
|
519
|
+
Bolt は時間〜日単位のため、XP 版の週単位のガントチャートは Unit 単位に置き換えます。並列に回せる Unit を可視化することが目的です。
|
|
520
|
+
|
|
521
|
+
```mermaid
|
|
522
|
+
gantt
|
|
523
|
+
title リリース計画全体スケジュール(Unit 単位)
|
|
524
|
+
dateFormat YYYY-MM-DD
|
|
525
|
+
axisFormat %m/%d
|
|
526
|
+
|
|
527
|
+
section Inception
|
|
528
|
+
Level 1 計画・Unit 分解(Mob Elaboration) :done, inc, 2026-09-01, 1d
|
|
529
|
+
|
|
530
|
+
section Unit A(ユーザー管理)
|
|
531
|
+
Bolt 1(ウォーキングスケルトン) :done, a1, 2026-09-02, 1d
|
|
532
|
+
Bolt 2(登録・認証) :done, a2, after a1, 2d
|
|
533
|
+
|
|
534
|
+
section Unit B(商品管理)
|
|
535
|
+
Bolt 3(一覧・詳細) :active, b1, after a1, 2d
|
|
536
|
+
Bolt 4(検索) : b2, after b1, 1d
|
|
537
|
+
|
|
538
|
+
section Unit C(注文処理)
|
|
539
|
+
Bolt 5(カート) :active, c1, after a1, 2d
|
|
540
|
+
Bolt 6(注文確定・決済) :crit, c2, after c1, 2d
|
|
541
|
+
|
|
542
|
+
section Operation
|
|
543
|
+
デプロイ・可観測性 : op, after c2, 1d
|
|
544
|
+
|
|
545
|
+
section マイルストーン
|
|
546
|
+
リリース 1.0(MVP) :milestone, m1, after op, 0d
|
|
547
|
+
```
|
|
548
|
+
|
|
549
|
+
Unit B と Unit C は依存を共有しないため、Unit A のウォーキングスケルトン後に並列で進めています。
|
|
550
|
+
|
|
551
|
+
#### Bolt 内のステップ進捗
|
|
552
|
+
|
|
553
|
+
Bolt 内の進捗は 2.3 節の状態ファイルで管理します。ガントチャートは使いません。
|
|
554
|
+
|
|
555
|
+
### 4.1 完了 Unit 数と承認ゲート通過数
|
|
556
|
+
|
|
557
|
+
XP 版のベロシティ(オール・オア・ナッシング方式)は、AI-DLC では **完了 Unit 数** と **承認ゲート通過数** に置き換えます。
|
|
558
|
+
|
|
559
|
+
- 完了 Unit 数: Deployment Unit として検証済みの Unit のみ加算する。部分完了はゼロ
|
|
560
|
+
- 承認ゲート通過数: 人が検証して承認したステップの数。人の検証負荷を表す
|
|
561
|
+
|
|
562
|
+
```mermaid
|
|
563
|
+
xychart-beta
|
|
564
|
+
title "Bolt ごとの承認ゲート通過数と変更依頼数"
|
|
565
|
+
x-axis ["Bolt1", "Bolt2", "Bolt3", "Bolt4", "Bolt5", "Bolt6"]
|
|
566
|
+
y-axis "回数" 0 --> 15
|
|
567
|
+
bar [8, 10, 9, 12, 11, 13]
|
|
568
|
+
line [4, 3, 3, 2, 1, 1]
|
|
569
|
+
```
|
|
570
|
+
|
|
571
|
+
棒が承認ゲート通過数、線が変更依頼数です。変更依頼が減っていれば、ガードレールの蓄積によって AI の出力が安定してきたことを示します。
|
|
572
|
+
|
|
573
|
+
### 4.2 バーンダウンチャート
|
|
574
|
+
|
|
575
|
+
#### リリースバーンダウンチャート
|
|
576
|
+
|
|
577
|
+
残 Unit 数、または残 Unit のエントロピー評価合計で描きます。
|
|
578
|
+
|
|
579
|
+
```mermaid
|
|
580
|
+
xychart-beta
|
|
581
|
+
title "リリースバーンダウン(残 Unit 数)"
|
|
582
|
+
x-axis ["Bolt1", "Bolt2", "Bolt3", "Bolt4", "Bolt5", "Bolt6"]
|
|
583
|
+
y-axis "残 Unit 数" 0 --> 6
|
|
584
|
+
line [6, 5, 5, 3, 2, 0]
|
|
585
|
+
```
|
|
586
|
+
|
|
587
|
+
#### Bolt バーンダウンチャート
|
|
588
|
+
|
|
589
|
+
Bolt は数時間〜数日で終わるため、日次のバーンダウンは意味を持ちません。代わりに状態ファイルの残ステップ数で判断します。
|
|
590
|
+
|
|
591
|
+
### 4.3 パーキングロットチャート
|
|
592
|
+
|
|
593
|
+
Unit 単位の進捗可視化です。XP 版のテーマが Unit に置き換わります。
|
|
594
|
+
|
|
595
|
+
```plantuml
|
|
596
|
+
@startuml
|
|
597
|
+
rectangle "Unit A:ユーザー管理" as u1 #lightgreen
|
|
598
|
+
note right of u1 : Bolt 2/2 完了・Deployment Unit 検証済み
|
|
599
|
+
|
|
600
|
+
rectangle "Unit B:商品管理" as u2 #yellow
|
|
601
|
+
note right of u2 : Bolt 1/2 完了・ゲート 5/9 通過
|
|
602
|
+
|
|
603
|
+
rectangle "Unit C:注文処理" as u3 #lightcoral
|
|
604
|
+
note right of u3 : Bolt 1/2 進行中・変更依頼 3 回(要確認:決済の仮定)
|
|
605
|
+
|
|
606
|
+
rectangle "Unit D:レポート" as u4 #lightgray
|
|
607
|
+
note right of u4 : 未着手・エントロピー評価 MED
|
|
608
|
+
@enduml
|
|
609
|
+
```
|
|
610
|
+
|
|
611
|
+
### 4.4 リードタイムとビジネス価値
|
|
612
|
+
|
|
613
|
+
計画の最終的な評価指標です。ベロシティの代わりにステークホルダーへ報告します。
|
|
614
|
+
|
|
615
|
+
| 指標 | 定義 |
|
|
616
|
+
| :--- | :--- |
|
|
617
|
+
| リードタイム | Intent 表明から Deployment Unit 検証済みまでの経過時間 |
|
|
618
|
+
| 手戻り率 | 承認ゲートでの変更依頼数 ÷ 通過数 |
|
|
619
|
+
| 欠陥流出数 | Deployment Unit 検証後に見つかった欠陥の数 |
|
|
620
|
+
| ビジネス価値 | Unit の測定基準(Inception で定義)の達成度 |
|
|
621
|
+
|
|
622
|
+
---
|
|
623
|
+
|
|
624
|
+
## 5. リスクマネジメント
|
|
625
|
+
|
|
626
|
+
### 5.1 リスク台帳を成果物にする
|
|
627
|
+
|
|
628
|
+
AI-DLC の原則 6(人との共生を高めるものは残す)は、リスク台帳を計画の第一級の成果物と位置づけます。Unit ごとのリスク記述は、組織のリスク台帳と対応づけて管理します。
|
|
629
|
+
|
|
630
|
+
```markdown
|
|
631
|
+
# Unit C:注文処理 のリスク記述
|
|
632
|
+
| リスク | 台帳との対応 | 対策 | 承認ゲート |
|
|
633
|
+
| :--- | :--- | :--- | :--- |
|
|
634
|
+
| 決済情報の取り扱い | SEC-03 | AI に本番の決済キーを渡さない。テスト用モックで実装する | 決済ステップは必ず人が検証 |
|
|
635
|
+
| DB スキーマ変更 | CHG-01 | マイグレーションは人が確認してから適用 | スキーマ変更ステップで停止 |
|
|
636
|
+
| 外部 API の仕様変更 | DEP-02 | 契約テストを先に書く | 統合ステップで検証 |
|
|
637
|
+
```
|
|
638
|
+
|
|
639
|
+
### 5.2 バッファ計画
|
|
640
|
+
|
|
641
|
+
**スコープバッファ**(XP 版のフィーチャバッファ)
|
|
642
|
+
|
|
643
|
+
- 優先度の低い Unit を 30% 程度用意し、遅延時に削る。XP 版と同じ
|
|
644
|
+
- 加えて、各 Unit の深さとテスト戦略を 1 段階下げることをバッファとして使える。ただし本番機能のテスト戦略は Standard 未満にしない
|
|
645
|
+
|
|
646
|
+
**検証バッファ**(XP 版のスケジュールバッファ)
|
|
647
|
+
|
|
648
|
+
- AI の生成時間ではなく、**人の検証時間** がボトルネックになる
|
|
649
|
+
- エントロピー評価が HIGH の Unit ほど承認ゲートが密になり、人の時間を使う。モブの集中時間を Bolt 計画に先に確保する
|
|
650
|
+
- ウォーキングスケルトンの結果次第でゲート密度を下げられるため、初期は密に、安定したら疎にする
|
|
651
|
+
|
|
652
|
+
### 5.3 並列 Unit と依存関係の調整
|
|
653
|
+
|
|
654
|
+
XP 版の「複数チーム間の調整」に相当します。
|
|
655
|
+
|
|
656
|
+
- **依存 DAG**:
|
|
657
|
+
|
|
658
|
+
AI に Unit 間の依存を DAG として出させ、依存を共有しない Unit を並列 Bolt に割り当てる
|
|
659
|
+
|
|
660
|
+
- **契約の先行合意**:
|
|
661
|
+
|
|
662
|
+
並列 Unit 間のインターフェース(API・イベント・スキーマ)はドメインモデル段階で契約として固め、契約テストを先に書く
|
|
663
|
+
|
|
664
|
+
- **失敗時の停止と選択**:
|
|
665
|
+
|
|
666
|
+
並列 Bolt の 1 つが失敗しても他の成果物は保持し、失敗した Unit だけを「再試行・スキップ・中止」から選ぶ。スキップすると依存する Unit も失敗しやすいことを認識する
|
|
667
|
+
|
|
668
|
+
- **移動する先読み範囲**:
|
|
669
|
+
|
|
670
|
+
今後 2〜3 Bolt の計画を事前に共有し、契約の変更を早期に検知する。XP 版と同じ
|
|
671
|
+
|
|
672
|
+
---
|
|
673
|
+
|
|
674
|
+
## 6. コミュニケーション
|
|
675
|
+
|
|
676
|
+
### 6.1 ステークホルダーへの報告
|
|
677
|
+
|
|
678
|
+
XP 版の「3 つのベロシティ値で予測」は、AI-DLC では次の 3 つに置き換えます。
|
|
679
|
+
|
|
680
|
+
- **完了 Unit 数と残 Unit 数**: 最新状況
|
|
681
|
+
- **Unit あたりの平均リードタイム**: 長期トレンド
|
|
682
|
+
- **エントロピー評価が HIGH の残 Unit 数**: 最悪ケースの見込み(人の検証時間が最も必要な部分)
|
|
683
|
+
|
|
684
|
+
### 6.2 Bolt 終了報告
|
|
685
|
+
|
|
686
|
+
```markdown
|
|
687
|
+
# Bolt 終了報告テンプレート
|
|
688
|
+
|
|
689
|
+
## 基本情報
|
|
690
|
+
- Bolt: 第 X 回
|
|
691
|
+
- 期間: YYYY/MM/DD HH:MM - YYYY/MM/DD HH:MM
|
|
692
|
+
- 対象 Unit: Unit C(注文処理)
|
|
693
|
+
- ゴール: カートに商品を追加する流れをエンドツーエンドで動かす
|
|
694
|
+
- 確認したかった仮説: AI が生成するドメインモデルの品質が十分か
|
|
695
|
+
|
|
696
|
+
## 成果
|
|
697
|
+
| ステップ | 状態 | ゲート | 変更依頼 |
|
|
698
|
+
| :--- | :--- | :--- | :--- |
|
|
699
|
+
| 1. カート集約のドメインモデル | 完了 | 通過 | 1(数量の値オブジェクト化) |
|
|
700
|
+
| 2. カート追加のテスト | 完了 | 通過 | 0 |
|
|
701
|
+
| 3. カート追加の実装 | 完了 | 通過 | 0 |
|
|
702
|
+
| 4. リポジトリのテスト・実装 | 完了 | 通過 | 2(スキーマ変更の確認) |
|
|
703
|
+
| 5. キャッシュ層 | スキップ | — | スコープ外と判断 |
|
|
704
|
+
|
|
705
|
+
## 指標
|
|
706
|
+
- 承認ゲート通過数: 4 / 変更依頼: 3(手戻り率 0.75)
|
|
707
|
+
- リードタイム: 6 時間
|
|
708
|
+
- テスト: 単体 12 件・統合 3 件、すべて成功
|
|
709
|
+
- 仮説の結論: ドメインモデルは十分。値オブジェクトの粒度はガードレール化した
|
|
710
|
+
|
|
711
|
+
## 判断と学び(ジャーナルへ転記)
|
|
712
|
+
- 数量は値オブジェクトにする(AI は int で生成した)→ PROJECT.md に追記
|
|
713
|
+
- スキーマ変更は計画時点で人の確認ステップを明示させる → プロンプト骨格を更新
|
|
714
|
+
|
|
715
|
+
## 次の Bolt
|
|
716
|
+
- Unit C Bolt 6:注文確定・決済(エントロピー評価 HIGH。決済ステップは各ゲートで検証)
|
|
717
|
+
```
|
|
718
|
+
|
|
719
|
+
### 6.3 判断と学びの記録
|
|
720
|
+
|
|
721
|
+
承認ゲートで人が下した判断(承認・変更依頼・現状で受け入れ)と、その理由は、次の Bolt のコンテキストになります。
|
|
722
|
+
|
|
723
|
+
- ゲートごとの判断は監査ログ(本プロジェクトでは `docs/journal/`)に残す
|
|
724
|
+
- AI の振る舞いを修正した内容はガードレールとして `CLAUDE.md`・`PROJECT.md`・スキルに反映する
|
|
725
|
+
- 技術的意思決定は ADR にする
|
|
726
|
+
|
|
727
|
+
---
|
|
728
|
+
|
|
729
|
+
## 7. チェックリスト
|
|
730
|
+
|
|
731
|
+
### リリース計画チェックリスト
|
|
732
|
+
|
|
733
|
+
- [ ] Intent が 1 文で表明され、ビジネス価値と測定基準が定義されている
|
|
734
|
+
- [ ] AI が提案した Level 1 計画を人が検証・承認した
|
|
735
|
+
- [ ] Intent が疎結合・高凝集な Unit に分解され、モブが検証した
|
|
736
|
+
- [ ] 各 Unit にストーリー・受入条件・NFR・リスク記述・測定基準・推奨 Bolt がある
|
|
737
|
+
- [ ] 各 Unit のエントロピー評価(5 軸)が LOW/MED/HIGH で記録されている
|
|
738
|
+
- [ ] スコープ・深さ・テスト戦略を選択し、その理由を記録した
|
|
739
|
+
- [ ] Unit 間の依存 DAG があり、並列に回せる Unit が特定されている
|
|
740
|
+
- [ ] 最初の Bolt がウォーキングスケルトンになっている
|
|
741
|
+
- [ ] リスク台帳との対応と、承認ゲートを密にする箇所が決まっている
|
|
742
|
+
- [ ] スコープバッファ(優先度の低い Unit)を用意した
|
|
743
|
+
|
|
744
|
+
### Bolt 計画チェックリスト
|
|
745
|
+
|
|
746
|
+
- [ ] Bolt ゴールが 1〜2 行で表現され、確認したい仮説を含む
|
|
747
|
+
- [ ] AI がチェックボックス付きのステップ計画を書いた
|
|
748
|
+
- [ ] ステップがテストファーストの順序になっている
|
|
749
|
+
- [ ] 確認必須の操作(新規ファイル・構造変更・セキュリティ・本番環境)に確認ポイントが明記されている
|
|
750
|
+
- [ ] 入力となる成果物がパスで明示されている
|
|
751
|
+
- [ ] AI の置いた仮定が明示され、確認済み
|
|
752
|
+
- [ ] 人が計画を承認した(または 3 回以上の変更依頼後に現状で受け入れた)
|
|
753
|
+
- [ ] 承認ゲートに立ち会うモブの集中時間が確保されている
|
|
754
|
+
|
|
755
|
+
### 見積もり(評価)チェックリスト
|
|
756
|
+
|
|
757
|
+
- [ ] エントロピー評価を 5 軸すべてで行った
|
|
758
|
+
- [ ] 評価が HIGH の軸に対する対策(質問・リバースエンジニアリング・テスト戦略・ゲート追加・仮定の確認)を決めた
|
|
759
|
+
- [ ] 評価の根拠をモブで共有した
|
|
760
|
+
- [ ] 前の Bolt の実績(ゲート回数・変更依頼数・リードタイム)を評価に反映した
|
|
761
|
+
- [ ] ガードレールの追加を評価に織り込んだ
|
|
762
|
+
|
|
763
|
+
---
|
|
764
|
+
|
|
765
|
+
## 8. 本プロジェクトの計画スキルへの適用
|
|
766
|
+
|
|
767
|
+
本プロジェクトの計画・進捗スキルは XP 版のガイドを前提にしています。AI-DLC 版で運用する場合の読み替えは次のとおりです。
|
|
768
|
+
|
|
769
|
+
| スキル | XP 版の運用 | AI-DLC 版の読み替え |
|
|
770
|
+
| :--- | :--- | :--- |
|
|
771
|
+
| `planning-releases` | ストーリーポイントでリリース計画を作る | Intent → Unit 分解と Bolt 計画を AI に提案させ、人が承認する。`release_plan.md` の見積もり欄はエントロピー評価と深さ・テスト戦略に置き換える |
|
|
772
|
+
| `creating-development-strategy` | 局面別 TDD アプローチとウォーキングスケルトン | 最初の Bolt をウォーキングスケルトンとし、以降のゲート密度をここで決める |
|
|
773
|
+
| `opening-iteration` | イテレーション計画の作成と整合性検証 | Bolt 計画の作成と承認。`validating-iteration-plan` は Level 1 計画・Unit 分解との整合性検証に使う |
|
|
774
|
+
| `validating-design` | 設計トピックの横断検証 | フェーズ境界の検証ゲート(成果物の存在・トレーサビリティ・孤立成果物)として使う |
|
|
775
|
+
| `tracking-progress` | ベロシティ・バーンダウン | 完了 Unit 数・承認ゲート通過数・変更依頼数・リードタイムに置き換える |
|
|
776
|
+
| `closing-iteration` | ふりかえりと完了報告書 | Bolt 終了報告(6.2 節)と、判断・学びのジャーナル転記、ガードレールの反映 |
|
|
777
|
+
| `creating-iteration-report` | イテレーション完了報告書 | Bolt 終了報告のテンプレートで生成する |
|
|
778
|
+
| `syncing-github-project` | ストーリーを Issue に同期 | Unit を Milestone、Bolt のステップを Issue に同期する |
|
|
779
|
+
|
|
780
|
+
計画ドキュメントの配置は [ドキュメント構成ガイド](ドキュメント構成ガイド.md) に従い、`docs/development/` に Level 1 計画・Bolt 計画・Bolt 終了報告を置きます。
|
|
781
|
+
|
|
782
|
+
---
|
|
783
|
+
|
|
784
|
+
## まとめ
|
|
785
|
+
|
|
786
|
+
このガイドに従うことで、チームは AI-DLC の原則に沿ったリリース計画と Bolt 計画を作成できます。重要なのは次の 4 点です。
|
|
787
|
+
|
|
788
|
+
1. **AI が計画し、人が検証する**: 計画づくりは AI に任せ、人の時間は承認ゲートでの検証に集中させる
|
|
789
|
+
2. **検証を損失関数として設計する**: ゲートの密度をエントロピー評価とウォーキングスケルトンの結果で決め、初期は密に、安定したら疎にする
|
|
790
|
+
3. **価値と手戻りで測る**: ベロシティではなく、完了 Unit 数・リードタイム・手戻り率・ビジネス価値で計画を評価する
|
|
791
|
+
4. **判断を記録し、ガードレールにする**: 承認ゲートでの判断と学びを次の Bolt のコンテキストにし、同じ変更依頼を繰り返さない
|
|
792
|
+
|
|
793
|
+
XP 版の原則(継続的な改善・チーム全体での合意・価値志向・透明性)は AI-DLC 版でも変わりません。定期的にこのガイドを見直し、チームの状況に合わせてカスタマイズしてください。
|