artgraph-graph-primitive-impact

## Purpose **artgraph リポジトリ内部専用の dev process skill**(`templates/skills/` の一般配布ツリーには含まれない。canonical コピーは `.claude/skills/artgraph-graph-primitive-impact/SKILL.md` のみ)。 グラフ基本操作 (BFS / エッジ意味論 / ID 解決) は多数の CLI コマンドと gate 経路から間接消費されており、意味論を狭める・広げる変更は**直接の呼び出し元 grep では見えない経路を silent に壊す**。本 skill は issue 対応ループの **Step 0-pre**(設計より前)で、その経路を事前に列挙するための 17 チェック調査を定義する。 ## トリガー条件 以下のいずれかに該当する issue/PR に着手する時、設計 (Step 0) の**前に**本調査を実行する: - `src/graph/traverse.ts` / `src/graph/builder.ts` を変更する - エッジ意味論 (kind の追加・削除、forward/reverse トラバース条件の変更) を変える - `impact()` / `check()` / `buildGraph()` など graph-core 関数のシグネチャ・戻り値・意味論を変更する ## 実行モデル **クリーンな Sonnet 5 (`claude-sonnet-5`) サブエージェント**に委譲する。メイン loop の文脈 (実装方針の仮説) を持ち込まないことで、確証バイアスなしに経路を列挙させる。 サブエージェント brief テンプレ: > あなたは artgraph リポジトリの調査担当です。これから `<変更対象の primitive / 関数 / エッジ kind>` を `<変更の一行要約>` する変更を検討しています。実装はまだ存在しません。 > `.claude/skills/artgraph-graph-primitive-impact/SKILL.md` の 17 チェックを順に実行し、「この primitive を変えると SILENT に破壊される経路」のランク付きリストを報告してください。各項目には (a) 経路の説明 (b) 影響を受ける CLI コマンド (c) 該当テストの有無 (d) 推奨 (本 PR で fix / 別 issue / accept) を含めること。 ## 17 チェック ### 1. 直接呼び出し元 変更対象の関数名で全呼び出し箇所を列挙する。 ```bash grep -rn "<関数名>(" src/ tests/ ``` これは**出発点にすぎない**。チェック 2 以降が本体。 ### 2. 戻り値フィールドの transitive consumer trace 変更対象が返す**各フィールド名**を grep し、非テストコードの消費側を追う。関数名ではなくフィールド名で追うのがポイント(呼び出し元が結果オブジェクトを別関数に渡した先で消費されるケースを捕まえる)。 ```bash # impact() の例 — 返却フィールドごとに実行 for f in impactReqs affectedFiles affectedDocs affectedTasks drifted originReqs req...