@k2works/claude-code-booster 5.1.0 → 6.1.0

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

@@ -12,10 +12,31 @@
 
 あなたは @docs/reference/ロジカルシンキング.md に従い論理的に考え、問題を分析し、解決策を構築します。
 
-あなたは @docs/reference/開発ガイド.md に従いソフトウェア開発を手段として問題解決に取り組みます。
+あなたは @docs/reference/開発ガイド_AI-DLC版.md に従いソフトウェア開発を手段として問題解決に取り組みます。
 
 あなたは既存のソフトウエア開発のベストプラクティスと最新の AI テクノロジーを融合させることによりソフトウエア開発にイノベーションをもたらします。
 
+## 開発方法論：AI-DLC を採用する
+
+本プロジェクトは **AI-DLC（AI-Driven Development Lifecycle）** を採用します。XP の規律（TDD・リファクタリング・シンプルな設計・小さなリリース）はそのまま残し、その上で「AI が実行し、人が監督する」構図で開発を進めます。原則と用語は `docs/reference/AI-DLC導入ガイド.md` を、各活動のガイドは次を参照してください。
+
+| 活動 | ガイド |
+| :--- | :--- |
+| 開発ライフサイクル全体 | `docs/reference/開発ガイド_AI-DLC版.md` |
+| 計画（リリース・Bolt） | `docs/reference/リリース・イテレーション計画ガイド_AI-DLC版.md` |
+| ユースケース・ユーザーストーリー | `docs/reference/ユースケース作成ガイド_AI-DLC版.md` |
+| コーディングとテスト | `docs/reference/コーディングとテストガイド_AI-DLC版.md` |
+| 用語集 | `docs/reference/AI-DLC用語集.md` |
+
+AI-DLC で守ること：
+
+- **AI が計画し、人が検証する** — 作業の前にチェックボックス付きの計画を書き、人の承認を得てから 1 ステップずつ実行する。重要な判断は勝手にしない。情報が足りなければ仮定で埋めずに質問する
+- **単位は Intent → Unit → Bolt** — Intent を疎結合な Unit に分解し、時間〜日単位の Bolt で実装する。最初の Bolt はウォーキングスケルトンにする
+- **承認ゲートは損失関数** — 「確認必須」の操作（新規ファイル作成・構造変更・外部連携・セキュリティ・データベース・本番環境）は承認ゲートとして必ず人の判断を仰ぐ
+- **TDD の三原則を変えない** — テストを書き、失敗を確認してから最小限を実装する。先回りして実装しない
+- **成果物は契約であり、コンテキストである** — ユーザーストーリーと受入条件は人と AI の契約。生成した成果物は `docs/` に永続化し、次のステップのコンテキストにする
+- **修正はガードレールにする** — 人に修正された振る舞いは `CLAUDE.md`・`PROJECT.md`・スキルに反映し、同じ修正を繰り返さない
+
 ## Skills 体系
 
 `.claude/skills/` に定義された Skills がタスクに応じて自動発動します。詳細な指示は各スキルの SKILL.md を参照してください。
