cross-refactoring: 帰属行が別段落に付くと必須トレーラーが読めず、claude 担当の群が落ちる

[takemi-ohama]

何を見つけたか

cross-refactoring の適用ラウンドで、claude が実装担当のときだけ必須トレーラー
（Item-Id / Round / Impl-Runtime / Impl-Model）が読めず、群が丸ごと取り消される。

原因はトレーラーの書き落としではない。 コミットメッセージには 4 つとも書かれている。
Claude Code のセッションが帰属行（Co-Authored-By: / Claude-Session:）を空行を挟んだ
別の段落として後ろに足すため、git が最終段落だけをトレーラーブロックとして読む。

$ git log -1 --format='%B' 26a0fff | tail -8
Item-Id: R4-004
Round: 4
Impl-Runtime: claude
Impl-Model: default

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

$ git log -1 --format='%(trailers:only,unfold)' 26a0fff
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

同じラウンドの kiro 担当のコミット（84be466）は最終段落が必須トレーラーであるため読める。

$ git log -1 --format='%(trailers:key=Item-Id)' 84be466
Item-Id: R4-003

読み取りは refactor_lib/gitfacts.py の commit_trailers()（--format=%(trailers:only,unfold)）。

どこで見つけたか

• 読み取り: plugins/ndf/skills/cross-refactoring/scripts/refactor_lib/gitfacts.py の commit_trailers()
• 判定: plugins/ndf/skills/cross-refactoring/scripts/refactor_lib/verify.py の verify_commit_trailers()
• 指示: 適用プロンプトの「コミットの規約」節（Item-Id などを本文末尾に書くとだけ書いてある）

実測は PR #549 の rf549。提案ラウンド 4 の適用ラウンド 4（実装 claude / 項目 R4-004、
コミット 26a0fff）が
コミット 26a0fff... にトレーラーが欠けています: Item-Id, Round, Impl-Runtime, Impl-Model
で取り消された。同じ形のコミットを rf549 でもう 1 件（4be6fbf）確認している。
PR #529 でも 1 件起きたことが引継ぎメモに残っている。

なぜこの変更の範囲外なのか

#156 の受け入れ条件 14 件は cross-review の指摘の統合・実行検証・反証・区分だけを扱う。
cross-refactoring の適用結果の検証は対象に入っていない。

直さないと何が起きるか

• claude が適用担当に当たったラウンドは、正しく適用してもほぼ確実に落ちる。 輪番は
  4 者で回るため、提案ラウンドごとに 1 群が無駄になる
• 失敗が実装担当からは見えない。 結果ファイルの trailers は 4 つとも揃った形で
  書かれ、進行側だけが git を読んで落とす
• 取り消しの単位は適用ラウンドであるため、同じ群に複数の項目が入っていれば全件が巻き込まれる

修正レイヤー

plugins/ndf/skills/cross-refactoring/scripts/refactor_lib/commands/apply.py の cmd_merge_apply（取り込み）。
項目の帰属（Item-Id / Round / Impl-Runtime）の値を割り当てたのは進行側で、公開（push）も進行側だけが
行う（CLAUDE.md:63）。担当に書かせて、git の最終段落の定義で読み返す構造が、ランタイムが後ろへ段落を
足すたびに壊れる。読み取り（gitfacts.py:95 の commit_trailers）を段落単位にする直し（issues/issue-647-592-553-design.md:117
の決定 11）は現れている場所の直しで、次に別の書式の署名を足すランタイムが現れれば同じ形が起きうる。
進行側が知っている値を進行側が取り込みで書けば、担当のランタイムの帰属行の書式に左右されない。

採る手

移動（move_responsibility）。帰属のトレーラーを付ける責務を、実装担当（prompts/apply.md の「コミットの規約」）から
進行側の取り込み（cmd_merge_apply）へ移す。

直し方の候補

修正レイヤーに当たるのは D である。

