@k2works/claude-code-booster 6.0.0 → 6.1.0

package/lib/assets/.claude/skills/migrating-ai-dlc/SKILL.md

@@ -0,0 +1,243 @@
+---
+name: migrating-ai-dlc
+description: XP ベースで運用してきた既存プロジェクトを AI-DLC（AI-Driven Development Lifecycle）の運用に移行し、移行後の適合性を検証する。現状を棚卸しして移行計画を作り、承認後にリスク台帳・用語集・既存コードの静的／動的モデル・受入条件の Given/When/Then 化・Unit 分解（依存 DAG・ストーリーマップ）・リリース計画のエントロピー評価・Bolt 計画・PROJECT.md のガードレールを 1 ステップずつ整える。「AI-DLC に移行したい」「AI-DLC を導入したい」「このプロジェクトを AI-DLC で回したい」「ストーリーを Unit に分けたい」「イテレーション計画を Bolt 計画にしたい」「AI-DLC に適合しているか確認したい」といった場面で必ず発動する。CLAUDE.md に AI-DLC 採用が書かれているのに docs/ や PROJECT.md が XP 版のままの場面でも積極的に提案すること。日常の Bolt 計画は planning-releases、ストーリー作成は analyzing-usecases が担う。
+---
+
+# AI-DLC 移行
+
+XP ベースで運用してきたプロジェクトを **AI-DLC** の運用に移行し、移行後の適合性を検証する。日常の運用（Bolt 計画・ストーリー作成・実装）は各スキルが担い、本スキルは「一度きりの移行」と「適合しているかの確認」を担う。`migrating-okf` が文書のフォーマットを移行するのに対し、本スキルは **開発の進め方** を移行する。
+
+移行の根拠は次のガイド。**作業前に必ず読む**。ガイドと本スキルが食い違う場合はガイドを正とする。
+
+| ガイド | 本スキルで使う箇所 |
+| :--- | :--- |
+| `docs/reference/AI-DLC導入ガイド.md` | 第 3 章（10 原則）、第 4 章（成果物）、第 13 章（本プロジェクトへの導入ステップ） |
+| `docs/reference/開発ガイド_AI-DLC版.md` | 活動ごとの AI と人の分担、ガイド対応表 |
+| `docs/reference/リリース・イテレーション計画ガイド_AI-DLC版.md` | 第 1 章（Unit 分解・エントロピー評価・Bolt 計画）、第 5 章（リスク台帳）、第 8 章（計画スキルの読み替え） |
+| `docs/reference/ユースケース作成ガイド_AI-DLC版.md` | 第 5 章（テンプレート）、第 10 章（Unit とストーリーマップ）、第 12 章（ブラウンフィールド） |
+| `docs/reference/コーディングとテストガイド_AI-DLC版.md` | 基本原則（ガードレール化する規律）、本プロジェクトの開発スキルへの適用 |
+| `docs/reference/AI-DLC用語集.md` | 用語の定義 |
+
+同じディレクトリに `PROJECT.md` があれば必ず読む。対象プロジェクトの識別子・`docs/` と `apps/` の配置・既存の計画ファイル名・ガードレールの置き場所など、プロジェクト固有の値はそこにある。
+
+## なぜ移行するのか
+
+AI-DLC の核心は「AI が計画・分解・生成を担い、人が承認ゲートで検証・決定する」構図にある。ガイドを置き、CLAUDE.md に採用を書いただけでは、docs/ のストーリーは Unit にまとまっておらず、計画はストーリーポイントのままで、AI に渡せない範囲も決まっていない。そのままだと AI は既存の XP 版の成果物を読んで XP 版の振る舞いを続け、人は「AI-DLC を採用したはずなのに何も変わらない」と感じる。移行の本質はファイルの改名ではなく、**AI が読む成果物を AI-DLC の契約（Unit・受入条件・リスク・ガードレール）の形に揃えること** である。
+
+移行そのものも AI-DLC の流儀で進める。計画を書き、人の承認を得てから 1 ステップずつ実行し、重要な判断（Unit の境界、AI に渡せない範囲、ゲート密度）は勝手にしない。
+
+## モード
+
+| モード | 用途 |
+| :--- | :--- |
+| `--plan` | 現状を棚卸しし、移行前の状態を測り、移行計画をチェックボックス付き Markdown で提示する。既存の成果物は変更しない |
+| `--migrate` | 承認済みの移行計画を 1 ステップずつ実行する（既定） |
+| `--check` | 移行後の適合性を検証し、不足を移行ステップに対応づけて報告する。ファイルは変更しない |
+
+指定がなければ、移行済みの痕跡（`docs/requirements/<project>/units.md`）が無ければ `--plan` → 承認 → `--migrate`、あれば `--check` から始める。
+
+## 進め方
+
+### 1. 棚卸しと移行計画（`--plan`）
+
+#### 1-1. 移行前の状態を測る
+
+最初に検査スクリプトを実行し、ERROR と WARN の件数と主な項目を記録する。移行の前後を同じ物差しで比べられるようにするためで、計画の各ステップがどの不足を埋めるのかも、この結果と対応づけて書ける。
+
+```bash
+python .claude/skills/migrating-ai-dlc/scripts/aidlc_check.py --project <project>
+```
+
+#### 1-2. 棚卸し
+
+次を調べ、現状を表にまとめる。
+
+| 調査対象 | 見るもの | 判断 |
+| :--- | :--- | :--- |
+| `CLAUDE.md` | 「開発方法論：AI-DLC を採用する」節の有無、ペルソナの参照先 | 無ければ移行ステップに含める |
+| `docs/reference/` | AI-DLC 導入ガイドと AI-DLC 版ガイド 4 本・用語集の有無 | 無ければ `npx boost --update` を先に案内し、移行は中断する |
+| `docs/requirements/<project>/` | ユーザーストーリーの本数、受入条件を持つストーリーの本数（ストーリー単位で数える）、書式 | 受入条件が Given/When/Then でなければ書き直しの対象 |
+| `docs/development/<project>/` | `release_plan.md`・`iteration_plan-N.md` の見積もり方式、進行中のイテレーション | 進行中のイテレーションは Bolt 計画に読み替える。完了済みは触らない |
+| `docs/design/<project>/` | ドメインモデル・用語集・アーキテクチャ・ADR の有無 | 用語集が無ければ移行ステップで作る |
+| `apps/<project>/` | コードの有無（ブラウンフィールドか）、テストの有無、フロントエンドの有無 | ブラウンフィールドなら静的・動的モデルへの昇格を含める。フロントエンドが無ければ `developing-frontend` は対象外 |
+| `.claude/skills/*/PROJECT.md` | 既存のガードレール（命名規則・既存ユーティリティ・確認必須の操作） | TDD の三原則などの AI-DLC の規律が無ければ追記対象 |
+| 組織のポリシー | AI に渡せないデータ・コード・鍵 | 分からなければ質問する。仮定で埋めない |
+
+#### 1-3. 移行計画を書く
+
+計画は `docs/development/<project>/aidlc_migration_plan.md` に書く。ファイル名は変えない。`--check` がこのパスで計画の有無を確かめる。
+
+**計画に書くのは「何を・どの順で変え・どこで人の判断が要るか」まで** にする。Unit 定義、依存 DAG、ストーリーマップ、リスク台帳の表、エントロピー評価の表、静的・動的モデル、Bolt のステップといった **後続ステップの成果物は計画に書かない**。理由は 2 つある。
+
+- 承認ゲートは誤りを早く刈り取るための損失関数で、1 つのゲートで判断するものは少ないほど効く。計画に Unit 案まで入れると、人は計画の承認と Unit 境界の承認を同時に求められ、ステップ 6 のゲートを経ずに境界が既成事実になる
+- 計画が変更依頼で書き直されると、先に作った成果物の下書きはそのまま無駄になる。計画が短いほど承認までの往復も速い
+
+棚卸しで気づいた候補（「決済は独立 Unit になりそう」「10 万円超の承認分岐は業務ルール候補」など）は、該当ステップの注記か要確認に 1 行で書けば足りる。
+
+```markdown
+# AI-DLC 移行計画：<project>
+
+## 現状
+- 検査結果（移行前）: ERROR 3 / WARN 9（主な項目: units.md 無し、risk_register.md 無し、CLAUDE.md の採用節無し）
+- ストーリー: 12 本（受入条件あり 3 本、Given/When/Then 0 本）
+- 計画: release_plan.md（ストーリーポイント）、iteration_plan-3.md 進行中
+- コード: apps/<project>/（ブラウンフィールド、テスト 2 件、フロントエンド無し）
+- ガードレール: developing-backend/PROJECT.md に命名規則のみ
+
+## 移行ステップ
+- [ ] 1. CLAUDE.md に AI-DLC 採用を明記する
+- [ ] 2. AI に渡せる範囲（In/Out）とリスク台帳を作る ※組織ポリシーの確認が必要
+- [ ] 3. ドメイン用語集を整備する
+- [ ] 4. 既存コードを静的・動的モデルに昇格させる（ブラウンフィールド） ※業務ルール候補の確認が必要
+- [ ] 5. ストーリーの受入条件を Given/When/Then に揃える
+- [ ] 6. ストーリーを Unit にまとめ、依存 DAG とストーリーマップを作る ※Unit の境界は要承認
+- [ ] 7. release_plan.md にエントロピー評価とスコープ・深さ・テスト戦略を加える
+- [ ] 8. 進行中の iteration_plan-3.md を bolt_plan-3.md に読み替える ※ウォーキングスケルトンの選定は要承認
+- [ ] 9. ガードレールを各スキルの PROJECT.md に書く
+- [ ] 10. OKF を適用し、適合性を検証する（目標: ERROR 0）
+
+## AI の仮定
+- 決済は外部サービスのため AI に本番キーを渡さない（要確認）
+
+## 要確認
+- AI に渡せないデータ・鍵の範囲と、組織のリスク台帳の有無
+```
+
+`--plan` で作るのは計画ファイルと、その `index.md`・`log.md` への登録だけ。既存のストーリーや計画は変更しない。
+
+### 2. 移行（`--migrate`）
+
+承認された計画を 1 ステップずつ実行し、完了ごとにチェックボックスを更新する。成果物の書式は `references/artifact-templates.md` を使う。
+
+#### ステップ 1：CLAUDE.md に AI-DLC 採用を明記する
+
+`lib/assets/CLAUDE.md`（booster のテンプレート）と同じ「開発方法論：AI-DLC を採用する」節を、対象プロジェクトの `CLAUDE.md` に加える。ペルソナの参照先を `開発ガイド_AI-DLC版.md` にする。すでにあれば何もしない。
+
+#### ステップ 2：AI に渡せる範囲とリスク台帳を作る
+
+`docs/requirements/<project>/risk_register.md` を作る。組織のリスク台帳があればその ID と対応づける。本番データ・機密情報・鍵・決済など **AI に渡せないもの** と、**確認必須の操作**（新規ファイル・構造変更・外部連携・セキュリティ・データベース・本番環境）を列挙し、各リスクに `R-01` のような ID を振る。ここで決めた内容が以降のすべての AI 生成物の前提になるので、分からないことは質問して埋める。
+
+#### ステップ 3：ドメイン用語集を整備する
+
+`docs/design/<project>/glossary.md` が無ければ、既存のストーリー・ドメインモデル・コードの命名から用語を集めて作る。同じ概念が別の語で書かれていれば統一する。AI はユースケース内の語のゆれを別エンティティとして生成するため、用語集は Unit 分解の前に要る。
+
+#### ステップ 4：既存コードを静的・動的モデルに昇格させる（ブラウンフィールドのみ）
+
+`apps/<project>/` のコードから、静的モデル（コンポーネント・責務・関係）と動的モデル（主要ユースケースを実現する相互作用）を `docs/design/<project>/` に書く。コードに埋め込まれた条件分岐は業務ルール候補として別に列挙し、使われていない経路や不明な意図は推測せず「要確認」と印を付ける。人が検証してから次に進む。これを省くと AI は生のコードを読んで規約から外れた生成をする。
+
+#### ステップ 5：受入条件を揃える
+
+各ストーリーの受入条件を Given/When/Then で一意に判定できる形にする。「参照する成果物」「確認ポイント」「AI の仮定」の欄を加える（ユースケース作成ガイド AI-DLC 版 第 5 章のストーリー形式）。既存の文面の意味は変えない。曖昧で書き直せないものは「要確認」として人に戻す。
+
+#### ステップ 6：Unit 分解・依存 DAG・ストーリーマップ
+
+ストーリーを凝集度で **Unit** にまとめ、`docs/requirements/<project>/units.md` に書く。各 Unit には **目的・含まれるストーリー・NFR・リスク・測定基準・推奨 Bolt・エントロピー評価・AI の仮定** を置く。続けて Unit 間の依存 DAG と、ユースケース × Unit × ストーリーの対応表を書き、どの Unit にも入らないストーリーは「未配置」として列挙する。
+
+- **Unit の条件** は「独立して開発・デプロイできる」こと。ユースケースの境界とは一致させない。境界は設計判断なので、案を示して人の承認を得る
+- **リスク欄は台帳の ID で参照する**（例: `R-01（本番キーを渡さない）`）。ガードレールの本文は `risk_register.md` と各スキルの `PROJECT.md` に置き、units.md に書き写さない。AI は作業のたびに台帳と PROJECT.md を読むが、units.md に埋もれた禁止事項は Unit を読まない作業では見落とされ、二重管理にもなる。台帳がまだ無ければ暫定 ID（`R-P01` など）を振り、ステップ 2 で正式な ID に置き換えると「AI の仮定」に書く
+- **AI の仮定** には、境界を決めるときに置いた前提（「与信チェックは注文処理側に置く」など）を書く。承認ゲートで人が確かめるべき点が明示される
+
+書き終えたら `aidlc_check.py` を実行し、units.md に関する項目がすべて OK になったことを確かめて報告する。
+
+#### ステップ 7：リリース計画の読み替え
+
+`docs/development/<project>/release_plan.md` に、Unit ごとの **エントロピー評価**（意図の曖昧さ・構造的不確実性・検証の不確実性・リスク・未解決の仮定を LOW／MED／HIGH）と、**スコープ・深さ・テスト戦略** の選択を加える。ストーリーポイント欄は削除せず「参考」として残す。本番機能のテスト戦略は Standard 未満にしない。未配置のストーリーを計画に残す場合は、Unit を追加するかスコープバッファとして明記する。
+
+#### ステップ 8：進行中のイテレーション計画を Bolt 計画に読み替える
+
+進行中の `iteration_plan-N.md` から、同じ番号の `bolt_plan-N.md` を作る。Bolt ゴールに「確認したい仮説」を入れ、最初の Bolt を **ウォーキングスケルトン**（エンドツーエンドの最小の縦割り）にする。ゴールとステップが一致しているか（「API から DB まで通す」ならその層のステップが全部あるか）を確かめる。ゲート密度は「各ステップでゲート」を既定にし、ウォーキングスケルトンの結果で見直すと明記する。元の `iteration_plan-N.md` は `apply-okf` の deprecate で `replaced_by` を付け、削除しない。完了済みのイテレーション計画は触らない。
+
+#### ステップ 9：ガードレールを書く
+
+各スキルの `PROJECT.md` に、AI-DLC の規律をプロジェクト固有の形で書く。SKILL.md は booster の更新で上書きされるため、必ず `PROJECT.md` 側に置く。対象プロジェクトに無い層のスキル（フロントエンドが無ければ `developing-frontend`）は書かなくてよい。
+
+| 置き場所 | 書く内容 |
+| :--- | :--- |
+| `developing-backend/PROJECT.md`、`developing-frontend/PROJECT.md` | TDD の三原則をプロンプトに明示すること、ステップ計画の置き場所、テストの命名規則、参照すべき既存実装・フィクスチャ、確認必須の操作 |
+| `planning-releases/PROJECT.md` | Unit 定義・Bolt 計画の置き場所、エントロピー評価の運用、ゲート密度の既定 |
+| `analyzing-usecases/PROJECT.md` | 用語集の場所、受入条件の書式、Unit 分解の条件 |
+| `developing-review/PROJECT.md` | AI 生成コード固有の観点（先回り実装・同型テスト・過剰モック・既存の無視） |
+| `ai-agent-guidelines/PROJECT.md` | 全行理解、仮の実装の明示、修正のガードレール反映先 |
+
+既に人が AI を修正した記録（ジャーナル・レビュー指摘）があれば、それもガードレールに写す。
+
+#### ステップ 10：OKF 適用と検証
+
+作成・変更した文書に `apply-okf` を実行し（`apply docs --changed --by <agent>`）、`index.md`・`log.md` を更新する。`okf_apply.py` は git の差分から変更を判定するため、git 管理外のプロジェクトでは失敗する。その場合は `docs/reference/OKF導入ガイド_V0.2.md` §5 に沿ってフロントマター（`type`・`title`・`description`・`generated`、未レビューなら `status: draft`）を手で書き、`index.md`・`log.md` も既存の書式に合わせて更新し、完了報告にその旨を書く。
+
+続けて本スキルの `--check` を実行し、不足があれば計画に戻る。移行計画の「AI の仮定」欄に残った未確認の仮定は、完了報告の要確認に載せる。
+
+### 3. 検証（`--check`）
+
+#### 3-1. 検査スクリプトを実行する
+
+```bash
+python .claude/skills/migrating-ai-dlc/scripts/aidlc_check.py --project <project> [--docs docs] [--apps apps] [--claude-md CLAUDE.md]
+```
+
+ERROR は移行が完了していない印、WARN は運用の中で埋めればよい印。報告には件数（`ERROR n / WARN n`）と各項目をそのまま載せる。
+
+| 項目 | 判定 |
+| :--- | :--- |
+| CLAUDE.md に「AI-DLC を採用する」節がある | ERROR |
+| AI-DLC 導入ガイド・AI-DLC 版ガイド 4 本・用語集が `docs/reference/` にある | ERROR |
+| `units.md` がある | ERROR |
+| 各 Unit に目的・ストーリー・NFR・リスク・測定基準・推奨 Bolt・エントロピー評価・AI の仮定がある | WARN |
+| `units.md` に依存 DAG とストーリーマップがある | WARN |
+| 未配置のストーリーが `release_plan.md` に割り当てられていない | WARN |
+| `risk_register.md` があり、AI に渡せる範囲と確認必須の操作が書かれている | ERROR |
+| `glossary.md` がある | WARN |
+| 受入条件を持つストーリーの本数と、Given/When/Then の本数（ストーリー単位） | WARN（割合を報告） |
+| `release_plan.md` にエントロピー評価とテスト戦略がある | WARN |
+| `bolt_plan-N.md` に確認したい仮説・ゲート密度・ウォーキングスケルトンがあり、同じ番号の `iteration_plan-N.md` が deprecated になっている | WARN |
+| ブラウンフィールドで静的・動的モデルがある | WARN |
+| 移行で作った成果物に人の承認記録（`verified`）がある | WARN |
+| 移行で作った成果物が各ディレクトリの `index.md` に登録されている | WARN |
+| `aidlc_migration_plan.md` がある | WARN |
+| 開発スキルの `PROJECT.md` に TDD の三原則がある（フロントエンドが無ければ `developing-frontend` は対象外） | WARN |
+
+#### 3-2. スクリプトが見ない点を読んで確かめる
+
+スクリプトはファイルとキーワードの有無しか見ない。ERROR 0 でも運用できる状態とは限らないので、次を実際に読んで確かめる。
+
+- **成果物同士の矛盾**: 依存 DAG と Bolt の並び・リリース計画の順序が逆になっていないか。Bolt ゴールとステップが一致しているか。ストーリーの状態が文書間で食い違っていないか
+- **契約としての中身**: リスク台帳に「In（AI に任せる範囲）」が書かれているか、確認必須の操作が CLAUDE.md より少なくないか。用語集で語のゆれが解消されているか
+- **コードと契約の整合**（ブラウンフィールド）: 受入条件と既存実装の振る舞いが一致しているか。テストの無い先回り実装や未使用コードが残っていないか
+
+#### 3-3. 報告する
+
+不足ごとに、該当する移行ステップ番号と直し方を書く。`--check` ではファイルを変更しない。直すかどうかは人が決め、承認されたら `--migrate` の該当ステップで直す。
+
+## 判断に迷いやすい点
+
+- **Unit の境界**: ユースケース単位でも画面単位でもなく「独立してデプロイできるか」で切る。迷ったら小さく切らず、依存を共有する Unit を 1 つにまとめる方が安全。分割は後からできる
+- **完了済みのイテレーション**: 読み替えない。過去の記録は当時の方法論のまま残す
+- **ストーリーポイントの扱い**: 消さない。エントロピー評価を並記し、数 Bolt 回した後にどちらが予測に役立ったかで決める
+- **ガードレールの粒度**: 「〜してはならない」を並べるより、なぜその規律が要るか（AI が先回りして実装する、既存を探さず重複を作る）を書く。理由が伝われば AI は類似の場面にも適用できる
+- **AI に渡せない範囲が決まらない**: 移行を止めて質問する。ここを仮定で埋めると、以降のすべての生成物が組織ポリシーに反する可能性がある
+- **計画に下書きを入れたくなったとき**: 入れない。気づいた候補は要確認に 1 行で残し、該当ステップのゲートで判断してもらう
+
+## 完了報告
+
+`--migrate` の最後に次を報告する。
+
+```markdown
+## AI-DLC 移行結果
+
+- 対象: <project>（グリーンフィールド／ブラウンフィールド）
+- Unit: <N> 件（ストーリー <M> 件を配置、未配置 <K> 件）
+- 計画: release_plan.md にエントロピー評価を追加、iteration_plan-<N>.md → bolt_plan-<N>.md（ウォーキングスケルトン: <Unit 名>）
+- ガードレール: <更新した PROJECT.md の一覧>
+- 検証: 移行前 ERROR <n> / WARN <n> → 移行後 ERROR 0 / WARN <n>
+- 要確認: <Unit の境界の判断、AI に渡せない範囲、未確認の仮定 など>
+```
+
+## 関連スキル
+
+- `planning-releases` / `opening-iteration` — 移行後の Bolt 計画の日常運用
+- `analyzing-usecases` — 移行後のストーリー作成（Mob Elaboration）
+- `analyzing-architecture` / `analyzing-domain-model` — ブラウンフィールドのモデル昇格で参照する設計ガイド
+- `apply-okf` — 作成・変更した文書のフロントマターと索引、旧計画の deprecate
+- `apply-docs-structure` — 成果物の配置先の判断
+- `migrating-okf` — 文書フォーマットの移行（本スキルは開発の進め方の移行）
+- `git-commit` — 移行後のコミット（ユーザーの指示があるまでコミットしない）