@@ -109,6 +130,7 @@
 | `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/lib/assets/docs/index.md

@@ -1,37 +1,37 @@
----
-okf_version: "0.2"
----
-
-# プロジェクトドキュメント
-
-プロジェクトで管理しているドキュメントの入口です。
-
-## まずこれを読もうリスト
-
-- [戦略](./strategy/index.md) - ビジネス構造やプロジェクトの方向性を整理します。
-- [要件](./requirements/index.md) - RDRA 2.0 ベースで要件を定義します。
-- [設計](./design/index.md) - アーキテクチャ、モデル、品質方針を整理します。
-- [開発](./development/index.md) - リリース計画とイテレーション管理の入口です。
-- [運用](./operation/index.md) - 環境構築、デプロイ、運用関連の入口です。
-- [記事](./article/index.md) - 学習用の記事シリーズの入口です。
-
-## ドキュメント構成
-
-| カテゴリ | 概要                                  | 状況 |
-| :--- |:------------------------------------| :--- |
-| [戦略](./strategy/index.md) | 企業分析、経営戦略、ビジネスアーキテクチャ、インセプションデッキの整理 | `index.md` を整備済み |
-| [要件](./requirements/index.md) | RDRA 2.0 とユースケース整理の入口               | `index.md` を整備済み |
-| [設計](./design/index.md) | アーキテクチャ、モデル、テスト、非機能の整理              | `index.md` を整備済み |
-| [開発](./development/index.md) | リリース計画、イテレーション計画、進捗管理               | `index.md` を整備済み |
-| [運用](./operation/index.md) | 環境構築、デプロイ、運用手順の整理                   | `index.md` を整備済み |
-| [レビュー](./review/index.md) | 分析・開発レビュー結果の記録                      | `index.md` を整備済み |
-| [ADR](./adr/index.md) | Architecture Decision Records の管理   | `index.md` を整備済み |
-| [記事](./article/index.md) | 学習用の記事シリーズ一覧                        | `index.md` を整備済み |
-| [リファレンス](./reference/index.md) | 開発ガイドラインやベストプラクティス                  | 31 件のドキュメントを配置 |
-| [テンプレート](./template/index.md) | 各種ドキュメントの作成テンプレート                   | 18 件のテンプレートを配置 |
-
-## 補足
-
-- `strategy/`、`requirements/`、`design/`、`development/`、`operation/` は現時点ではカテゴリ索引が中心です。
-- `journal/` は作業ログ用の予約ディレクトリです。
-- `assets/` は MkDocs 用のスタイル・スクリプトを格納しています。
+---
+okf_version: "0.2"
+---
+
+# プロジェクトドキュメント
+
+プロジェクトで管理しているドキュメントの入口です。
+
+## まずこれを読もうリスト
+
+- [戦略](./strategy/index.md) - ビジネス構造やプロジェクトの方向性を整理します。
+- [要件](./requirements/index.md) - RDRA 2.0 ベースで要件を定義します。
+- [設計](./design/index.md) - アーキテクチャ、モデル、品質方針を整理します。
+- [開発](./development/index.md) - リリース計画とイテレーション管理の入口です。
+- [運用](./operation/index.md) - 環境構築、デプロイ、運用関連の入口です。
+- [記事](./article/index.md) - 学習用の記事シリーズの入口です。
+
+## ドキュメント構成
+
+| カテゴリ | 概要                                  | 状況 |
+| :--- |:------------------------------------| :--- |
+| [戦略](./strategy/index.md) | 企業分析、経営戦略、ビジネスアーキテクチャ、インセプションデッキの整理 | `index.md` を整備済み |
+| [要件](./requirements/index.md) | RDRA 2.0 とユースケース整理の入口               | `index.md` を整備済み |
+| [設計](./design/index.md) | アーキテクチャ、モデル、テスト、非機能の整理              | `index.md` を整備済み |
+| [開発](./development/index.md) | リリース計画、イテレーション計画、進捗管理               | `index.md` を整備済み |
+| [運用](./operation/index.md) | 環境構築、デプロイ、運用手順の整理                   | `index.md` を整備済み |
+| [レビュー](./review/index.md) | 分析・開発レビュー結果の記録                      | `index.md` を整備済み |
+| [ADR](./adr/index.md) | Architecture Decision Records の管理   | `index.md` を整備済み |
+| [記事](./article/index.md) | 学習用の記事シリーズ一覧                        | `index.md` を整備済み |
+| [リファレンス](./reference/index.md) | 開発ガイドラインやベストプラクティス                  | 38 件のドキュメントを配置 |
+| [テンプレート](./template/index.md) | 各種ドキュメントの作成テンプレート                   | 18 件のテンプレートを配置 |
+
+## 補足
+
+- `strategy/`、`requirements/`、`design/`、`development/`、`operation/` は現時点ではカテゴリ索引が中心です。
+- `journal/` は作業ログ用の予約ディレクトリです。
+- `assets/` は MkDocs 用のスタイル・スクリプトを格納しています。

package/lib/assets/docs/log.md

@@ -1,5 +1,20 @@
 # Docs Update Log
 
+## 2026-09-12
+* **Verification**: [AI-DLC用語集](/reference/AI-DLC用語集.md) を human:kakimomokuri が検証
+* **Verification**: [コーディングとテストガイド_AI-DLC版](/reference/コーディングとテストガイド_AI-DLC版.md) を human:kakimomokuri が検証
+* **Verification**: [ユースケース作成ガイド_AI-DLC版](/reference/ユースケース作成ガイド_AI-DLC版.md) を human:kakimomokuri が検証
+* **Verification**: [リリース・イテレーション計画ガイド_AI-DLC版](/reference/リリース・イテレーション計画ガイド_AI-DLC版.md) を human:kakimomokuri が検証
+* **Verification**: [開発ガイド_AI-DLC版](/reference/開発ガイド_AI-DLC版.md) を human:kakimomokuri が検証
+* **Verification**: [AI-DLC導入ガイド](/reference/AI-DLC導入ガイド.md) を human:kakimomokuri が検証
+* **Creation**: [AI-DLC 用語集](/reference/AI-DLC用語集.md) を新規作成。論文・参照実装・本プロジェクトの AI-DLC 版ガイドの用語を 6 区分で定義し、XP・Scrum との対応表と参照先を追加。`CLAUDE.md` の参照表にも登録。
+* **Creation**: [開発ガイド（AI-DLC 版）](/reference/開発ガイド_AI-DLC版.md) を新規作成。XP 版の開発ライフサイクル（分析・開発・運用・構築・配置）を AI-DLC の 3 フェーズで読み替え、各活動で AI が生成し人が検証するものを定義。AI-DLC 版ガイド 4 本と XP 版ガイドの対応表を追加。あわせて `CLAUDE.md` に AI-DLC を採用する旨と守るべき 6 原則を明記し、ペルソナの参照先を開発ガイド（AI-DLC 版）に変更。
+* **Creation**: [コーディングとテストガイド（AI-DLC 版）](/reference/コーディングとテストガイド_AI-DLC版.md) を新規作成。XP 版の章構成を保ちながら、TDD の三原則を AI に守らせる Bolt 開発フロー、承認ゲートの密度選択、AI 向けのアプローチ指示、ステップ計画、Red/Green/Refactor 各フェーズの人の検証観点、AI 生成コード固有の品質観点、ソース束縛レビュー、テスト戦略の水準、ガードレール化、quick-cement としての技術的負債、開発スキルの読み替え表を定義。
+* **Creation**: [ユースケース作成ガイド（AI-DLC 版）](/reference/ユースケース作成ガイド_AI-DLC版.md) を新規作成。XP 版の章構成を保ちながら、Mob Elaboration によるユースケース作成手順、12 ステップの AI と人の分担、トレーサビリティ項目を加えたテンプレート、セマンティクス密度、AI 生成ユースケースの検証観点、ブラウンフィールドのリバースエンジニアリング、プロンプトパターン、分析スキルの読み替え表を定義。
+* **Creation**: [リリース・イテレーション計画ガイド（AI-DLC 版）](/reference/リリース・イテレーション計画ガイド_AI-DLC版.md) を新規作成。XP 版の章構成を保ちながら、Intent → Unit → Bolt の計画階層、承認駆動の Bolt 計画、エントロピー評価による見積もり、完了 Unit 数・ゲート通過数・リードタイムによる進捗管理、リスク台帳、Bolt 終了報告テンプレート、計画スキルの読み替え表を定義。
+* **Update**: [AI-DLC 導入ガイド](/reference/AI-DLC導入ガイド.md) を一次情報（Method Definition Paper・aidlc-workflows ユーザーガイド）で精査し拡充。10 の基本原則、成果物定義（Intent・Unit・Bolt・Domain/Logical Design・Deployment Unit）、Inception の 6 成果物、グリーンフィールド／ブラウンフィールド実践例、付録 A のプロンプトパターン、参照実装の 5 フェーズ 33 ステージ・スコープ・エージェント・承認ゲート・監査ログ、33 ステージと Skills の対応表を追加。
+* **Creation**: [AI-DLC 導入ガイド](/reference/AI-DLC導入ガイド.md) を新規作成。AI-DLC の概要・コア原則・3 フェーズ・ベストプラクティスを整理し、XP と Skills 体系への対応表と段階的な導入ステップを定義。
+
 ## 2026-08-26
 * **Verification**: [ドキュメント構成ガイド](/reference/ドキュメント構成ガイド.md) を human:kakimomokuri が検証
 * **Update**: ドキュメント構成ガイドを更新。docs/review を共通からプロジェクト別カテゴリに変更（プロジェクト別は 7 カテゴリに）。