配布を Claude Code と codex だけにし（すべてのプラグイン）、agy・kiro へは配らず cross 系の相手役だけにする #2231

方針の変更（2026-10-31 夜、承認ゲート 1 で利用者が指示）

claude とcodexのみ、すべてのpluginを配布することとします。agy、kiroは配布せず、cross系で呼ばれるだけ。

（書き手: 利用者、日付: 2026-10-31。会話の原文）

• Claude Code と codex: マーケットプレイスのすべてのプラグイン（ndf・playwright-kit・mcp-*）を、すべての Skill で配る。codex の配布は縮めない
• agy と kiro: 何も配らない（plugins/ndf/manifests/agy-skills.txt・kiro-skills.txt、dev.agy/・各プラグインの dev.kiro/ の導入物、release.runtimes の kiro を外す）。cross-review / cross-refactoring から相手役の CLI として呼ばれる経路だけを保つ
• 下の「依頼（原文）」と受け入れ条件のうち、codex に配布を絞る部分はこの変更で置き換わる。プロジェクト MVV の Mission（4 ランタイム）の改訂は別の課題で扱う

受け入れ条件

• 1. agy-skills.txt・kiro-skills.txt と agy・kiro 向けの導入物（dev.agy/、ndf・playwright-kit・mcp-* の dev.kiro/）が配布物から無くなり、release の対象ランタイムが claude と codex だけになる（マージ前にテストとビルドで確かめる）
• 2. codex へ配る Skill とプラグインは変更前と同じ（すべて）である（マージ前に manifests とビルドで確かめる）
• 3. agy・kiro を相手役にした cross-review と cross-refactoring の起動経路（launch-cli.sh・launch-reviewer.sh）が変わらず通る（マージ前にテスト、リリース後に実物で確かめる）
• 4. AGENTS.md・CLAUDE.md・KIRO.md・README・docs/ndf-plugin-reference.md・docs/versioning-and-distribution.md・docs/plugin-development-guide.md が 2 ランタイム配布＋相手役 2 つの構成を書く（マージ前にリンク検査と指示書のチェックで確かめる）
• 5. ランタイムのスモークテストと CI から agy・kiro の導入の検査が外れ、codex の検査は残る（マージ前に CI で確かめる）
• 6. 配布をやめると直す必要が無くなる agy・kiro だけの open の課題の一覧を設計に載せる（閉じるのは棚卸し）

今の状態（2026-11-04）: 設計 PR #2295 と実装 PR #2306 で入れて配った。リリース後テスト（#2328 のコメント、ndf 10.27.6 で取り直し）で条件 1・2・4・5・6 は合格した。条件 3 は kiro を相手役にした経路が合格し、agy を相手役にした起動の記録が無いため保留である。次に --include agy で cross-review か cross-refactoring を回したときに確かめる。

依頼（原文）

codex・agy・kiro へは、cross-review / cross-refactoring に要る Skill 以外を配布しない。

（書き手: 利用者（起票者が「決めたこと（2026-10-31）」として本文へ引用した文。会話の原文は確かめていない）、日付: 2026-10-31）

何が困るか

