Docs: cross-refactoring 再々検証の引継ぎメモを追加し、v8.3.0 へ更新

[takemi-ohama]

概要

次の 2 つを行う。本番コードの振る舞いは変えない。

1. /ndf:cross-refactoring の未到達 2 項目を次のセッションで通すための引継ぎメモを追加する
2. NDF プラグインの版数を v8.3.0 へ更新する（Fix: 公開の責務を進行側へ一本化し、適用失敗の項目を対象外へ記録する #121 で公開インタフェースが変わったのに v8.2.0 のままだった）

コンテキストが肥大化したため、再々検証は新しいセッションで行う。そこで必要になる情報を 1 ファイルにまとめた。

1. 引継ぎメモ

節	内容
現在地	3 回の検証の到達点と、修正がすべて main に入っていること
通したい 2 項目	指摘の修正と再レビューの繰り返し / 上限到達時の項目単位の見送り
先に決めること	指摘が出る確率をどう上げるか（4 案）。2 回目は指摘 0 件で到達できなかった
実行手順	Draft PR の用意と、PLUGIN_ROOT / --scope / --sync-command を含む実行コマンド
落とし穴	実測で踏んだ 7 件（キャッシュが古い、Bash の 10 分上限、monitor.py の実行権限 など）
所要時間	フェーズごとの実測。1 ラウンド 30〜45 分
確認すること	未到達 2 項目に加え、#121 で入れた経路の実機確認

2. v8.3.0 への更新

#121 が変えた公開インタフェースは次の 2 つで、片方は破壊的である。

• --sync-command の新設（追加）
• 実装担当が push しない / merge-applymerge-fix が常に push する（破壊的）

ファイル	内容
plugins/ndf-claude/.claude-plugin/plugin.json	version と description。版数の唯一の基準
plugins/ndf-codex/.codex-plugin/plugin.json	同上（この family では生成対象外のため手動更新）
plugins/ndf-kiro/VERSION	build-runtime-plugins.sh が基準から同期した生成物
.claude-plugin/marketplace.json	description の (v8.3.0)
README.md	版数表記と v8.3.0 の主な変更（破壊的変更と --sync-command の使い方）
AGENTS.md / CLAUDE.md	版数表記、v8.3.0 の段落、公開の責務と --sync-command の記述
plugins/ndf-codex/README.md / plugins/ndf-kiro/README.md	キャッシュパスと agent description の例示

CLAUDE.md 44 行目と README.md 130 行目に残る 8.2.0 は過去の版の履歴なので変更していない。

残った別件

cross-review は「AI 自身が gh api で投稿する」設計だが、投稿が失敗しても結果ファイルの申告だけで判定が進む。#121 のラウンド 3 で実際に起きた（comments_count=2 の申告に対し、GitHub 上にスレッドが 1 つも作られなかった）。今回は payload ファイルから内容を拾えたが、気付かなければ指摘を取りこぼす。本 PR では記録のみで、修正しない。

テストプラン

ドキュメントと版数のみのため、リンク検査と配布物の検証で足りる。

python3 scripts/check-markdown-links.py
bash scripts/validate-runtime-plugins.sh
bash scripts/build-runtime-plugins.sh --check

検証結果

段階	コマンド	対象範囲	結果
静的解析	python3 scripts/check-markdown-links.py	全体	valid / exit=0
生成物の同期	bash scripts/build-runtime-plugins.sh --check	配布物 3 系統 + MCP	up to date / exit=0
ビルド・検証	bash scripts/validate-runtime-plugins.sh	配布物 3 系統 + marketplace	passed / exit=0（claude plugin validate 3 件も ✔）

未検証の項目: なし（本番の振る舞いも本番コードの構造も変えないため、テストの実行は不要と判断した）
既存の失敗: なし / 範囲外と判断したもの: 上記「残った別件」1 件

関連

• Refactor: cross-refactoring スクリプト群のクロスリファクタリング試行 #118 / Fix: cross-refactoring の実機検証で見つかった不具合 9 件を修正（v8.2.0） #119 — 1 回目の検証と不具合 1〜9 の修正
• Refactor: cross-refactoring 修正後の再検証（v8.2.0） #120 / Fix: 公開の責務を進行側へ一本化し、適用失敗の項目を対象外へ記録する #121 / Docs: cross-refactoring 修正後の再検証レポートを残す #122 — 2 回目の検証、不具合 10・11 の修正、レポート

🤖 Generated with Claude Code

https://claude.ai/code/session_01DhXHMSW7A61J3H9LMtJbLT