案	中身	気になる点
A	commit_trailers() を git interpret-trailers --parse へ変える	同じく最終段落しか読まない。効かない
B	メッセージ全文から ^<Key>: を正規表現で拾う	git のトレーラー定義から外れる。本文中の同名の行を拾いうる
C	プロンプトへ「必須トレーラーを最後の段落に置く（帰属行より後ろ）」と書く	実装担当の従い方に依存する
D	進行側が取り込みの直前に git commit --amend でトレーラーを足し直す	実装担当のコミットを進行側が書き換える。ただし対象は公開前のコミットで、push は進行側だけが行う（CLAUDE.md:63）ため、書き換えたコミットが公開済みの履歴と食い違うことはない。Impl-Model（実際に使ったモデル名、prompts/apply.md:65）は担当しか知らない値で、進行側が付けるには結果ファイルから受け取る

由来

PR #549

進行

モード: standard / 作業ツリー: .worktrees/feat/issue-728-apply-intake / 計画: issues/issue-728-647-592-553-plan.md

• 要求と受け入れ条件 — 2026-09-15 12:46
• 作業場所の用意 — 2026-09-15 12:45
• 設計 — 2026-09-15 13:45
• 素材の収集と出典の確定
• ドキュメント再構成 — 2026-09-15 13:45
• ドキュメントレビュー — 2026-09-15 13:46
• 計画 — 2026-09-21 21:27
• 実装 — 2026-09-21 21:47
• 構造改善 — 2026-09-21 22:19
• 実装レビュー — 2026-09-22 02:28
• 完了判定 — 2026-09-22 02:44
• Pull Request — 2026-09-21 22:16
• 確定仕様化 — 2026-09-22 03:43
• 後片付け — 2026-09-22 03:31
• 配布 — 2026-09-22 14:17
• 体裁レビュー
• リリース後テスト — 2026-09-22 15:06
• 振り返り — 2026-09-22 15:38

閉じた理由

PR #796 で直り、ndf 10.16.0（2026-09-22、main / タグ ndf--v10.16.0、PR #810）で配布した。リリース後テスト（#810 (comment) ）でこの課題の受け入れ条件はすべて合格した。

振り返り: #810 (comment)

[takemi-ohama]

PR #558 の cross-refactoring（rf558）で再発を確認した

構造改善の提案ラウンド 1 / 適用ラウンド 4（実装 claude / 項目 R3-005、コミット cdfa3b5）が
にトレーラーが欠けています: Item-Id, Round, Impl-Runtime, Impl-Model で取り消された。

4 つとも書かれている。読めていないだけである。

$ git log -1 --format='%B' cdfa3b5 | tail -8
Item-Id: R3-005
Round: 3
Impl-Runtime: claude
Impl-Model: claude-opus-5

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

$ git log -1 --format='%(trailers:only,unfold)' cdfa3b5
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

これで実測は 4 件になった（PR #529 で 1 件、PR #549 で 2 件、PR #558 で 1 件）。
--model claude=<名前> を明示しても起きる（rf558 は 4 ランタイムとも指定してある）。

あわせて見つけた、実測モデルの取り方の問題

別の事象だが、同じ「モデルを明示した実行」で表に出た。 起票を分けるべきか、この課題へ
含めるかは実装時に判断してほしい。

cross-refactoring が「指定したモデル claude-opus-5 と実際に動いたモデル
claude-haiku-4-5-20251001 が食い違っています。比較には使えません」を出す。claude-opus-5
は実際に動いている。

$ python3 -c "..."   # claude-apply-r3-stdout.log の modelUsage を読む
modelUsage のキー: ['claude-haiku-4-5-20251001', 'claude-opus-5']

Claude Code は本体のモデルのほかに内部の処理で haiku を使うため、modelUsage は 2 つ以上の
キーを持つ。先頭のキーを実測として採ると、指定したモデルと食い違う。 その結果、claude が
担当したラウンドがモデル比較の集計から外れる。

もう 1 つ、ラウンド側の記録が担当と食い違う。 rf558 のテスト整備ラウンド 2 は担当が
agy（requested: gemini-3.1-pro-high）だが、impl_model.observed に
claude-haiku-4-5-20251001 が入っている。このラウンドで claude が動いたのは群 2 だけで、
群の実測がラウンドの記録へ書かれている。

由来

PR #558

[takemi-ohama]

codex でも起きた。原因は帰属行に限らない

