最終更新: 2026/07/03 18:33
commontype: ops-doc
pageadr: ADR-0197purpose: クローン間 inbox の自動消化 (ADR-0197) の月次レポート永続…generated_by: .github/workflows/inbox-cost-report.ym…retention: 期間制限なし (Review After 2027-01-01 で判断)

inbox_consume_report — ADR-0197 月次レポート

.github/workflows/inbox-consume-<role>.yml (5 本 · Phase 2b 完成後) の消化 latency と Claude API cost を月次に永続化する dir。集計 script は scripts/inbox-consume-metrics.mjs (Phase 4 で新設予定)。

生成物

  • YYYY-MM.md — 月次レポート本体。.github/workflows/inbox-cost-report.yml の月次 cron (毎月 1 日 09:00 JST) が自動 commit する (Phase 4 で稼働開始)。
  • README.md (本 file) — 手順とレポート様式の SSoT。

レポート様式 (workflow が生成する YYYY-MM.md の構造)

---
type: ops-report
adr: ADR-0197
run_id: <GH Actions run id>
generated_at: <ISO8601>
month: YYYY-MM
---

# inbox 自動消化 YYYY-MM

## サマリ

| 項目 | 値 |
|---|---|
| workflow 発火回数 (main / doc / drp / mas / ocr 合算) | N |
| うち `order-mechanical` で消化 (成功) | N |
| うち `order-needs-approval` で Issue 起票 | N |
| SKIP (target 不一致 · dry-run · disabled) | N |
| ERROR (script fail · CLI timeout) | N |
| 消化 latency 中央値 (merge → PR 起票) | N 秒 |
| 消化 latency p95 | N 秒 |
| Claude API cost (LiteLLM tag filter) | $N.NN |
| GitHub Actions minute (自 workflow) | N 分 |

## クローン別 内訳

| role | 発火 | mechanical 消化 | needs-approval Issue | SKIP | ERROR |
|---|---|---|---|---|---|
| main | N | N | N | N | N |
| doc | N | N | N | N | N |
| drp | N | N | N | N | N |
| mas | N | N | N | N | N |
| ocr | N | N | N | N | N |

## Confirmation KPI 判定

| KPI | 目標 | 実測 | 判定 |
|---|---|---|---|
| 消化 latency 中央値 (§9-1) | < 5 分 | N 秒 | ✓/✗ |
| 誤 auto-merge 件数 (§9-2) | 半年累計 0 (許容 1) | N | ✓/✗ |
| Claude API cost (§9-3) | 月 $50 以内 | $N | ✓/✗ |
| type 未記入 PR 拒否率 (§9-4) | 100% | N/N (P%) | ✓/✗ |

## 撤退条件監視 (ADR-0197 §8)

- **§8-1**: 誤 auto-merge 3 ヶ月で 2 件以上 → 直近 3 月分の Issue 履歴で確認
- **§8-2**: Claude API cost 月 $50 超が 2 ヶ月連続 → 直近 2 月分の `cost` 列で確認
- **§8-3**: 消化 latency 中央値 > 15 分が 1 ヶ月 → 本節「サマリ」の中央値で判定
- **§8-4**: 消化ゼロの月が発生 → workflow disabled or LLM 障害の切り分けで対応

## 目視レビューの記録 (代表取締役)

- レビュー日: `_(手動入力)_`
- 誤 auto-merge として差し戻した PR: `_(手動入力: PR 番号 + 理由)_`
- allow-list に追加検討する mechanical pattern: `_(手動入力)_`
- 撤退条件抵触判定: `_(手動入力)_`

運用フロー

  1. 月初 (毎月 1 日 09:00 JST) に cron が YYYY-MM.md を自動生成 · commit (Phase 4 稼働後)
  2. 代表取締役は該当月中に「目視レビューの記録」節を手動記入 · commit
  3. KPI ✗ が発生したら §8 撤退条件を評価。抵触なら workflow を停止 (gh variable set INBOX_CONSUME_ENABLED --body false)
  4. Cost > $50/月 は Issue が自動起票される (.github/workflows/inbox-cost-report.yml · Phase 4)

関連

  • ADR-0197 (クローン間 inbox を merge 時に自動消化)
  • .github/workflows/inbox-consume-<role>.yml (消化 workflow 5 本 · main は Phase 2a shipping · 他 4 clone は Phase 2b で追加)
  • .github/workflows/inbox-cost-report.yml (月次 cron · Phase 4 で新設)
  • scripts/inbox_consume.sh (消化共通 script)
  • scripts/inbox-consume-metrics.mjs (集計 script · Phase 4 で新設)
  • .claude/rules/handover.md (起案規約 SSoT)
  • docs/_internal/05_how-to/inbox_workflow.md (運用手順)
  • docs/_internal/06_ops/adr_omission_report/README.md (同型 pattern の先例 · ADR-0180)