feat: add coherence-map skill

[gitt510]

Why

• 同じ設計上の問いに複数の実装答えが並存する fork は lint / test / diff のどれにも現れないため、明示的に照合する手段が要る
  • 実走テスト(bibles repo)で検出した fork 7件は、いずれも CI green のまま並存していた(例: 実在しない id に PUT は 404・DELETE は 204 / 同一 invariant の違反が POST では 400・PUT では 409)
• 既存 skill にこの検出の管轄がない
  • ponytail-review は over-engineering(削るもの)専門で、Boundaries が correctness ほか検出系を明示的にスコープ外としている

What

• skills/coherence-map/SKILL.md を新規追加(単一 file、102行)
• codebase の設計判断を「問い(質問形)→ 答え(file:line 必須)→ 状態」で docs/coherence-map.md に蓄積し、会話には要約(問い総数・状態内訳・🟡 一覧)だけを返す
• 状態は3値: unified / forked(判断待ち)/ documented-fork(理由が comment・ADR・docs に実在)
• byte-identical な重複は報告せず、既存の問いへの別解(分岐)だけを警報にする
• fork には fix ではなく decision(統一 / 別問題である理由の明文化)を要求する
• 実行環境に手段があれば map の HTML view を提示する(使い捨て、repo に commit しない)

Test

• bibles repo で SKILL.md のみを与えた subagent が実走: 問い24件(🟡 11 / 🔵 3 / 🟢 10)を file:line つきで検出、対象 repo は無変更(git status clean)
• 実走後に境界へ追加した「docs と実装の乖離は対象外」により、検出済み 🟡 のうち docs 由来の4件が落ちることを確認(残 🟡 7)

Notes

• docs と実装の乖離を scope 外にした — staleness であって実装同士の fork ではなく、混ぜると map が「なんでも指摘リスト」に薄まるため。docs は documented-fork の明文化確認にだけ使う
• map の SoT は markdown を採用 — repo に commit されて diff / grep でき、次回実行の照合起点になるため。HTML を成果物にする案は使い捨ての提示層に格下げした

🤖 Generated with Claude Code