PR #558 の rf558、構造改善の提案ラウンド 3 / 適用ラウンド 1（実装 codex / モデル gpt-5.5、
コミット 3d73e1e）が
にトレーラーが欠けています: Item-Id, Round, Impl-Runtime で取り消された。
Impl-Model だけは欠落として挙がっていない。

$ git log -1 --format='%B' 3d73e1e | tail -8
Item-Id: R5-001

Round: 5

Impl-Runtime: codex

Impl-Model: gpt-5.5

$ git log -1 --format='%(trailers:only,unfold)' 3d73e1e
Impl-Model: gpt-5.5

codex はトレーラーの各行の間に空行を入れた。 git は最終段落だけをトレーラーブロックと
して読むため、読めるのは最後の 1 行だけになる。

課題の見立てを広げる必要がある

当初この課題は「Claude Code の帰属行が別段落として後ろに付くこと」として書いた。
実際はもっと一般の形である。

形	読めるもの
必須トレーラー 4 行 + 空行 + 帰属行（claude）	帰属行だけ
必須トレーラーの各行の間に空行（codex）	最後の 1 行だけ

共通するのは「必須トレーラーが 1 つの段落にまとまっていない」ことである。 実装担当の
プロンプトは書式の例を示すだけで、段落として連続していることが要件であると書いていない。

実測の件数（rf558 まで）

ランタイム	件数	出どころ
claude	6	PR #529 で 1 件、PR #549 で 2 件、PR #558 で 3 件
codex	1	PR #558

claude が適用担当に当たったラウンドは、rf558 では 3 回中 3 回とも落ちた。

由来

PR #558

[takemi-ohama]

同じ事象を takemi-ohama/ideabase PR #34（rf34、ndf 10.10.1）の作業中に確認した。claude が実装担当だった 2 ラウンドで、採用 9 件のうち 5 件がこの理由だけで取り消された。

ラウンド	コミット	巻き込まれた項目
2（テスト整備）	8029b02	R2-002
4（構造改善）	846dbd6	R4-001 / R4-002 / R4-003 / R4-004（1 コミットの群）

$ git log -1 --format=%B 846dbd6 | git interpret-trailers --parse
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

取り消された差分を読む限り 4 件とも振る舞いを変えない妥当な改善（_resolve_cf_source の抽出、cf_class の upsert SQL の集約、TOTAL_KIND の集約、未参照シンボルの削除）で、コードの理由で落ちたものは無い。

直し方の候補を 2 つ足したい。

1. 読み取りを最終段落に限らない。 commit_trailers() を %(trailers:only,unfold) ではなく本文全体から ^(Item-Id|Round|Impl-Runtime|Impl-Model): を拾う形にする。トレーラーは進行側が発行した値を実装担当が写すだけなので、位置を厳密に見る利益が無い
2. 形式だけの不備は取り消さず、直させる。 群の検証の失敗理由がトレーラー欠落・申告漏れのようなメタデータの不備であるときは、git commit --amend（または申告のやり直し）を求める修正ラウンドを 1 度回し、revert はテスト失敗と振る舞いの変更に限る。いまは「適用が通らなかった」の一括りで群ごと巻き戻すため、1 行の書式のために 4 件の差分が失われる

由来: takemi-ohama/ideabase PR #34（振り返り https://github.com/takemi-ohama/ideabase/pull/34#issuecomment-5662176693）

[takemi-ohama]

同じ事象を devbasex/devbase PR #177（claude 担当 2/2 群が取り消し）と PR #178（1/1）の作業中に確認した。ndf 10.11.0。コミット本文は Item-Id/Round/Impl-Runtime/Impl-Model の段落の後に空行を挟んで Co-Authored-By: Claude … が付き、git interpret-trailers --parse は最後の段落の Co-Authored-By しか返さない。

[takemi-ohama]

同じ形を PR #717 の作業中に確認した。テスト整備ラウンド 2 の適用ラウンド 3 で、agy 担当のコミット 7101d83 が トレーラーが欠けています: Item-Id, Round, Impl-Runtime, Impl-Model で取り消された（claude 担当ではなく agy 担当で起きた）。