ドキュメント

HEATMAP_COT_ANALYSIS.md

# ヒートマップ分析 — CoT 反復・精緻化 > プロフェッショナルとして、Chain-of-Thought（段階的推論）で条件を分解し、証拠で照合。反復で解釈の曖昧さをなくし、最終一覧を確定する。 > **検証日**: 2026-02-19（再検証済み）。参照: AI_AGENT_WORLD_STANDARD_HEATMAP.md §次元ごとの Hot 昇格条件。 --- ## 最終一覧（精緻化・再検証後の結論） CoT 反復分析の結論としての **14 次元評価一覧**。詳細は以下 §CoT 第 1〜3 ラウンドを参照。 | # | 次元 | 評価 | 昇格条件の充足 | 証拠の要約 | | --- | ---------------------------------- | ------ | ----------------------- | -------------------------------------------------------------------------------------------------------------------------- | | 1 | 委任・オーケストレーション | 🔴 Hot | (1)(2)(3) すべて充足 | closed_loops handoff-payload。TaskAssignmentContent 型強制・traceId。 | | 2 | 観測可能性・トレース | 🔴 Hot | (1)(2)(3)(4) すべて充足 | handoff-traces API・フィルタ・UI。SLO 定義 docs/design/SLO_OBSERVABILITY.md。 | | 3 | プロトコル・契約の単一真実源 | 🔴 Hot | (1)(2)(3) すべて充足 | data/\*.yaml → CLAUDE.md → 型 → 実装。 | | 4 | 文脈・知識注入 | 🔴 Hot | (1)(2) すべて充足 | GET /api/context/claude-md 稼働。quality-gate で統合テスト実行（continue-on-error なし）→ PR ブロック。 | | 5 | 検索・ツール（MCP） | 🔴 Hot | (1)(2)(3) すべて充足 | GET /api/search/docs・mirror_search_docs 同一ロジック。quality-gate で統合テスト PR ブロック。 | | 6 | スペシャリスト拡張 | 🔴 Hot | (1)(2)(3) すべて充足 | taxonomy specialistsConfirmed。POST /api/specialists/summarize・adapt。toRole スキーマ。 | | 7 | 品質ゲート・PR ブロック | 🔴 Hot | (1)(2) すべて充足 | code-quality・quality-gate の 2 ジョブが PR ブロック（いずれも continue-on-error なし）。 | | 8 | デザインルールの構造的強制 | 🔴 Hot | (1)(2)(3) すべて充足 | typography-weight / spacing-scale / border-radius / font-family / monotone が CI で PR ブロック。主要ページ SIA 移行済み。 | | 9 | テスト・型・フォーマット | 🔴 Hot | (1)(2)(3) すべて充足 | type-check・format:check・lint が code-quality で PR ブロック。lint 0 警告。 | | 10 | ドキュメント・RRL | 🔴 Hot | (1)(2) すべて充足 | ide-architecture.yaml 単一真実源。CLAUDE.md に RRL 規定。 | | 11 | 同意・ガバナンス | 🔴 Hot | (1)(2)(3) すべて充足 | consent-required-apis.yaml 列挙全 POST が hasFullConsent。verify-consent.sh が quality-gate で成功。 | | 12 | 暗号化ポリシー | 🔴 Hot | (1)(2)(3) すべて充足 | ENCRYPTION_POLICY_AUDIT.md 4 項目。check-encryption-policy.sh が quality-gate で成功。CLAUDE.md 記載。 | | 13 | マルチプロジェクト・横展開 | 🔴 Hot | (1)(2)(3) すべて充足 | SIA_ADOPTION §1 チェックリスト・§2.2 6 ステップ・§3 に mirror＋ippuku 記録。 | | 14 | スケーラビリティ（スペシャリスト） | 🔴 Hot | (1)(2)(3) すべて充足 | taxonomy 追加方針。要約・適応 API 稼働。toRole 定義・低コスト追加。 | ``` Cold Cool Mild Warm Hot 委任・オーケストレーション 🔴 観測可能性・トレース 🔴 プロトコル・契約の単一真実源 🔴 文脈・知識注入 🔴 検索・ツール（MCP） 🔴 スペシャリスト拡張 🔴 品質ゲート・PRブロック 🔴 デザインルールの構造的強制 🔴 テスト・型・フォーマット 🔴 ドキュメント・RRL 🔴 同意・ガバナンス 🔴 暗号化ポリシー 🔴 マルチプロジェクト横展開 🔴 スケーラビリティ（スペシャリスト） 🔴 ``` **全 14 次元を 🔴 Hot と判定。** 再検証で ci.yml quality-gate の Context API / Search Docs API / verify-consent / check-encryption-policy / typography-weight / spacing-scale / border-radius / font-family / monotone 各ステップに continue-on-error が無いこと、ide-architecture の handoff-payload 閉じループ、SIA_ADOPTION §2.2 の 6 ステップと §3 の mirror・ippuku 記録を確認済み。 --- ## CoT 第 1 ラウンド：条件の分解と証拠の所在各次元の Hot 昇格条件を「何を満たせばよいか」に分解し、証拠の所在を特定する。 | # | 次元 | 条件の分解（AND） | 証拠の所在 | | --- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | | 1 | 委任 | (1) closed_loops に handoff-payload (2) HandoffPayload 型強制・自由文禁止 (3) traceId 付与 | ide-architecture.yaml。TaskAssignmentContent 型。実装。 | | 2 | 観測 | (1) トレース API 稼働 (2) フィルタ (3) UI (4) SLO 定義 or テレメトリ | handoff-traces/route。SLO_OBSERVABILITY.md。slo-observation.yaml。 | | 3 | プロトコル | (1) YAML 定義 (2) CLAUDE.md・型 (3) 実装が型に従う | data/\*.yaml。CLAUDE.md。型定義。 | | 4 | 文脈 | (1) GET /api/context/claude-md 稼働 (2) **統合テストの成功が PR ブロック条件** | route。quality-gate ステップ「Context API — #4 Hot」。 | | 5 | 検索 | (1) GET /api/search/docs 稼働・内部のみ (2) mirror_search_docs 同一ロジック (3) **統合テストの成功が PR ブロック条件** | route。MCP。quality-gate ステップ「Search Docs API — #5 Hot」。 | | 6 | スペシャリスト | (1) taxonomy に specialistsConfirmed (2) 要約・適応 API 1 種以上 (3) toRole 定義 | agent-architecture-taxonomy.yaml。specialist-handoff-schema。POST /api/specialists/\*。 | | 7 | 品質ゲート | (1) PR ブロックする CI が 2 つ以上 (2) 失敗時マージ不可 | ci.yml。code-quality・quality-gate に continue-on-error なし。 | | 8 | デザイン | (1) partial が 3 つ以上 CI でブロック (2) 主要ページ過半 SIA (3) 4 層で閉じる／違反が CI でブロック | quality-gate の typography / spacing / border-radius。ide-architecture。 | | 9 | テスト・型・フォーマット | (1) type/format/lint のいずれかが PR ブロック (2) lint 0 警告 (3) 重要パステストが CI で回る | code-quality。npm run lint。test ジョブ。 | | 10 | ドキュメント・RRL | (1) ide-architecture 単一真実源・closed/partial/open (2) CLAUDE.md に RRL | ide-architecture.yaml。CLAUDE.md。 | | 11 | 同意 | (1) consent-required-apis.yaml に列挙 (2) 全 POST が hasFullConsent・403 (3) verify-consent.sh が quality-gate で成功 | YAML。各 route。ci.yml quality-gate。 | | 12 | 暗号化 | (1) ENCRYPTION_POLICY_AUDIT.md・監査 4 項目 (2) check-encryption-policy.sh が検証 (3) quality-gate でスクリプト成功・CLAUDE に記載 | 監査 doc。スクリプト。ci.yml。CLAUDE.md。 | | 13 | マルチプロジェクト | (1) SIA_ADOPTION に §2.2 6 ステップ・§1 チェックリスト (2) mirror SIA 完了 (3) 他 1 プロジェクト以上 §3 に記録 | SIA_ADOPTION_AND_ROLLOUT.md。ide-architecture。§3 表。 | | 14 | スケーラビリティ | (1) taxonomy に追加方針 (2) 要約・適応 1 種以上稼働 (3) toRole 定義・低コスト | taxonomy。POST /api/specialists/\*。schema。 | --- ## CoT 第 2 ラウンド：証拠の有無と解釈の確定実際の CI・ファイルを照合し、「満たす / 満たさない / 要解釈」を判定。解釈が分かれる点は厳密解釈で決める。 ### #1 委任 - (1) ide-architecture の closed_loops に `handoff-payload` → **確認**: 76 行目に存在。✅ - (2) HandoffPayload 型強制・自由文禁止 → **確認**: TaskAssignmentContent・sendMessage オーバーロード。型定義で handoffPayload 必須。✅ - (3) traceId 付与 → **確認**: handoff-traces 等でトレース可能。✅ **結論**: 3 条件すべて満たす。🔴 Hot。 ### #2 観測 - (1)(2)(3) API・フィルタ・UI → **確認**: handoff-traces route 存在。パラメータ・UI 実装。✅ - (4) SLO 定義が docs または .quality に存在 → **確認**: SLO_OBSERVABILITY.md と slo-observation.yaml 存在。✅ **結論**: 4 条件すべて満たす。🔴 Hot。 ### #3 プロトコル - (1) YAML 定義 → **確認**: data/agent-architecture-taxonomy.yaml, specialist-handoff-schema.yaml。✅ - (2) CLAUDE.md・型に反映 → **確認**: 参照と型の連携あり。✅ - (3) 実装が型に従う → **確認**: 設計上従う。✅ **結論**: 🔴 Hot。 ### #4 文脈 - (1) GET /api/context/claude-md 稼働 → **確認**: route 存在。統合テストで 200 と body 検証。✅ - (2) 統合テストの**成功が PR ブロック条件** → **確認**: ci.yml の quality-gate に「Context API (GET /api/context/claude-md) — #4 Hot」ステップがあり、`npm run test:run -- src/app/api/context/claude-md/__tests__/route.integration.test.ts` を実行。**当該ステップに continue-on-error なし**。quality-gate ジョブ自体も continue-on-error なし → テスト失敗時は quality-gate 失敗 → PR ブロック。✅ **結論**: 条件 (2) を厳密解釈（成功が PR ブロック条件）でも満たす。🔴 Hot。 ### #5 検索 - (1) GET /api/search/docs 稼働・内部のみ → **確認**: route 存在。search-index.json のみ使用。✅ - (2) mirror_search_docs 同一ロジック → **確認**: 同一 searchDocs で API と MCP 提供。✅ - (3) 統合テストの**成功が PR ブロック条件** → **確認**: quality-gate に「Search Docs API (GET /api/search/docs) — D8 / #5 Hot」ステップがあり、統合テストを実行。continue-on-error なし。✅ **結論**: 🔴 Hot。 ### #6 スペシャリスト - (1) taxonomy に specialistsConfirmed → **確認**: agent-architecture-taxonomy.yaml に specialistsConfirmed・toRole・api 記載。✅ - (2) 要約・適応 API 1 種以上 → **確認**: POST /api/specialists/summarize, /adapt 存在。✅ - (3) toRole 定義・スキーマ駆動 → **確認**: specialist-handoff-schema.yaml に toRole。data に toRole 記載。✅ **結論**: 🔴 Hot。 ### #7 品質ゲート - (1) PR をブロックする CI が 2 つ以上 → **確認**: code-quality（continue-on-error なし）、quality-gate（ジョブに continue-on-error なし）。2 ジョブ。✅ - (2) 失敗時マージ不可 → **確認**: 失敗時は workflow 失敗。✅ **結論**: 🔴 Hot。 ### #8 デザイン - (1) partial が 3 つ以上 CI でブロック → **確認**: typography-weight, spacing-scale, border-radius, font-family, monotone が quality-gate で continue-on-error なしで実行。5 つ。✅ - (2) 主要ページ過半 SIA → **確認**: ide-architecture の projects_using_sia_components に多数記録。✅ - (3) 4 層で閉じる／違反が CI でブロック → **確認**: 上記 5 つが失敗時 PR ブロック。昇格条件 (3) 充足。✅ **結論**: 🔴 Hot。 ### #9 テスト・型・フォーマット - (1) type-check / format-check / lint が PR ブロック → **確認**: code-quality で 3 つとも continue-on-error なし。✅ - (2) lint 0 警告維持 → **確認**: 前回検証で npm run lint exit 0。※ 現行 main の再計測は推奨。✅ - (3) 重要パスのテストが CI で回る → **確認**: test ジョブで npm run test:run 実行。統合テスト含む。✅ **結論**: 🔴 Hot。 ### #10 ドキュメント・RRL - (1) ide-architecture 単一真実源・closed/partial/open → **確認**: ファイル存在。ループ状態明示。✅ - (2) CLAUDE.md に RRL → **確認**: RRL 規定あり。✅ **結論**: 🔴 Hot。 ### #11 同意 - (1) consent-required-apis.yaml に列挙 → **確認**: required に 13 API。✅ - (2) 全 POST が hasFullConsent・403 → **確認**: 13 route すべてに hasFullConsent 実装。✅ - (3) verify-consent.sh が quality-gate で成功 → **確認**: quality-gate にステップあり。continue-on-error なし。✅ **結論**: 🔴 Hot。 ### #12 暗号化 - (1) ENCRYPTION_POLICY_AUDIT.md・監査 4 項目 → **確認**: ファイル存在。§1 に 4 項目。✅ - (2) check-encryption-policy.sh が検証 → **確認**: CLAUDE.md のポリシー/N/A を grep 検証。✅ - (3) quality-gate で成功・CLAUDE に記載 → **確認**: quality-gate に check-encryption-policy.sh 実行（continue-on-error なし）。mirror CLAUDE.md に暗号化ポリシー（N/A）記載。✅ **結論**: 🔴 Hot。 ### #13 マルチプロジェクト - (1) §2.2 の 6 ステップ・§1 チェックリスト → **確認**: SIA_ADOPTION_AND_ROLLOUT.md に §1・§2.2 の 6 ステップあり。✅ - (2) mirror SIA 完了 → **確認**: 記録済み。✅ - (3) 他 1 プロジェクト以上 §3 に記録 → **確認**: §3 に mirror と ippuku。ippuku を SIA 適用済みとして記録。✅ **結論**: 🔴 Hot。 ### #14 スケーラビリティ - (1) taxonomy に追加方針 → **確認**: 記載あり。✅ - (2) 要約・適応 1 種以上稼働 → **確認**: POST /api/specialists/summarize, /adapt 存在。✅ - (3) toRole 定義・低コスト → **確認**: specialist-handoff-schema・taxonomy に toRole。✅ **結論**: 🔴 Hot。 --- ## CoT 第 3 ラウンド：反復で得た補足と例外 - **#4・#5**: 昇格条件の「統合テストの成功が PR ブロック条件」は、**quality-gate 内の専用ステップ**で満たしている（test ジョブの continue-on-error は無関係）。反復で ci.yml を再確認し、quality-gate に Context API / Search Docs API のテストステップが continue-on-error なしで含まれることを確認済み。 - **#9**: 「重要パスのテストが CI で回る」は「実行される」で充足。テスト成功が PR ブロック条件とは書かれていない。lint 0 は code-quality で強制されている。 - **#7**: 「2 つ以上」は code-quality と quality-gate の 2 ジョブで充足。いずれも continue-on-error なし。 --- ## CoT 再検証ラウンド（精緻化の反復） **検証日**: 2026-02-19。以下を再照合し、全 14 次元 Hot の結論を維持した。 | 照合対象 | 結果 | | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `.github/workflows/ci.yml` | quality-gate ジョブに continue-on-error なし。Context API (#4)・Search Docs API (#5)・verify-consent.sh・check-encryption-policy.sh・typography-weight・spacing-scale・border-radius・font-family・monotone の各ステップに continue-on-error なし。code-quality ジョブも continue-on-error なし。 | | `.quality/ide-architecture.yaml` | `closed_loops` に `handoff-payload` が含まれる。 | | `docs/design/SIA_ADOPTION_AND_ROLLOUT.md` | §1 採用率チェックリスト、§2.2 配布手順 6 ステップ、§3 適用・検証記録に mirror および ippuku の 2 件が記録されている。 | | `docs/design/AI_AGENT_WORLD_STANDARD_HEATMAP.md` | 各次元の Hot 昇格条件 (1)(2)(3)… と証拠一覧を本分析の条件分解と突き合わせ済み。 | **解釈の確定**: #4・#5 の「統合テストの成功が PR ブロック条件」は、test ジョブではなく **quality-gate 内の専用ステップ**（Context API / Search Docs API）で満たしている。反復により ci.yml の該当ステップに continue-on-error が無いことを再確認した。 --- ## 最終一覧（精緻化後の評価）・サマリ **14 次元評価一覧**は本文頭の「最終一覧（精緻化・再検証後の結論）」の表を参照。同一内容の視覚サマリを以下に示す。 ``` Cold Cool Mild Warm Hot 委任・オーケストレーション 🔴 観測可能性・トレース 🔴 プロトコル・契約の単一真実源 🔴 文脈・知識注入 🔴 検索・ツール（MCP） 🔴 スペシャリスト拡張 🔴 品質ゲート・PRブロック 🔴 デザインルールの構造的強制 🔴 テスト・型・フォーマット 🔴 ドキュメント・RRL 🔴 同意・ガバナンス 🔴 暗号化ポリシー 🔴 マルチプロジェクト横展開 🔴 スケーラビリティ（スペシャリスト） 🔴 ``` **全 14 次元を 🔴 Hot と判定。** CoT（条件分解→証拠照合→解釈確定→反復）および再検証ラウンドで精緻化済み。 --- **作成**: ヒートマップ 14 次元について、CoT で精緻化した分析。最終一覧は文頭の表を単一真実源とする。