package/lib/assets/.claude/skills/migrating-ai-dlc/evals/evals.json

@@ -0,0 +1,60 @@
+{
+  "skill_name": "migrating-ai-dlc",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "booster を更新したら docs/reference に AI-DLC 版のガイドが入ってた。うちの受注管理プロジェクト（docs/requirements/order/ にストーリー 12 本、docs/development/order/ に release_plan.md と進行中の iteration_plan-3.md、apps/order/ に Spring Boot のコードあり）を AI-DLC に移行したい。まず何をどう変えるか計画を出して。",
+      "expected_output": "--plan として、まず aidlc_check.py で移行前の状態（ERROR/WARN の件数）を測り、現状を棚卸しする。docs/development/order/aidlc_migration_plan.md に、検査結果・現状・チェックボックス付きの 10 ステップ（CLAUDE.md、リスク台帳、用語集、静的・動的モデル、受入条件、Unit 分解、release_plan 追記、iteration_plan-3 → bolt_plan-3、ガードレール、OKF 適用）・AI の仮定・要確認を書く。Unit 案・依存 DAG・ストーリーマップ・リスク台帳の表・静的モデル・Bolt 計画案などの後続ステップの成果物は計画に書かず、候補は要確認に 1 行で残す。既存のストーリーと計画は変更しない",
+      "files": [],
+      "assertions": [
+        "移行計画がチェックボックス付き Markdown で作られている",
+        "移行計画が既定のパス docs/development/order/aidlc_migration_plan.md にある",
+        "計画に Unit 分解と iteration_plan → bolt_plan の読み替えが含まれる",
+        "ブラウンフィールドとして既存コードの静的・動的モデル昇格が含まれる",
+        "リスク台帳と AI に渡せる範囲（In/Out）の作成が含まれる",
+        "Unit 境界などの判断を要確認として人に戻している",
+        "--plan では既存のストーリー・計画ファイルを変更していない",
+        "CLAUDE.md への AI-DLC 採用の明記が含まれる",
+        "移行前の状態を aidlc_check.py で測り、ERROR/WARN の件数を計画に記録している",
+        "後続ステップの成果物（Unit 案・依存 DAG・ストーリーマップ・リスク台帳・静的／動的モデル・Bolt 計画案など）を計画の節として先取りしていない"
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "移行計画は承認した。ステップ 6 の Unit 分解をやって。docs/requirements/order/ のストーリーを Unit にまとめて、依存関係とストーリーマップも作って。決済まわりは外部サービスだから本番キーは絶対 AI に渡さない前提で。",
+      "expected_output": "docs/requirements/order/units.md に、各 Unit の目的・含まれるストーリー・NFR・リスク（リスク台帳の ID で参照、未作成なら暫定 ID）・測定基準・推奨 Bolt・エントロピー評価・AI の仮定、依存 DAG、ユースケース × Unit × ストーリーの対応表、未配置ストーリーを書く。決済は独立 Unit にし、本番キーを渡さない前提をリスク ID で対応づける。ガードレールの本文は units.md に書き写さない。Unit の境界は案として示し承認を求める。apply-okf（git 管理外なら手書き）でフロントマターと index/log を更新し、aidlc_check.py で units.md の項目を検証して報告する",
+      "files": [],
+      "assertions": [
+        "docs/requirements/order/units.md が作られている",
+        "各 Unit に目的・ストーリー・NFR・リスク・測定基準・推奨 Bolt がある",
+        "依存 DAG とストーリーマップがある",
+        "決済が独立 Unit で、本番キーを AI に渡さない前提と対応づいている",
+        "12 ストーリーすべてが配置または未配置として言及されている",
+        "units.md に OKF フロントマターがある",
+        "docs/log.md に記録がある",
+        "Unit 境界を案として示し承認を求めている",
+        "すべての Unit に「AI の仮定」がある",
+        "Unit のリスクをリスク台帳（risk_register.md）の ID で参照している",
+        "aidlc_check.py で units.md を検証し、結果を報告している"
+      ]
+    },
+    {
+      "id": 3,
+      "prompt": "AI-DLC への移行は一通り終わったつもりなんだけど、ちゃんと揃ってるか確認して。プロジェクトは order。",
+      "expected_output": "--check として aidlc_check.py --project order を実行し、ERROR/WARN の件数と各項目を報告する（受入条件はストーリー単位、フロントエンドの無いプロジェクトでは developing-frontend を対象外、verified・index 登録・未配置ストーリーの計画混入も含む）。続けてスクリプトが見ない点（成果物同士の矛盾、リスク台帳・用語集の中身、コードと受入条件の整合）を読んで確かめ、不足ごとに移行ステップ番号と直し方を示す。ファイルは変更しない",
+      "files": [],
+      "assertions": [
+        "U-03 決済連携の推奨 Bolt 欠けを指摘している",
+        "release_plan.md のテスト戦略欠けを指摘している",
+        "bolt_plan-3.md のゲート密度欠けを指摘している",
+        "受入条件の不足をストーリー単位（12 本中 3 本）で数えている",
+        "受入条件の Given/When/Then 不足を指摘している",
+        "存在する成果物（units/risk_register/glossary）を誤って欠けとしていない",
+        "不足を移行ステップに対応づけている",
+        "aidlc_check.py を実行し、ERROR/WARN の件数を報告している",
+        "AI 生成の移行成果物に人の承認記録（verified）が無いことを指摘している",
+        "未配置の US-11・US-12 がリリース計画に割り当てられている矛盾を指摘している"
+      ]
+    }
+  ]
+}

