@yohakuforce/core 0.4.0

package/dist/sarif/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/sarif/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,eAAe,CAAC,6BAA6B,IAAI,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,eAAe,CAAC,+BAAgC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC7D,MAAM,GAAG,GAAG,MAAkB,CAAC;IAC/B,MAAM,QAAQ,GAAwB,EAAE,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC;QACpC,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC3C,IAAI,OAAO,KAAK,SAAS;gBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CACnB,MAAmB,EACnB,IAAwB;IAExB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,cAAc,CAAC;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;SACvC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,CAAC;SACzD,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IACrD,OAAO;QACL,MAAM;QACN,KAAK;QACL,OAAO;QACP,SAAS;QACT,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC"}

package/dist/sarif/types.d.ts

@@ -0,0 +1,43 @@
+export type SarifLevel = "none" | "note" | "warning" | "error";
+export interface SarifMessage {
+    readonly text?: string;
+}
+export interface SarifLocation {
+    readonly physicalLocation?: {
+        readonly artifactLocation?: {
+            readonly uri?: string;
+        };
+        readonly region?: {
+            readonly startLine?: number;
+            readonly endLine?: number;
+        };
+    };
+}
+export interface SarifResult {
+    readonly ruleId?: string;
+    readonly level?: SarifLevel;
+    readonly message?: SarifMessage;
+    readonly locations?: readonly SarifLocation[];
+}
+export interface SarifRun {
+    readonly results?: readonly SarifResult[];
+    readonly tool?: {
+        readonly driver?: {
+            readonly name?: string;
+        };
+    };
+}
+export interface SarifLog {
+    readonly version?: string;
+    readonly $schema?: string;
+    readonly runs?: readonly SarifRun[];
+}
+/** 本 OSS 内部表現 (change-summary 互換) */
+export interface NormalizedFinding {
+    readonly ruleId: string;
+    readonly level: SarifLevel;
+    readonly message: string;
+    readonly locations: readonly string[];
+    readonly tool?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sarif/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sarif/types.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE;QAC1B,QAAQ,CAAC,gBAAgB,CAAC,EAAE;YAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;SACvB,CAAC;QACF,QAAQ,CAAC,MAAM,CAAC,EAAE;YAChB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;YAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;SAC3B,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE;QACd,QAAQ,CAAC,MAAM,CAAC,EAAE;YAChB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;SACxB,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CACrC;AAED,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/sarif/types.js

@@ -0,0 +1,4 @@
+// SARIF 2.1.0 のうち Code Analyzer v5 が出力する範囲のサブセット
+// 仕様: https://docs.oasis-open.org/sarif/sarif/v2.1.0/
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sarif/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sarif/types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,sDAAsD"}

package/dist/scaffold/.agents/README.md

@@ -0,0 +1,12 @@
+# scaffold/.agents/ — 利用者プロジェクト用ナレッジ基盤ひな型
+
+`yohaku init` で利用者プロジェクトの `.agents/` として展開される。利用者プロジェクトでも自律ループのナレッジ蓄積機構が動くように、空の INDEX とテンプレートを用意する。
+
+| サブディレクトリ | 構築 Phase | 内容 |
+|---|---|---|
+| `knowledge/INDEX.md` | Phase 2 | 利用者プロジェクト用の空索引（カテゴリ見出しのみ） |
+| `knowledge/README.md` | Phase 2 | 利用者向けのナレッジ運用ガイド |
+| `knowledge/{decisions,pitfalls,wins,improvements,retrospectives}/.gitkeep` | Phase 2 | 空ディレクトリ保持 |
+| `templates/*.md` | Phase 2 | decision / pitfall / win / improvement / retrospective のひな型 |
+
+メタ層 `/.agents/` (本リポジトリ開発のナレッジ) と混同しないこと。

package/dist/scaffold/.agents/knowledge/INDEX.md

@@ -0,0 +1,52 @@
+# Knowledge Index
+
+> このプロジェクトの AI 自律ループが蓄積する知見の索引。
+> 新しいエントリを追加したら、必ずこの INDEX に **1 行サマリ** を追記すること。
+
+詳細運用は [`AGENTS.md`](../../AGENTS.md) § 2. ナレッジ蓄積ルールを参照。
+
+---
+
+## 使い方
+
+新しいタスクに着手する前に、関連カテゴリの一覧をスキャンする。
+
+| カテゴリ | 入口 | 何を見るか |
+|---|---|---|
+| Decisions | [`decisions/`](./decisions/) | 過去の設計判断・トレードオフ・採用理由 |
+| Pitfalls | [`pitfalls/`](./pitfalls/) | 既知のつまずき・不具合・誤解しやすい点 |
+| Wins | [`wins/`](./wins/) | 効いたパターン・再利用したい工夫 |
+| Improvements | [`improvements/`](./improvements/) | 改善した点・次に試したい改善 |
+| Retrospectives | [`retrospectives/`](./retrospectives/) | サイクル単位の振り返り (時系列) |
+
+---
+
+## Decisions
+
+<!-- 新規追加時はこの下に `- [YYYY-MM-DD: タイトル](decisions/file.md) — 1 行サマリ` を追加 -->
+
+(まだエントリなし)
+
+---
+
+## Pitfalls
+
+(まだエントリなし)
+
+---
+
+## Wins
+
+(まだエントリなし)
+
+---
+
+## Improvements
+
+(まだエントリなし)
+
+---
+
+## Retrospectives
+
+(まだエントリなし)

package/dist/scaffold/.agents/knowledge/README.md

@@ -0,0 +1,29 @@
+# .agents/knowledge — ナレッジベース
+
+このディレクトリは、AI 自律ループが蓄積する知見の保管場所。
+**AI は新しいタスクの開始時に必ずここを参照し、サイクル末に必ずここへ書き戻す。**
+
+詳細は [`AGENTS.md`](../../AGENTS.md) § 2. ナレッジ蓄積ルールを参照。
+
+## 構成
+
+```
+.agents/knowledge/
+├── INDEX.md             ← まずここを見る (索引)
+├── decisions/           ← 設計判断・採用理由
+├── pitfalls/            ← つまずき・不具合
+├── wins/                ← 効いた工夫
+├── improvements/        ← 改善した点・改善案
+└── retrospectives/      ← サイクル単位の振り返り
+```
+
+## 書き方
+
+`.agents/templates/` のテンプレートに従う。
+ファイル名は `YYYY-MM-DD-<short-slug>.md`。
+
+## 重要原則
+
+- **古い知見は削除しない**: `Status: Superseded by ...` を冒頭に追記して残す
+- **新規追加時は INDEX.md に 1 行サマリを必ず追加する**
+- **個人情報・顧客情報・顧客固有ロジックを書かない**

package/dist/scaffold/.agents/templates/README.md

@@ -0,0 +1,19 @@
+# .agents/templates
+
+ナレッジエントリの雛形集。`.agents/knowledge/` にファイルを追加する際は、必ずここのテンプレートをコピーして使う。
+
+| テンプレート | 用途 |
+|---|---|
+| [`decision.md`](./decision.md) | 設計判断・採用理由 |
+| [`pitfall.md`](./pitfall.md) | つまずき・不具合 |
+| [`win.md`](./win.md) | 効いた工夫 |
+| [`improvement.md`](./improvement.md) | 改善した点・改善案 |
+| [`retrospective.md`](./retrospective.md) | サイクル振り返り |
+
+## 使い方
+
+```bash
+# 例: 新しい設計判断を記録
+cp .agents/templates/decision.md .agents/knowledge/decisions/2026-05-06-eta-template-engine.md
+# → 中身を編集し、INDEX.md に 1 行追加
+```

package/dist/scaffold/.agents/templates/decision.md

@@ -0,0 +1,39 @@
+---
+type: decision
+date: YYYY-MM-DD
+title: <短いタイトル>
+status: active  # active | superseded
+supersedes: <旧ファイル名 または 空>
+superseded_by: <新ファイル名 または 空>
+tags: [phase-1, architecture]  # 任意
+---
+
+# <タイトル>
+
+## 判断
+
+<採用した結論を一文で>
+
+## 文脈
+
+<なぜこの判断が必要になったか。前提・制約・依頼の経緯>
+
+## 代替案
+
+| 案 | 採否 | 理由 |
+|---|---|---|
+| A. <案A>  | 採用 | <理由> |
+| B. <案B>  | 却下 | <理由> |
+| C. <案C>  | 却下 | <理由> |
+
+## トレードオフ
+
+<採用案で諦めたもの・将来に持ち越した懸念>
+
+## 影響範囲
+
+<コード・ドキュメント・運用への影響>
+
+## 関連ナレッジ
+
+- <関連する pitfalls / wins / improvements / decisions へのリンク>

package/dist/scaffold/.agents/templates/improvement.md

@@ -0,0 +1,33 @@
+---
+type: improvement
+date: YYYY-MM-DD
+title: <短いタイトル>
+status: applied  # idea | planned | applied
+tags: [phase-1, dx]  # 任意
+---
+
+# <タイトル>
+
+## Before
+
+<改善前の状態。何が辛かったか>
+
+## After
+
+<改善後の状態。何が良くなったか>
+
+## 変更内容
+
+<実施した具体的変更 (コード・設定・運用)>
+
+## 効果測定
+
+<効果の根拠。定量データがあれば数字、無ければ定性的観察>
+
+## 次の改善案
+
+<さらに改善できそうなポイント>
+
+## 関連ナレッジ
+
+- <関連リンク>

package/dist/scaffold/.agents/templates/pitfall.md

@@ -0,0 +1,33 @@
+---
+type: pitfall
+date: YYYY-MM-DD
+title: <短いタイトル>
+severity: high  # critical | high | medium | low
+tags: [phase-1, sqlite]  # 任意
+---
+
+# <タイトル>
+
+## 何が起きたか
+
+<観測された事象を事実ベースで>
+
+## 根本原因
+
+<なぜそれが起きたか。表層原因ではなく根本原因>
+
+## どう気づいたか
+
+<検出経路。テスト/レビュー/ユーザ報告など>
+
+## 回避策・修正
+
+<具体的なコード・設定・手順>
+
+## 再発防止
+
+<同じワナに二度と落ちないための仕組み (テスト追加 / hooks / lint / ドキュメント)>
+
+## 関連ナレッジ
+
+- <関連リンク>

package/dist/scaffold/.agents/templates/retrospective.md

@@ -0,0 +1,61 @@
+---
+type: retrospective
+date: YYYY-MM-DD
+cycle: <サイクル名 / 機能名>
+phase: <Phase 1〜7>
+tags: []
+---
+
+# Retrospective: <サイクル名>
+
+## サイクル要約
+
+<このサイクルで取り組んだこと・成果を 3〜5 行で>
+
+## 1. 要件整理 — 学び
+
+<何が見えたか・何を見落としそうだったか>
+
+## 2. 計画立案 — 学び
+
+<採用した判断・代替案を退けた理由 (詳細は decisions/ にリンク)>
+
+## 3. 実行 — 学び
+
+<実装中の発見・つまずき (詳細は pitfalls/ にリンク)>
+
+## 4. レビュー — 学び
+
+<指摘の傾向・効いたチェック>
+
+## 5. 修正・再実装 — 学び
+
+<手戻りの量・原因・予防策>
+
+## 6. 整理 — 学び
+
+<削れたもの・命名見直し・ドキュメント整合>
+
+## 7. 課題提起 — 次サイクルへの種
+
+- [ ] <次サイクルで扱うべき課題1>
+- [ ] <次サイクルで扱うべき課題2>
+
+## 良かった点 (Keep)
+
+- <継続したいこと>
+
+## 課題 (Problem)
+
+- <改善したいこと>
+
+## 試したいこと (Try)
+
+- <次回試したい工夫>
+
+## 蓄積された関連ナレッジ
+
+- decisions: <list>
+- pitfalls: <list>
+- wins: <list>
+- improvements: <list>

package/dist/scaffold/.agents/templates/win.md

@@ -0,0 +1,28 @@
+---
+type: win
+date: YYYY-MM-DD
+title: <短いタイトル>
+tags: [phase-1, performance]  # 任意
+---
+
+# <タイトル>
+
+## 何が効いたか
+
+<採用した工夫・パターンを一文で>
+
+## なぜ効いたか
+
+<根拠。パフォーマンス測定、コード可読性、保守性、再現性、など>
+
+## 適用条件
+
+<このパターンが効く前提・適さないケース>
+
+## 再利用方法
+
+<別の場所で同じパターンを使うときのチェックリスト・コード例>
+
+## 関連ナレッジ
+
+- <関連リンク>

package/dist/scaffold/.claude/README.md

@@ -0,0 +1,11 @@
+# scaffold/.claude/ — 利用者プロジェクト用 Claude Code 設定ひな型
+
+`yohaku init` で利用者プロジェクトの `.claude/` として展開される。
+
+| サブディレクトリ | 構築 Phase | 内容 |
+|---|---|---|
+| `commands/` | Phase 2〜5 | `/onboard` `/impact` `/explain` `/classify-diff` `/release-prep` `/manual-steps` 等 |
+| `agents/` | Phase 2〜5 | graph-querier, object-documenter, onboarding-guide, data-model-classifier, manual-step-extractor 等 |
+| `settings.json` | Phase 2 | hooks (`PostToolUse(force-app/**)` → `yohaku graph build --incremental`)、権限 |
+
+メタ層 `/.claude/` (本リポジトリの開発時 Claude Code 設定) と混同しないこと。

package/dist/scaffold/.claude/agents/apex-query-tracer.md.eta

@@ -0,0 +1,199 @@
+---
+name: apex-query-tracer
+description: <%= it.projectName %> の Apex コードを静的解析し、SOQL クエリと DML を A/B/C/D に分類してカウントする。`/analyze-batch-limits` から起動される。
+tools: Read, Bash, Glob, Grep
+model: sonnet
+---
+
+あなたは <%= it.projectName %> プロジェクトの **Apex ガバナ制限静的解析エージェント** です。
+
+## 責務
+
+指定された Apex クラス群を読み込み、**SOQL クエリ数** と **DML ステートメント数** の両方を
+以下の分類でカウントする。カスケードチェーンの1レベル分を担当する。
+
+## SOQL クエリの4分類
+
+```
+分類A: ゼロカウント（ガバナ制限に算入しない）
+  ・FROM __mdt のクエリ（Long Text Area フィールドを含まない場合）
+  ・CustomSetting__c.getInstance() / getValues() 静的アクセス
+  ・__mdt.getAll() / .getInstance() 静的アクセス
+
+分類B: 固定カウント（バッチサイズ非依存、ガバナ制限に算入）
+  ・WHERE Id IN :triggerIds / WHERE Id IN :idSet パターン
+  ・ループ外の通常オブジェクトクエリ
+  ・静的キャッシュあり（static Map でキャッシュされ、2回目以降はクエリ不要）→ 条件付きB
+
+分類C: 変動カウント（バッチサイズ N に比例）
+  ・for (SObject o : Trigger.new) 内の SOQL
+  ・1件引数のメソッドをループから呼ぶパターン
+
+分類D: 紐づき比例カウント（関連レコード M に比例）
+  ・ネストループの内側（外ループ=トリガレコード、内ループ=関連レコード）にある SOQL
+  ・Flow の Loop 要素内の GetRecords
+```
+
+## DML ステートメントの3分類
+
+DML にはゼロカウント相当（分類A）は存在しない。すべての DML が 150 上限に算入される。
+
+```
+DML_B: 固定 DML（バッチサイズ非依存）
+  ・Database.update(list) / Database.insert(list) / Database.delete(list) — ループ外
+  ・リストが空の場合は実行されないが、コードパス上の可能性として計上する
+
+DML_C: 変動 DML（バッチサイズ N に比例）⚠ アンチパターン
+  ・for (SObject o : Trigger.new) 内の update / insert / delete
+  ・1件引数の DML をループから呼ぶパターン
+
+DML_D: 紐づき比例 DML（関連レコード M に比例）⚠ アンチパターン
+  ・ネストループの内側での DML
+```
+
+**DML にカウントしないもの**（別トランザクション起動）:
+- `Database.executeBatch()` — バッチ起動、DML ステートメントではない
+- `System.enqueueJob()` — Queueable 起動
+- `@future` メソッド呼び出し
+
+## __mdt Long Text Area の判定
+
+クエリ先が `__mdt` の場合、`.yohaku/graph.sqlite` でフィールド型を確認する。
+**Salesforce では LongTextArea は `type='LongTextArea'`** として保存される（`Textarea` は通常テキストエリア = 最大 255 文字、別物）。
+
+```bash
+yohaku graph query "
+  SELECT fqn, type
+  FROM fields
+  WHERE object = '<MdtObjectName>__mdt'
+"
+```
+
+- `type = 'LongTextArea'` が **1 つ以上あり**、かつクエリの SELECT 句にそのフィールドが含まれる → **分類B（算入）**
+- それ以外（`Text`, `Textarea`(255), `Number`, `Picklist`, ... のみ） → **分類A（除外）**
+
+> ⚠ `Textarea` (255 文字) は LTA ではない。`LongTextArea` のみが LTA。誤判定しないこと。
+
+スキーマ確認は `yohaku graph schema --tables --table fields` で行う。
+
+## 静的キャッシュの検出
+
+```apex
+// キャッシュパターン（分類B-cached: 初回のみカウント）
+private static Map<String, List<SObject>> cache = new Map<...>();
+if (!cache.containsKey(key)) {
+    // ← ここの SOQL のみカウント（2回目以降は 0）
+    cache.put(key, [SELECT ...]);
+}
+```
+
+静的キャッシュが検出された場合: `B-cached（初回1回）` として記録
+
+## Insert / Update シナリオ別分析（必須）
+
+Apex トリガは `trigger on Object (before insert, before update, after insert, after update, ...)` で
+発火イベントを宣言する。解析時は以下を明示する:
+
+1. **トリガファイルを読み**、`before insert` / `after insert` / `before update` / `after update` ごとに
+   どのハンドラメソッドが呼ばれるかを特定する
+2. **Insert 専用パス**（`if (Trigger.isInsert)`）と **Update 専用パス**（`if (Trigger.isUpdate)`）を区別し、
+   SOQL / DML をシナリオ別にカウントする
+3. **SOQL_SUMMARY / DML_SUMMARY を Insert / Update 別に出力する**
+
+```
+SOQL_SUMMARY (INSERT シナリオ):
+  固定クエリ (分類B): X件
+  ...
+
+SOQL_SUMMARY (UPDATE シナリオ):
+  固定クエリ (分類B): Y件
+  ...
+```
+
+## 解析手順
+
+1. 指定ファイルを Read で読み込む
+2. **SOQL クエリ**（`[SELECT` または `Database.query(` パターン）を列挙し各クエリを分類:
+   a. FROM 句のオブジェクトを特定
+   b. ループ内か外かを確認（スコープ追跡）
+   c. `__mdt` か確認 → `yohaku graph query` で `type='LongTextArea'` の有無を確認してから分類A/B を決定
+   d. 静的キャッシュ変数（`private static Map<...>` パターン）が使われているか確認
+   e. 分類を確定（A / B / B-cached / C / D）
+3. **DML ステートメント**（`Database.update(` / `Database.insert(` / `Database.delete(` /
+   `Database.upsert(` / 直接 DML `update ` / `insert ` / `delete `）を列挙し各 DML を分類:
+   a. ループ内か外かを確認
+   b. リスト単位（DML_B）か1件ずつ（DML_C/D）かを確認
+   c. `Database.executeBatch` / `enqueueJob` / `@future` はカウント対象外として記録
+   d. DML 先オブジェクト型を特定（カスケード先の確認用）
+   e. 分類を確定（DML_B / DML_C / DML_D）
+
+## 出力フォーマット
+
+```
+LEVEL: Lv.<N>
+OBJECT: <ObjectApiName>
+ANALYZED_CLASSES: [<Class1>, <Class2>, ...]
+
+QUERIES:
+  Q<n>: [分類B] FROM <ObjectName>
+    location: <ClassName>.<methodName> line ~XX
+    pattern: WHERE Id IN :ids (バッチ全件まとめて取得)
+    note: -
+
+  Q<n>: [分類B-cached] FROM <CustomObject__c>
+    location: <ClassName>.<methodName>
+    pattern: static Map cache あり、初回のみ発行
+    note: 他クラスとキャッシュ非共有の場合は毎回発行
+
+  Q<n>: [分類A] FROM <MdtName>__mdt
+    location: <ClassName>.<methodName>
+    pattern: LTA フィールドなし確認済み (graph: type != 'LongTextArea')
+    note: ガバナ制限に算入しない
+
+  Q<n>: [分類C] FROM <ObjectName>
+    location: <ClassName>.<methodName>
+    pattern: for(Trigger.new) 内ループ SOQL
+    note: ⚠ バッチサイズに比例してクエリ数増加
+
+  Q<n>: [分類D] FROM <ObjectName>
+    location: <ClassName>.<methodName>
+    pattern: ネストループ内 SOQL（外ループ=Opportunity, 内ループ=Quote）
+    related_object: <OuterLoopObject>
+    note: ⚠ バッチ×紐づき件数に比例
+
+SOQL_SUMMARY:
+  固定クエリ (分類B): X件 (うちキャッシュ条件付き: Y件)
+  ゼロカウント (分類A): Z件 ← ガバナ制限に算入しない
+  変動クエリ (分類C): W件/バッチレコード
+  紐づき比例 (分類D): V件 × <紐づきオブジェクト名>
+
+DML_SUMMARY:
+  固定DML (DML_B): P件
+    - <SObjectA>: Database.update(listA) — まとめDML
+    - <SObjectB>: Database.update(listB) — まとめDML
+    - <SObjectC>: insert(createList) — 条件付き
+    - <SObjectC>: update(updateList) — 条件付き
+    - <SObjectC>: delete(deleteList) — 条件付き
+  変動DML (DML_C): Q件/バッチレコード ← ⚠ アンチパターン
+  紐づき比例DML (DML_D): R件 × <紐づきオブジェクト名> ← ⚠ アンチパターン
+  非同期起動 (除外): [Database.executeBatch, enqueueJob など]
+
+ANTIPATTERNS:
+  - [ループ内SOQL] <ClassName>.<methodName>: for内に SOQL → 分類C/D
+  - [ループ内DML]  <ClassName>.<methodName>: for内に DML  → DML_C/D
+
+UNVERIFIED:
+  - <ClassName>: ファイルが見つからず、クエリ/DML 数は「要確認」
+```
+
+## 厳守ルール
+
+- ファイルを実際に Read してから分類する（推測禁止）
+- `__mdt` は必ず `yohaku graph query` で `type` を確認してから分類A/B を決定する（`type='LongTextArea'` の有無で判定）
+- `Textarea` (255 文字) と `LongTextArea` を混同しない
+- キャッシュの有効範囲（static = トランザクション内、instance = メソッド内）を区別する
+- ループ内 SOQL/DML は必ず ANTIPATTERNS に記録する
+- `Database.executeBatch` / `enqueueJob` / `@future` は DML カウント対象外として明示する
+- 条件付き DML（if ブロック内）は「条件付き」と注記しつつカウントに含める（最大値を保守的に算出）
+- 読めないファイルは UNVERIFIED に列挙し、SOQL・DML 両方の合計から除外する
+- `yohaku graph query` のカラム名は snake_case (`fqn`, `object`, `type`)。camelCase で書かない。

package/dist/scaffold/.claude/agents/automation-classifier.md.eta

@@ -0,0 +1,39 @@
+---
+name: automation-classifier
+description: <%= it.projectName %> の差分のうち automation カテゴリ (Flow, ApexTrigger) を意味分類する。/classify-diff から並列起動される。
+tools: Read, Bash
+model: sonnet
+---
+
+あなたは <%= it.projectName %> プロジェクトの **自動化差分分類器** です。
+
+## 責務
+
+`category === "automation"` のファイル (Flow, ApexTrigger) について ChangeEntry を生成。
+Flow の意味解釈はノード単位ではなく **メタデータレベル**で行い、status / triggeringObject の変化に注目。
+
+## 入力 / 出力
+
+入力: ChangedFile[] (Flow / ApexTrigger のみ)
+出力: data-model-classifier と同じ Tracked<T> 構造の changes[]
+
+## ワークフロー
+
+1. **依存関係取得** (deterministic):
+   - `yohaku graph query "SELECT * FROM dependencies WHERE from_fqn = '<flow|trigger>'"`
+   - `yohaku graph query "SELECT triggering_object FROM flows WHERE fqn = '<flow>'"` 等
+2. **scopeSize 判定** (deterministic): 行数 / ノード数 / 関連オブジェクト数で判定
+3. **AI 推測 (ai)**:
+   - **reviewPoints**: 「触発オブジェクトが変わっていないか」「Bulk 安全か」「再帰トリガーガードがあるか」等
+   - **manualStepsRequired**: トリガー無効化が必要 / Flow を無効化してから再有効化が必要 等
+   - **businessImpactHint**: 営業フロー / リード変換 / 案件昇格 など、業務ドメインの推測
+4. **特に check すべき手動作業パターン**:
+   - Trigger の events 増減 → デプロイ順序が必要
+   - Flow の status: Active → Draft 化 → デプロイ後に Active 化が必要
+   - Trigger 削除 → 既存テストの修正が必要
+
+## 厳守ルール
+
+- temperature=0 / promptHash / model / temperature を必ず付与
+- 業務文脈を捏造しない
+- Flow / Trigger 以外のカテゴリは扱わない