NDF は Claude Code・Codex・Kiro CLI・agy の 4 つのランタイムへ、ほぼ同じ Skill を配っている（plugins/ndf/manifests/*-skills.txt）。同じ機能を 4 通りに保つ費用がかかり、ランタイムごとの差分を吸収する層・スモークテスト・不具合（agy の本文の切り詰め #2163 など）が増え続ける。

Codex・agy・kiro が NDF の工程で担っているのは、cross-review と cross-refactoring の相手役である。工程の本体（supervise・relay・承認ゲート・hook）は Claude Code で動かす。

直すもの

• plugins/ndf/manifests/codex-skills.txt・agy-skills.txt・kiro-skills.txt を、cross-review / cross-refactoring に要る Skill だけにする（要る Skill の一覧は設計で決める）
• dev.agy/・dev.kiro/ の agents・hook・steering のうち、その 2 つに要らないものを外す
• AGENTS.md の「4 ランタイム共通」の前提、各ランタイムの README、docs/ndf-plugin-reference.md、docs/versioning-and-distribution.md を新しい配布に合わせる
• ランタイムのスモークテストを、配る Skill に合わせて絞る

受け入れ条件

• 3 つのマニフェストに、cross-review / cross-refactoring に要らない Skill が無い
• 絞った後も、codex・agy・kiro を相手役にした cross-review と cross-refactoring が通る
• 配布を絞ると直す必要が無くなる open の課題（agy・kiro・codex だけで起きる不具合）を棚卸しで閉じる

（書き手: 起票者、日付: 2026-10-31。上の引用以外は利用者の指示の原文として扱わない）

起票者の推定

目的

• codex・agy・kiro へ配る NDF を、cross-review / cross-refactoring の相手役に要るものだけにし、同じ機能を 4 通りに保つ費用（ランタイムごとの差分を吸収する層・スモークテスト・ランタイムだけで起きる不具合）を減らす
• 絞った後も、Claude Code をホストにした cross-review / cross-refactoring で codex・agy・kiro が相手役として今と同じ結果を返す

前提

• 前提 1: Claude Code 以外のランタイムが NDF の工程で担う役割は、cross-review のレビュー担当と cross-refactoring の提案・実装の担当（相手役）だけである（S1）
• 前提 2: cross-review / cross-refactoring のホスト（収束ループを起動する CLI）は Claude Code に限る。codex・agy・kiro をホストにする使い方は、この変更の後は保証しない（S7。誤っても、配る Skill の一覧へ行を足せば戻せる）
• 前提 3: 相手役が読む手順は、ホストの側が担当のworktreeへ置くか、起動の依頼文に直接書く。今の実装では、cross-review のレビュー担当の依頼文は Skill を読まずに完結し（plugins/ndf/skills/cross-review/scripts/launch-reviewer.sh の render_review_prompt）、cross-refactoring は refactoring・tdd-cycle・quality-gates をホストの導入先から担当のworktreeへ写す（plugins/ndf/skills/cross-refactoring/scripts/prepare-worktrees.sh・refactor_lib/vocabulary.py の REQUIRED_SKILLS）。相手役のランタイムに配った Skill に頼る経路が他に無いことは、設計で確かめる
• 前提 4: Claude Code へ配る Skill（plugins/ndf/manifests/claude-skills.txt）は変えない
• 前提 5: 利用者の手元に既に入っている codex・agy・kiro 向けの Skill を、こちらから消す操作はしない。配布物から消えた Skill が手元に残るかは各ランタイムの導入の振る舞いに従い、その扱いを利用者向けの文書に書く

対象範囲

含む:

• plugins/ndf/manifests/codex-skills.txt・agy-skills.txt・kiro-skills.txt の中身
• plugins/ndf/dev.agy/・plugins/ndf/dev.kiro/ のエージェント定義・hook・steering・プロンプトのうち、相手役に要らないもの
• 配布物を組み立てる・確かめるスクリプトとテスト（マニフェストを読むもの、ランタイムのスモークテスト）を、新しい配布に合わせる
• AGENTS.md の「4 ランタイム共通」の記述、各ランタイムの README、docs/ndf-plugin-reference.md、docs/versioning-and-distribution.md
• 配布を絞ると直す必要が無くなる open の課題の一覧（棚卸しへ渡す材料）

含まない:

• Claude Code へ配る Skill・エージェント・hook の変更
• cross-review / cross-refactoring 自体の振る舞いの変更（参加者プール・輪番・収束の規則）
• playwright-kit・mcp-* プラグインの配布
• 一覧にした open の課題を実装の PR で閉じること（閉じるのは棚卸し）
• 利用者の手元の導入済みの Skill を消す操作

ドメインイベント

用語

旧受け入れ条件（方針の変更の前。判定に使わない）

• 1. plugins/ndf/manifests/codex-skills.txt・agy-skills.txt・kiro-skills.txt のどの行も、設計で決めた「相手役に要る Skill の一覧」に含まれる。一覧に無い Skill がマニフェストにあると落ちる検査が CI で動く
• 2. 相手役が起動時に読む Skill（cross-refactoring の REQUIRED_SKILLS など、設計で洗い出したもの）が、ホストの導入先からworktreeへ写せる。欠けると落ちる検査が CI で動く
• 3. plugins/ndf/dev.agy/ の配布物（エージェント定義・hooks.json・skills/・scripts/）に、相手役に要らないものが無い。何を残したかと理由は設計文書に表で残る
• 4. plugins/ndf/dev.kiro/install.sh が生成するもの（.kiro/skills/・.kiro/steering/・.kiro/agents/ndf.json）と dev.kiro/ のプロンプトに、相手役に要らないものが無い
• 5. claude plugin validate . が終了コード 0 で終わり、python3 scripts/check-skill-frontmatter.py と python3 plugins/ndf/scripts/instructions-check.py --root . が通る
• 6. AGENTS.md・各ランタイムの README・docs/ndf-plugin-reference.md・docs/versioning-and-distribution.md に「4 ランタイムへほぼ同じ Skill を配る」前提の記述が残らず、codex・agy・kiro が相手役だけを担うことと、配る Skill の一覧の正本（マニフェスト）を指す記述がある
• 7. ランタイムのスモークテスト（scripts/runtime-smoke-test.sh と .github/workflows/runtime-plugin-smoke*.yml）が、codex・agy・kiro について配る Skill だけを確かめ、配らない Skill の存在を求めない。CI のスモークのジョブが通る
• 8. 新しい配布物を導入した環境で、Claude Code をホストに codex・agy・kiro を相手役にした cross-review 1 回と cross-refactoring 1 回が、各相手役の結果ファイルを返して終わる（NO_RESULT が出ない）
• 9. 配布を絞ると直す必要が無くなる open の課題の一覧（番号と理由）が、実装の PR か本課題に残り、棚卸しで閉じるか残すかが決まる
• 10. 退行しない: Claude Code 向けのマニフェスト（claude-skills.txt）と Claude Code の配布物は変わらず、既存の pytest（uv run --frozen --project . --all-extras pytest . -q -n 4）が通る

非機能の条件

影響

検証手段

前提とする取り決め

境界

未決

進行

モード: — / 進め方: auto

• 要求と受け入れ条件 — 2026-10-31 11:33
• 作業場所の用意 — 2026-10-31 13:00
• 設計 — 2026-10-31 11:37
• 素材の収集と出典の確定
• ドキュメント再構成
• ドキュメントレビュー
• 計画 — 2026-10-31 13:00
• 実装 — 2026-10-31 13:43
• 構造改善 — 2026-10-31 18:37
• 実装レビュー — 2026-10-31 22:29
• 完了判定 — 2026-10-31 14:31
• Pull Request — 2026-10-31 14:46
• 確定仕様化 — 2026-11-01 00:29
• 後片付け — 2026-11-01 00:28
• 配布 — 2026-11-01 00:00
• 体裁レビュー
• リリース後テスト — 2026-11-01 00:28
• 振り返り — 2026-11-01 01:03
• 棚卸し — 2026-11-01 01:17

振り返り: #2320 (comment)

状況（2026-11-01、v10.27.6）

リリース後テストの記録（#2328 、01:00Z）の行は、この本文の受け入れ条件（6 件）より前の番号付け（10 件）で書かれており、番号が合わない。判定は 6 件の新しい行で行う。2026-11-01 に今の状態で確かめた結果:

リリース後テストの取り直し（2026-11-01 17:39 JST）

記録: #2328 (comment)

• 記録の行を本文の今の受け入れ条件 6 件の番号で置き直した。条件 1・2・4・5・6: 合格。条件 3: 保留。kiro は 10.27.5 の後に相手役として通ったが、agy（--include agy）を相手役にした起動は 10.27.5 の後に記録が無い。次に --include agy で cross-review か cross-refactoring を回したときに確かめる
• 開いたままの理由: 合格でない条件が残る（sprint-close.py --record-pr 2328 --with-verification の結果は kept_open）