package/lib/assets/.claude/skills/migrating-ai-dlc/references/artifact-templates.md

@@ -0,0 +1,258 @@
+# AI-DLC 移行で作る成果物のテンプレート
+
+移行ステップで作成する文書の骨格。各ガイドのテンプレートを移行用に抜粋したもので、詳細な説明は各ガイドを参照する。
+
+## 目次
+
+1. リスク台帳（`docs/requirements/<project>/risk_register.md`）
+2. Unit 定義・依存 DAG・ストーリーマップ（`docs/requirements/<project>/units.md`）
+3. ユーザーストーリー（AI-DLC 版の項目）
+4. リリース計画への追記（`docs/development/<project>/release_plan.md`）
+5. Bolt 計画（`docs/development/<project>/bolt_plan-N.md`）
+6. 静的モデル・動的モデル（`docs/design/<project>/`）
+7. ガードレール（各スキルの `PROJECT.md`）
+
+---
+
+## 1. リスク台帳
+
+```markdown
+# リスク台帳：<project>
+
+## AI に渡せる範囲（In/Out）
+
+| トピック | In | Out | AI に任せる | 備考 |
+| :--- | :---: | :---: | :---: | :--- |
+| ユーザー認証 | ✓ | | 設計と実装 | 認証方式の選択は人が承認（確認必須） |
+| 決済処理 | | ✓ | — | 外部サービス。契約テストのみ AI が生成。本番キーは渡さない |
+| 本番データ | | ✓ | — | AI には渡さない。テストはマスク済みデータで行う |
+
+## 確認必須の操作
+
+- 新規ファイル作成（計画に無いもの）
+- アーキテクチャ・フォルダ構造の変更
+- 外部 API・外部ライブラリの導入
+- 認証・認可の実装
+- スキーマ変更・マイグレーション
+- デプロイ設定・環境変数・本番環境への操作
+
+## リスク一覧
+
+| ID | リスク | 組織台帳との対応 | 対策 | 承認ゲート |
+| :--- | :--- | :--- | :--- | :--- |
+| R-01 | 決済情報の取り扱い | SEC-03 | テスト用モックで実装 | 決済ステップは必ず人が検証 |
+| R-02 | DB スキーマ変更 | CHG-01 | マイグレーションは人が確認してから適用 | スキーマ変更ステップで停止 |
+```
+
+---
+
+## 2. Unit 定義・依存 DAG・ストーリーマップ
+
+````markdown
+# Unit 定義：<project>
+
+## Unit 一覧
+
+### U-01：注文処理
+
+- **Intent**: <このユニットが寄与する Intent>
+- **目的**: 購入者が商品を注文し、注文を確定できる
+- **含まれるストーリー**: US-03 カートに追加する、US-04 配送先を入力する、US-06 注文を確定する
+- **NFR**: 注文確定は 2 秒以内。同一注文の二重送信を防ぐ
+- **リスク**: R-02（スキーマ変更）
+- **測定基準**: 注文完了率、カート放棄率
+- **推奨 Bolt**: Bolt 1（ウォーキングスケルトン：カート追加 → 注文確定を API から DB まで通す）、Bolt 2（配送先・確認メール）
+- **エントロピー評価**: 意図 LOW／構造 MED／検証 LOW／リスク MED／仮定 LOW
+- **AI の仮定**: 在庫引当は注文確定時に行う（要確認）
+
+### U-02：決済連携
+...
+
+## 依存 DAG
+
+```plantuml
+@startuml
+rectangle "U-01 注文処理" as u1
+rectangle "U-02 決済連携" as u2
+rectangle "U-03 商品カタログ" as u3
+u3 --> u1
+u1 --> u2
+@enduml
+```
+
+並列に回せる Unit: U-03 完了後に U-01 と U-04（在庫管理）
+
+## ストーリーマップ
+
+| ユースケース | Unit | ストーリー | 受入条件の書式 |
+| :--- | :--- | :--- | :--- |
+| UC-001 商品を注文する | U-03 商品カタログ | US-01 商品を検索する | Given/When/Then |
+| UC-001 商品を注文する | U-01 注文処理 | US-03 カートに追加する | Given/When/Then |
+| UC-001 商品を注文する | U-02 決済連携 | US-05 支払い方法を選択する | 要書き直し |
+
+未配置のストーリー: US-09（管理者向けレポート。Unit の追加を要判断）
+````
+
+---
+
+## 3. ユーザーストーリー（AI-DLC 版の項目）
+
+既存のストーリーに次の欄を加える。
+
+```markdown
+# US-03 カートに追加する
+
+**Unit**: U-01 注文処理
+**ユースケース**: UC-001
+
+**として**: 購入者
+**したい**: 商品をカートに追加する
+**なぜなら**: まとめて注文したい
+
+**受入条件**:
+
+- [ ] Given 在庫が 10 個の商品 / When 3 個をカートに追加する / Then カートの数量が 3 になる
+- [ ] Given 在庫が 2 個の商品 / When 3 個をカートに追加する / Then 在庫不足が通知され、カートは変わらない
+
+**参照する成果物**:
+
+- ドメインモデル: docs/design/<project>/domain_model.md
+- 既存実装: apps/<project>/src/.../Order.java（同じ方式で実装する）
+- ドメイン用語: docs/design/<project>/glossary.md
+
+**確認ポイント**: カートテーブルの追加（スキーマ変更）
+
+**AI の仮定**: カートはセッション単位ではなく購入者単位で永続化する（要確認）
+```
+
+---
+
+## 4. リリース計画への追記
+
+既存の `release_plan.md` に次の節を加える。ストーリーポイントの列は「参考」として残す。
+
+```markdown
+## Unit のエントロピー評価とテスト戦略
+
+| Unit | 意図 | 構造 | 検証 | リスク | 仮定 | AI 自律度 | スコープ | 深さ | テスト戦略 |
+| :--- | :---: | :---: | :---: | :---: | :---: | :--- | :--- | :--- | :--- |
+| U-03 商品カタログ | LOW | LOW | LOW | LOW | LOW | 高 | 実装中心 | Standard | Standard |
+| U-01 注文処理 | LOW | MED | LOW | MED | LOW | 中 | 全ステージ | Standard | Standard |
+| U-02 決済連携 | MED | HIGH | MED | HIGH | MED | 低 | 全ステージ | Comprehensive | Comprehensive |
+
+## Bolt の並び
+
+| Bolt | Unit | ゴール | 確認したい仮説 | 並列 |
+| :--- | :--- | :--- | :--- | :--- |
+| 1 | U-03 | ウォーキングスケルトン：検索を API から DB まで通す | AI が生成するリポジトリの品質が十分か | — |
+| 2 | U-01 | カート追加 → 注文確定 | 在庫引当のタイミング | Bolt 3 と並列 |
+```
+
+---
+
+## 5. Bolt 計画
+
+```markdown
+# Bolt 3 計画：<project>
+
+## Bolt ゴール
+注文 Unit の「カートに商品を追加する」ストーリーを、API からデータベースまで通して動かす。
+これで AI が生成するドメインモデルとリポジトリの品質がこのコードベースで十分かどうかが分かる。
+
+## 対象
+- Unit: U-01 注文処理
+- ストーリー: US-03（受入条件 AC-01, AC-02）
+- アプローチ: インサイドアウト
+- ゲート密度: 各ステップでゲート（ウォーキングスケルトンの結果で見直す）
+
+## ステップ計画（AI が作成、人が承認）
+- [ ] 1. カート集約のドメインモデルを設計する
+- [ ] 2. カートへの追加のテストを書く（Red）
+- [ ] 3. カート追加を実装する（Green）
+- [ ] 4. リファクタリングする
+- [ ] 5. リポジトリのテストを書く（Red） ※スキーマ変更のため要確認
+- [ ] 6. リポジトリを実装する（Green）
+
+## AI の仮定
+- 数量は値オブジェクトにする（要確認）
+
+## 読み替え元
+iteration_plan-3.md（deprecated、replaced_by: /development/<project>/bolt_plan-3.md）
+```
+
+---
+
+## 6. 静的モデル・動的モデル（ブラウンフィールド）
+
+```markdown
+# 静的モデル：<project>
+
+| コンポーネント | 責務 | 依存先 | 備考 |
+| :--- | :--- | :--- | :--- |
+| OrderService | 注文の確定と在庫引当の呼び出し | OrderRepository, InventoryClient | 在庫引当の失敗時に注文を破棄する分岐あり（業務ルール候補 BR-01） |
+| OrderRepository | 注文の永続化 | JDBC | |
+
+## 業務ルール候補（コードから抽出）
+
+| ID | コード上の条件 | 業務ルールとしての解釈 | 状態 |
+| :--- | :--- | :--- | :--- |
+| BR-01 | `if (stock < qty) throw` | 在庫不足の注文は確定できない | 確認済み |
+| BR-02 | `if (total > 100000) requireApproval()` | 10 万円超の注文は承認が要る | 要確認（現行業務に存在するか不明） |
+
+## 使われていない経路
+- `OrderService.reopen()`：呼び出し元なし。要確認
+```
+
+````markdown
+# 動的モデル：<project>
+
+## UC-001 商品を注文する
+
+```plantuml
+@startuml
+actor 購入者
+participant OrderController
+participant OrderService
+participant InventoryClient
+participant OrderRepository
+購入者 -> OrderController : POST /orders
+OrderController -> OrderService : confirm(order)
+OrderService -> InventoryClient : reserve(items)
+InventoryClient --> OrderService : reserved
+OrderService -> OrderRepository : save(order)
+OrderRepository --> OrderService : saved
+OrderService --> OrderController : confirmed
+@enduml
+```
+````
+
+---
+
+## 7. ガードレール（各スキルの `PROJECT.md`）
+
+`developing-backend/PROJECT.md` の追記例。
+
+```markdown
+## AI-DLC の規律（本プロジェクト固有）
+
+### TDD の三原則をプロンプトに明示する
+AI は一度にたくさん書けるため、放っておくとテストを書かずに実装し、失敗を確認せずに進み、
+テストが要求する以上の機能を先回りして実装する。ステップ計画を書かせるとき、
+「テストを書き、失敗を確認してから最小限を実装する。先回りしない」を必ず含める。
+
+### ステップ計画の置き場所
+docs/development/<project>/bolt_plan-N.md。承認前に実装を始めない。
+
+### 既存を参照させる
+- 値オブジェクト: apps/<project>/src/main/java/.../domain/
+- テストフィクスチャ: apps/<project>/src/test/java/.../fixture/
+- 命名規則: テストは「<振る舞い>_<条件>_<期待結果>」の日本語名
+AI は既存を探さず似た実装を作りやすい。新規に作る前に上記を参照させる。
+
+### 確認必須の操作
+risk_register.md の「確認必須の操作」に従う。該当ステップでは計画に注記し、実行前に停止する。
+
+### 修正の反映先
+人が AI の振る舞いを修正したら、全プロジェクト共通は CLAUDE.md、本プロジェクト固有はこのファイル、
+特定 Unit の判断は bolt_plan の「AI の仮定」欄と docs/journal/ に書く。
+```

