ynitto codd-gate — doc/code/test 一貫性ゲートの運用
codd-gate（tools/codd-gate/）は doc↔code↔test の接続マップを毎回フレッシュに作り、
差分を Green / Amber / Gray / Followup に分類して受け入れ前に止め、直せない分を
修復タスク（JSON）へ変換する決定的 CLI。agent-project に依存しない独立ツール
（python3＋git のみ。インストールは bash tools/codd-gate/install.sh）で、単体では CI・
git hook（verify --base "@{push}" 等）に差し込む。LLM 判断をこのゲートに混ぜないこと
（連携時の修復の知能は agent-project → agent-flow の act が担う）。
| 境界 | 使うもの |
|---|---|
| 単発のドリフト調査・証拠付きレポート | doc-drift-detector |
| 仕様書の新規逆生成 / 書き直し | code-to-specs / technical-writer |
| 一貫性を常時ゲートし、ドリフトを backlog へ返す | 本スキル（codd-gate） |
基本操作（単体・これだけで完結する）
codd-gate scan # 接続マップ＋負債棚卸し（.codd-gate/map.json）
codd-gate impact --base origin/main # 差分の Green/Amber/Gray/Followup（報告のみ）
codd-gate verify --base origin/main # 差分ゲート（ドリフトで exit 1）
codd-gate verify --debt --max-broken 0 # 負債ラチェット
codd-gate tasks --debt # 負債→修復タスク（JSON。--inbox DIR でファイル出力）
codd-gate check --doc D --code C --fresh # 状態アサーション（修復完了の判定に使う）
- 「常に」の単体運用は git hook / CI に置く: pre-push に
codd-gate verify --base "@{push}"、 CI にverify --base origin/$BASE_BRANCH && verify --debt --max-broken 0。 - 複数リポジトリは共通スキーマ（
schemas/repos.schema.json）のレジストリを--repos <file>か 設定.kiro/codd-gate.{yaml,json}のrepos:で与える（identity = (url, path, base)。dir:で ローカル checkout、docs:/tests:/code:で分類グロブを上書き）。charter.md は読まない。
追加情報: agent-project との連携（オプション）
codd-gate は agent-project から完全に独立させる。.agents/agent-project.yaml には state repo が持つ
共通チェックを1本だけ設定し、その内側から codd-gate を呼ぶ。
regression_cmd: ./tools/check
#!/bin/sh
set -eu
codd-gate verify --base "$AGENT_BASE_REV" --repos ./repos.json
差分基準は agent-project が実行時に渡す。旧 $KIRO_BASE_REV は後方互換としてのみ扱う。
通常タスクの verify や charter acceptance へ同じ検査を重ねない。検証 CLI を増やす場合は
tools/check に1行追加する。既存負債は必要なときに
codd-gate tasks --debt | agent-project enqueue --json で明示投入する。codd-gate が生成した修復タスクでは、
タスク自身の codd-gate check を完了根拠として使う。
守ること: 常駐・繰り返しは agent-project（または cron/CI）に持たせる。codd-gate に watch 的な 長期実行を求めない（どのサブコマンドも単発・有界が設計上の不変条件）。
ガードレール
- 既存負債（ブラウンフィールド）を差分ゲートで NG にしない。負債は必ず「棚卸し→ラチェット→タスク化」
- 接続の誤検出を疑ったら注釈
coherence: doc=…/code=…/test=…で明示宣言する（推定より優先） - repo の checkout が解決できないまま「PASS した」と報告しない（codd-gate は exit 2 で止まる）
- 詳細仕様は
tools/codd-gate/README.md、設計はdocs/designs/codd-gate-design.mdが正典