consumer-finding-ledger（consumer の課題を正本へ持ち帰る）

ハーネスは consumer で使われて初めて壊れ方が分かる。作業中に気づいた課題を その場で 1 行書き、 区切りで 正本の台帳へ PR する。正本側で triage し、fixture / hook / 標準へ昇格する。 「後でまとめて書く」は書かれない（原則 P1: 自己申告でなく記録に残った事実で判断する）。

いつ使うか（consumer 側・作業中）

ゲートが止めたときに、ゲート側を緩めて通さない。 記録して先へ進み、正本で直す。

実行手順（consumer 側）

1. 記録する（1 行・200 字以内・URL と org/repo パスは書けない）

   python3 .claude/willink-kit/engines/finding.py add \
     --kind false-positive --component pre-commit-shell-lint.sh --stage ios \
     --summary "grep の [[:space:]] 化の案内が BSD 互換の説明を欠く" \
     --evidence "git commit → exit 1（pre-commit-shell-lint）"

   台帳は .claude/harness-findings.jsonl（コミットする・オフラインでも書ける）。 consumer は既定でリポジトリのディレクトリ名（PH_CONSUMER / --consumer で上書き）。

2. 整合を見る（CI にも入れる）

   python3 .claude/willink-kit/engines/finding.py check --check --allow-missing

3. 区切り（PR を出す前・セッションの終わり）で正本へ持ち帰る — Claude が自分で打つ（人に頼まない）

   python3 .claude/willink-kit/engines/finding.py sync            # preview（正本の clone 不要）
   python3 .claude/willink-kit/engines/finding.py sync --push     # 一時 clone → commit → push → PR まで機械

   --harness を省くと .claude/settings.json の extraKnownMarketplaces（source=git の url・plugin を取るために consumer は必ず持っている）から正本を 一時 clone して持ち帰る。clone がある端末では --harness <clone> でもよい。 synced_at は push が origin に届いてから入る（push が落ちた行は入らず、次の sync で再送される）。 synced_at の入った行は正本の main にまだ無くても再度持ち帰らない（PR が open の間に二重の PR を立てない・ 「持ち帰り済みで main 未反映 N」と出る）。PR が merge されずに消えたときだけ、その行の synced_at を消せば再送される。 gh が無い / 権限が無い場合は push まで行い「手で PR を開く」と言う（branch 名を印字）。 branch 名は learn/findings-<consumer>-<YYYYMMDD> なので、同じ日に 2 回目の新規があると push が拒否される（exit 1・ synced_at は入らない）。その日は 1 本目の PR に merge されるのを待つか、翌日に打つ。

4. 正本側の判定（fixed / wontfix / triaged と resolution）を consumer の台帳へ写す（sync は片方向）

   python3 .claude/willink-kit/engines/finding.py pull            # preview（更新 N / 同じ M / 正本に無い K）
   python3 .claude/willink-kit/engines/finding.py pull --apply    # 同 id の status / resolution を書き、pulled_at を入れる

   harness-check が「未同期 N 件」と言ったら 3.、正本の PR が merge されたら 4.。どちらも Claude が打ってよい （書くのは台帳 1 ファイルと正本の learn/findings-* ブランチだけ。main へは触らない）。

実行手順（正本側・triage）

python3 scripts/finding.py list --status open
python3 scripts/finding.py triage --id <consumer>/<id> --status fixed --pr <PR 番号>
python3 scripts/finding.py triage --id <consumer>/<id> --status promoted --promoted-to fixtures/<name>
python3 scripts/finding.py stats

• 昇格先は 3 つ: fixture（bug-pattern）/ hook・engine の修正（false-positive missed gap）/ 標準の改訂（standards）
• 昇格時は人が 1 件ずつ、顧客名・URL・金額・個人情報が無いことを確認する（fixture 昇格と同じ原則）
• wontfix にするときは --note に理由を残す

決定論 --check（コマンドと exit の意味）

python3 scripts/finding.py check --file findings/consumer-findings.jsonl --check

• exit 0 = 走査 N 行すべて schema に合致・id 重複なし・URL / org/repo / 認証情報なし
• exit 1 = 違反あり（行番号と理由を列挙）
• exit 2 = 台帳が無い（0 件ではなく未作成。consumer の CI では --allow-missing）

python3 scripts/finding.py --self-test

• exit 0 = hermetic な tmp で add / check（block・pass）/ sync（preview・apply・再 apply・synced_at の二重防止）/ triage / pull（preview・apply・再 pull・正本に無い行）/ settings.json の url からの一時 clone → push（origin は file:// の bare repo・gh は偽物）／push 拒否で synced_at を入れない／findings/ の無い url に台帳を作らない、が期待どおり（48 ケース）

参照

• エンジン: scripts/finding.py
• 正本の台帳と運用: findings/README.md
• 昇格先: fixtures/（再現ケース）/ core/hooks/・scripts/（ゲート）/ standards/development-standards.md
• 姉妹 skill: mistake-rule-distill（ミス経緯 → ルール蒸留）/ rule-promotion-extract（advisory → blocking 昇格）
• 設計原則: 原則 P1（自己申告禁止・決定論ゲート）