package/lib/assets/.claude/skills/migrating-ai-dlc/scripts/aidlc_check.py

@@ -0,0 +1,372 @@
+#!/usr/bin/env python3
+"""AI-DLC 移行の適合性検査。
+
+対象プロジェクトの docs/ と CLAUDE.md、apps/、各スキルの PROJECT.md を読み、
+AI-DLC の運用に必要な成果物とガードレールが揃っているかを報告する。
+
+ERROR: 移行が完了していない（必須の成果物が無い）
+WARN : 運用の中で埋めればよい（欄の欠け、割合の不足、承認記録・索引の漏れ、成果物間の矛盾の一部）
+
+本スクリプトはファイルとキーワードの有無を見る。成果物同士の矛盾や中身の妥当性の多くは
+見ないので、SKILL.md の「スクリプトが見ない点を読んで確かめる」に従って人が読む。
+
+使い方:
+  python aidlc_check.py --project <project> [--docs docs] [--apps apps] [--claude-md CLAUDE.md] [--skills .claude/skills]
+  --project を省略すると docs/<category>/ 直下を単一プロジェクトとして検査する。
+終了コード: ERROR があれば 1、無ければ 0。
+"""
+from __future__ import annotations
+
+import argparse
+import re
+import sys
+from pathlib import Path
+
+REQUIRED_GUIDES = [
+    "AI-DLC導入ガイド.md",
+    "開発ガイド_AI-DLC版.md",
+    "リリース・イテレーション計画ガイド_AI-DLC版.md",
+    "ユースケース作成ガイド_AI-DLC版.md",
+    "コーディングとテストガイド_AI-DLC版.md",
+    "AI-DLC用語集.md",
+]
+
+UNIT_FIELDS = ["目的", "ストーリー", "NFR", "リスク", "測定基準", "推奨 Bolt", "エントロピー", "AI の仮定"]
+
+TDD_KEYWORDS = ["三原則", "Three Laws", "失敗するテスト"]
+
+FRONTEND_FILES = {"package.json"}
+FRONTEND_EXTS = {".tsx", ".jsx", ".vue", ".svelte"}
+
+NON_STORY_DOCS = {"index.md", "units.md", "risk_register.md"}
+
+
+class Report:
+    def __init__(self) -> None:
+        self.errors: list[str] = []
+        self.warns: list[str] = []
+        self.oks: list[str] = []
+
+    def error(self, msg: str) -> None:
+        self.errors.append(msg)
+
+    def warn(self, msg: str) -> None:
+        self.warns.append(msg)
+
+    def ok(self, msg: str) -> None:
+        self.oks.append(msg)
+
+    def print(self) -> None:
+        for m in self.oks:
+            print(f"OK    {m}")
+        for m in self.warns:
+            print(f"WARN  {m}")
+        for m in self.errors:
+            print(f"ERROR {m}")
+        print()
+        print(f"ERROR {len(self.errors)} / WARN {len(self.warns)}")
+
+
+def read(path: Path) -> str:
+    try:
+        return path.read_text(encoding="utf-8")
+    except (FileNotFoundError, IsADirectoryError, UnicodeDecodeError):
+        return ""
+
+
+def project_dir(base: Path, project: str | None) -> Path:
+    return base / project if project else base
+
+
+def frontmatter(text: str) -> str:
+    if not text.startswith("---"):
+        return ""
+    parts = text.split("---", 2)
+    return parts[1] if len(parts) >= 3 else ""
+
+
+def check_claude_md(rep: Report, claude_md: Path) -> None:
+    text = read(claude_md)
+    if not text:
+        rep.error(f"{claude_md}: 見つからない")
+        return
+    if "AI-DLC を採用" in text:
+        rep.ok(f"{claude_md}: AI-DLC 採用の節がある")
+    else:
+        rep.error(f"{claude_md}: 「AI-DLC を採用する」節が無い（移行ステップ 1）")
+    if "開発ガイド_AI-DLC版.md" in text:
+        rep.ok(f"{claude_md}: ペルソナが開発ガイド（AI-DLC 版）を参照している")
+    else:
+        rep.warn(f"{claude_md}: ペルソナの参照先が開発ガイド（AI-DLC 版）になっていない（移行ステップ 1）")
+
+
+def check_guides(rep: Report, docs: Path) -> None:
+    ref = docs / "reference"
+    missing = [g for g in REQUIRED_GUIDES if not (ref / g).exists()]
+    if missing:
+        rep.error(f"{ref}: AI-DLC ガイドが不足: {', '.join(missing)}（npx boost --update を先に実行する）")
+    else:
+        rep.ok(f"{ref}: AI-DLC ガイド {len(REQUIRED_GUIDES)} 本が揃っている")
+
+
+def check_migration_plan(rep: Report, docs: Path, project: str | None) -> None:
+    path = project_dir(docs / "development", project) / "aidlc_migration_plan.md"
+    if path.exists():
+        rep.ok(f"{path}: 移行計画がある")
+    else:
+        rep.warn(f"{path}: 移行計画が無い（--plan で作る）")
+
+
+def check_risk_register(rep: Report, docs: Path, project: str | None) -> None:
+    path = project_dir(docs / "requirements", project) / "risk_register.md"
+    text = read(path)
+    if not text:
+        rep.error(f"{path}: 見つからない（移行ステップ 2）")
+        return
+    rep.ok(f"{path}: ある")
+    if "In/Out" in text or "渡せる範囲" in text or "渡せない" in text:
+        rep.ok(f"{path}: AI に渡せる範囲が書かれている")
+    else:
+        rep.error(f"{path}: AI に渡せる範囲（In/Out）が書かれていない（移行ステップ 2）")
+    if "確認必須" in text:
+        rep.ok(f"{path}: 確認必須の操作が書かれている")
+    else:
+        rep.error(f"{path}: 確認必須の操作が書かれていない（移行ステップ 2）")
+
+
+def check_glossary(rep: Report, docs: Path, project: str | None) -> None:
+    ddir = project_dir(docs / "design", project)
+    candidates = (list(ddir.glob("*glossary*.md")) + list(ddir.glob("*用語集*.md"))) if ddir.exists() else []
+    if candidates:
+        rep.ok(f"{candidates[0]}: ドメイン用語集がある")
+    else:
+        rep.warn(f"{ddir}: ドメイン用語集（glossary.md）が無い（移行ステップ 3）")
+
+
+def app_dirs(apps: Path, project: str | None) -> list[Path]:
+    if not apps.exists():
+        return []
+    if project:
+        return [d for d in sorted(apps.iterdir()) if d.is_dir() and d.name.startswith(project)]
+    return [apps]
+
+
+def has_frontend(dirs: list[Path]) -> bool:
+    for d in dirs:
+        for p in d.rglob("*"):
+            if "node_modules" in p.parts:
+                return True
+            if p.is_file() and (p.name in FRONTEND_FILES or p.suffix in FRONTEND_EXTS):
+                return True
+    return False
+
+
+def check_brownfield(rep: Report, docs: Path, dirs: list[Path], project: str | None) -> None:
+    if not any(any(p.is_file() for p in d.rglob("*")) for d in dirs):
+        rep.ok("apps: コード無し（グリーンフィールド）。静的・動的モデルは不要")
+        return
+    ddir = project_dir(docs / "design", project)
+    static = (list(ddir.glob("*static*.md")) + list(ddir.glob("*静的モデル*.md"))) if ddir.exists() else []
+    dynamic = (list(ddir.glob("*dynamic*.md")) + list(ddir.glob("*動的モデル*.md"))) if ddir.exists() else []
+    if static and dynamic:
+        rep.ok(f"{ddir}: 静的モデルと動的モデルがある")
+    else:
+        rep.warn(f"{ddir}: ブラウンフィールドだが静的・動的モデルが揃っていない（移行ステップ 4）")
+
+
+def story_sections(text: str, id_pattern: re.Pattern) -> dict[str, str]:
+    """見出しにストーリー ID を含む節を ID ごとに返す。"""
+    sections: dict[str, str] = {}
+    parts = re.split(r"^(#{1,4}\s+.*)$", text, flags=re.M)
+    # parts = [前置き, 見出し1, 本文1, 見出し2, 本文2, ...]
+    for i in range(1, len(parts) - 1, 2):
+        heading, body = parts[i], parts[i + 1]
+        m = id_pattern.search(heading)
+        if m:
+            sections[m.group(0)] = sections.get(m.group(0), "") + body
+    return sections
+
+
+def check_stories(rep: Report, docs: Path, project: str | None, id_pattern: re.Pattern) -> None:
+    rdir = project_dir(docs / "requirements", project)
+    if not rdir.exists():
+        rep.warn(f"{rdir}: requirements ディレクトリが無い")
+        return
+    files = [p for p in rdir.glob("*.md") if p.name not in NON_STORY_DOCS]
+    all_ids: set[str] = set()
+    sections: dict[str, str] = {}
+    for p in files:
+        t = read(p)
+        all_ids.update(id_pattern.findall(t))
+        for k, v in story_sections(t, id_pattern).items():
+            sections[k] = sections.get(k, "") + v
+    if not all_ids:
+        rep.warn(f"{rdir}: ストーリー ID（{id_pattern.pattern}）が見つからない。--story-id で ID の形式を指定する")
+        return
+    with_ac = sorted(i for i, s in sections.items() if "受入条件" in s or "受け入れ条件" in s)
+    with_gwt = sorted(i for i in with_ac if re.search(r"Given.*When.*Then", sections[i], flags=re.S))
+    total = len(all_ids)
+    msg = f"{rdir}: ストーリー {total} 本のうち受入条件あり {len(with_ac)} 本、Given/When/Then {len(with_gwt)} 本"
+    if len(with_gwt) == total:
+        rep.ok(msg)
+    else:
+        rep.warn(msg + "（移行ステップ 5）")
+
+
+def check_units(rep: Report, docs: Path, project: str | None, id_pattern: re.Pattern) -> set[str]:
+    """units.md を検査し、未配置のストーリー ID を返す。"""
+    units = project_dir(docs / "requirements", project) / "units.md"
+    text = read(units)
+    if not text:
+        rep.error(f"{units}: 見つからない（移行ステップ 6）")
+        return set()
+    rep.ok(f"{units}: ある")
+    sections = re.split(r"^###\s+", text, flags=re.M)[1:]
+    unit_sections = [s for s in sections if re.match(r"(U-\d+|Unit)", s)]
+    if not unit_sections:
+        rep.warn(f"{units}: Unit の見出し（### U-01：…）が見つからない")
+    for s in unit_sections:
+        name = s.splitlines()[0].strip()
+        lacking = [f for f in UNIT_FIELDS if f not in s]
+        if lacking:
+            rep.warn(f"{units}: {name} に欄が欠けている: {', '.join(lacking)}（移行ステップ 6）")
+    if "依存 DAG" in text or "依存DAG" in text:
+        rep.ok(f"{units}: 依存 DAG がある")
+    else:
+        rep.warn(f"{units}: 依存 DAG が無い（移行ステップ 6）")
+    if "ストーリーマップ" in text:
+        rep.ok(f"{units}: ストーリーマップがある")
+    else:
+        rep.warn(f"{units}: ストーリーマップが無い（移行ステップ 6）")
+    unplaced: set[str] = set()
+    for line in text.splitlines():
+        if "未配置" in line:
+            unplaced.update(id_pattern.findall(line))
+    return unplaced
+
+
+def check_release_plan(rep: Report, docs: Path, project: str | None, unplaced: set[str]) -> None:
+    ddir = project_dir(docs / "development", project)
+    path = ddir / "release_plan.md"
+    text = read(path)
+    if not text:
+        rep.warn(f"{path}: 見つからない")
+        return
+    if "エントロピー" in text:
+        rep.ok(f"{path}: エントロピー評価がある")
+    else:
+        rep.warn(f"{path}: エントロピー評価が無い（移行ステップ 7）")
+    if "テスト戦略" in text:
+        rep.ok(f"{path}: テスト戦略の選択がある")
+    else:
+        rep.warn(f"{path}: テスト戦略の選択が無い（移行ステップ 7）")
+    scheduled = sorted(i for i in unplaced if re.search(re.escape(i) + r"(?!\d)", text))
+    if scheduled:
+        rep.warn(f"{path}: units.md で未配置のストーリーが計画に割り当てられている: {', '.join(scheduled)}（移行ステップ 6・7）")
+
+
+def check_bolt_plans(rep: Report, docs: Path, project: str | None) -> None:
+    ddir = project_dir(docs / "development", project)
+    plans = sorted(ddir.glob("bolt_plan-*.md")) if ddir.exists() else []
+    if not plans:
+        rep.warn(f"{ddir}: bolt_plan-N.md が無い（移行ステップ 8。進行中のイテレーションが無ければ不要）")
+        return
+    for p in plans:
+        t = read(p)
+        lacking = [label for key, label in (("仮説", "確認したい仮説"), ("ゲート", "ゲート密度")) if key not in t]
+        if lacking:
+            rep.warn(f"{p}: 欠けている: {', '.join(lacking)}（移行ステップ 8）")
+        else:
+            rep.ok(f"{p}: 仮説とゲート密度がある")
+        n = p.stem.split("-")[-1]
+        old = ddir / f"iteration_plan-{n}.md"
+        if old.exists() and "deprecated" not in frontmatter(read(old)):
+            rep.warn(f"{old}: bolt_plan-{n}.md に読み替えたが deprecated になっていない（移行ステップ 8）")
+    if not any("ウォーキングスケルトン" in read(p) for p in plans):
+        rep.warn(f"{ddir}: ウォーキングスケルトンを明記した Bolt 計画が無い（移行ステップ 8）")
+
+
+def migration_artifacts(docs: Path, project: str | None) -> list[Path]:
+    req = project_dir(docs / "requirements", project)
+    des = project_dir(docs / "design", project)
+    dev = project_dir(docs / "development", project)
+    paths = [req / "units.md", req / "risk_register.md", dev / "aidlc_migration_plan.md"]
+    if des.exists():
+        paths += list(des.glob("*glossary*.md")) + list(des.glob("*static*.md")) + list(des.glob("*dynamic*.md"))
+    if dev.exists():
+        paths += sorted(dev.glob("bolt_plan-*.md"))
+    return [p for p in paths if p.exists()]
+
+
+def check_verified_and_index(rep: Report, docs: Path, project: str | None) -> None:
+    artifacts = migration_artifacts(docs, project)
+    unverified = [p.name for p in artifacts if "verified" not in frontmatter(read(p))]
+    if not artifacts:
+        return
+    if unverified:
+        rep.warn(f"移行成果物に人の承認記録（verified）が無い: {', '.join(unverified)}（apply-okf verify）")
+    else:
+        rep.ok(f"移行成果物 {len(artifacts)} 件すべてに verified がある")
+    unindexed = []
+    for p in artifacts:
+        index = p.parent / "index.md"
+        if index.exists() and p.name not in read(index):
+            unindexed.append(f"{p.parent.name}/{p.name}")
+    if unindexed:
+        rep.warn(f"index.md に登録されていない移行成果物: {', '.join(unindexed)}（移行ステップ 10）")
+    else:
+        rep.ok("移行成果物はすべて index.md に登録されている")
+
+
+def check_guardrails(rep: Report, skills: Path, frontend: bool) -> None:
+    targets = ["developing-backend"] + (["developing-frontend"] if frontend else [])
+    if not frontend:
+        rep.ok("apps: フロントエンドが見つからないため developing-frontend は検査対象外")
+    for s in targets:
+        path = skills / s / "PROJECT.md"
+        text = read(path)
+        if not text:
+            rep.warn(f"{path}: 無い（移行ステップ 9）")
+            continue
+        if any(k in text for k in TDD_KEYWORDS):
+            rep.ok(f"{path}: TDD の三原則が書かれている")
+        else:
+            rep.warn(f"{path}: TDD の三原則が書かれていない（移行ステップ 9）")
+
+
+def main() -> int:
+    try:
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+    except Exception:  # noqa: BLE001
+        pass
+    ap = argparse.ArgumentParser(description="AI-DLC 移行の適合性検査")
+    ap.add_argument("--project", default=None, help="プロジェクト識別子（docs/<category>/<project>/ のサブディレクトリ名）")
+    ap.add_argument("--docs", default="docs", help="ドキュメントバンドルのルート（既定 docs）")
+    ap.add_argument("--apps", default="apps", help="アプリケーションのルート（既定 apps）")
+    ap.add_argument("--claude-md", default="CLAUDE.md", help="CLAUDE.md のパス")
+    ap.add_argument("--skills", default=".claude/skills", help="スキルディレクトリ")
+    ap.add_argument("--story-id", default=r"US-\d+", help="ストーリー ID の正規表現（既定 US-\\d+）")
+    args = ap.parse_args()
+
+    docs = Path(args.docs)
+    id_pattern = re.compile(args.story_id)
+    dirs = app_dirs(Path(args.apps), args.project)
+    rep = Report()
+    check_claude_md(rep, Path(args.claude_md))
+    check_guides(rep, docs)
+    check_migration_plan(rep, docs, args.project)
+    check_risk_register(rep, docs, args.project)
+    check_glossary(rep, docs, args.project)
+    check_brownfield(rep, docs, dirs, args.project)
+    check_stories(rep, docs, args.project, id_pattern)
+    unplaced = check_units(rep, docs, args.project, id_pattern)
+    check_release_plan(rep, docs, args.project, unplaced)
+    check_bolt_plans(rep, docs, args.project)
+    check_verified_and_index(rep, docs, args.project)
+    check_guardrails(rep, Path(args.skills), has_frontend(dirs))
+    rep.print()
+    return 1 if rep.errors else 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/lib/assets/CLAUDE.md

@@ -130,6 +130,7 @@ AI-DLC で守ること：
 | `creating-release-report` | リリース完了報告書作成 |
 | `creating-iteration-report` | イテレーション完了報告書作成 |
 | `migrating-okf` | プロジェクトドキュメントの OKF 知識バンドルへの移行・仕様バージョンアップ・適合性検証 |
+| `migrating-ai-dlc` | XP ベースの既存プロジェクトを AI-DLC の運用（Unit 分解・Bolt 計画・リスク台帳・ガードレール）へ移行・適合性検証 |
 | `apply-okf` | 文書の作成・更新・レビュー・廃止時に OKF 規約（フロントマター・verified・index/log）を適用 |
 | `apply-docs-structure` | ドキュメント構成ガイド（単一企業・統合戦略・複数プロジェクト）に基づく配置判断・新プロジェクトのディレクトリ一式作成・構成検証 |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k2works/claude-code-booster",
-  "version": "6.0.0",
+  "version": "6.1.0",
   "description": "AI Agent Development Support Tool",
   "main": "main.js",
   "bin": {