Release: ndf v10.17.4-dev.1

[takemi-ohama]

Summary

ndf の開発版 10.17.4-dev.1 を出す。マイルストーン 26「17 トークン消費の削減」の #895（設計 PR #908、実装 PR #921）を develop のチャネルへ載せる版である。正式版（main）へは出さない。 そちらは利用者の承認を得てから進行側が行う。

変えたもの	中身
版数を持つ箇所	3 つの plugin.json（version / description）、marketplace.json、README.md の概要と一覧表、AGENTS.md、plugins/ndf/README.md の Kiro / Codex の確認例を 10.17.4-dev.1 へ上げた
docs/versioning-and-distribution.md の「版の付け方と開発版の配布」章	検査の規則（例の基底が現行版の基底以上）に合わせて正式版の例を 10.17.4 にした
plugins/ndf/README.md の更新案内	見出しを ## v10.17.4-dev.1 へ更新するとき にし、本文を #895 の 3 行の表（SessionStart hook がシェルの設定へ claude の alias を 1 度だけ足す / 区間の切れ目で中継が次の区間を起動する / 中継の下では文脈量の上限で止め続ける）へ書き直した。「手元で確かめる」を、この版で見分けられる 3 コマンド（版数・relay.py の有無・SessionStart hook の relay.py install）へ置き換えた
CHANGELOG.md	ndf 10.17.4 の節を足した（追加 1 件・変更 1 件。見出しに接尾辞を付けない規約に従う）。同じ版へ後から入る変更（#885 ほか）を追記できる形にしてある
docs/ndf-version-decisions.md	v10.17.4 の判断（前景の中継だけにする・区間の終わりを ndf-next のブロックで決める・始められないときは手動の運用へ落ちる・alias を 1 度だけ足し消されたら足し直さない・背景の処理が動いている Stop では印を書かない）を足し、見出しの範囲を v10.12.0〜v10.17.4 にした。329 行で分割は不要

• 大小は PATCH。 マイルストーン 26 は v10.17.0 の後をすべて 10.17.x の PATCH で出す決まりである（中身は機能追加だが、削除・改名・状態ファイルの移行は無い）
• 配布を飛ばさない根拠: 前の正式版 ndf--v10.17.3 からの plugins/ の差分は 10 ファイル（+2422 −16）ですべて plugins/ndf/。scripts/relay.py・hooks/claude.json・scripts/token-guard.sh など利用者へ届く振る舞いの変更を含む
• 利用者の環境へ書く変更を含む。 SessionStart hook が ~/.bashrc / ~/.zshrc の末尾へ印のついた囲みで alias を足す（書く前に写しを取る。NDF_RELAY_AUTO=0 で止まる）
• CLAUDE.md に「の次の版で」で書き出す段落は無く、退避するものは無い（instructions-check.py --root . が exit=0）
• ndf 以外のプラグインの版は上げない

配布の記録

段階: 検証（2026-09-23 に提示して進めた。本番への配布は承認待ち）
版: 10.17.3 → 10.17.4-dev.1（PATCH: マイルストーン 26 は v10.17.0 の後を 10.17.x で出す決まり。削除・改名・移行は無い）
まとまり: PR #908 / #921

注記（マージの後に判明）: このブランチの起点（6cc919fd）の後、この PR のマージの 2 分前（2026-09-23 14:24 UTC）に PR #918（#885 .md の文言を照合するテストを削り、書かない方針を規約にする）が develop へマージされた。そのため develop の 64b70b09 に載った 10.17.4-dev.1 には #918 の変更も含まれる（plugins/ndf/ の 44 ファイル、+55 −5663。テストの削除が大半で、配布物の文書は quality-gates/SKILL.md +4 行・tdd-cycle/references/test-quality.md +16 行・workflow-common.sh のコメント 1 行）。CHANGELOG.md の ndf 10.17.4 の節と更新案内には #918 の分をまだ書いていない。上の まとまり: の行はこの PR が意図した範囲のまま残し、#918 の扱い（記載の追記・版の数え方）は進行側が決める。

Test plan

• bash scripts/build-runtime-plugins.sh --check → exit=0
• bash scripts/validate-runtime-plugins.sh → exit=0
• python3 scripts/check-doc-staleness.py --root . → exit=0
• python3 scripts/check-doc-line-limit.py --root . → exit=0
• python3 scripts/check-markdown-links.py --root . → exit=0
• python3 scripts/check-skill-frontmatter.py / check-cross-skill-refs.py / check-skill-repo-assumptions.py / check-skill-shell-vars.py → exit=0
• python3 plugins/ndf/scripts/instructions-check.py --root . → exit=0
• claude plugin validate . → exit=0（未知フィールドの警告のみ）
• 更新案内の「手元で確かめる」の 3 コマンドを、この版の plugins/ndf/scripts で実行 → すべて exit=0。10.17.3 の中身（git archive ndf--v10.17.3 plugins/ndf を展開したもの）では 3 つとも exit=1（版を見分けられる）
• 更新案内の取得コマンド（claude plugin update / codex plugin marketplace upgrade / codex plugin add）は --help で副コマンドの存在を確認 → exit=0
• uv run --project plugins/playwright-kit/skills/playwright-kit-ops --with pytest --with pytest-xdist pytest . -q -n 4 → 5443 passed（82 秒）
• マージ後、隔離した設定ディレクトリで develop の ref から Claude Code / Codex / Kiro の取得と導入を確かめる（結果はこの PR へコメントする）

🤖 Generated with Claude Code

https://claude.ai/code/session_01DhcogXCb1x3eStK4VoDDCy

[takemi-ohama]

検証への配布の確認（develop の ref）

develop の先端 64b70b09（git ls-remote origin refs/heads/develop refs/heads/main で照会、exit=0。main は 8629b903 のまま）を、一時ディレクトリに作った隔離した設定ディレクトリ（CLAUDE_CONFIG_DIR / CODEX_HOME）で取得・導入した。隔離した設定で claude のセッションは起動していない（marketplace add / install / list だけ）。利用者の ~/.claude・~/.codex・~/.kiro の登録は変えておらず、作業の前後で ~/.bashrc と ~/.zshrc の sha256 は一致、~/.local/share/ndf/relay.py は前後とも無い（確認後に隔離先は削除）。

確かめたこと	結果
CLAUDE_CONFIG_DIR を隔離し claude plugin marketplace add 'https://github.com/devbasex/ai-plugins.git#develop' → claude plugin install ndf@ai-plugins	どちらも exit=0。claude plugin list が Version 10.17.4-dev.1
CODEX_HOME を隔離し codex plugin marketplace add devbasex/ai-plugins --ref develop → codex plugin add ndf@ai-plugins	どちらも exit=0。codex plugin list が 10.17.4-dev.1
Kiro の install.sh --project <一時ディレクトリ> --yes（隔離先に git archive 64b70b09 で展開したものから）	exit=0。.kiro/agents/ndf.json の説明が v10.17.4-dev.1
更新案内の「手元で確かめる」の 3 コマンド（Claude Code の導入先の scripts を $SCRIPTS にして）	3 つとも exit=0（版数・relay.py がある・hooks/claude.json の SessionStart が relay.py install を呼ぶ）
導入先の scripts/relay.py hooks/claude.json scripts/token-guard.sh skills/development-workflow/references/relay.md skills/development-workflow/references/context-window.md と 64b70b09 の同名ファイル	5 つとも cmp で一致（exit=0）
中継と token-guard のテスト（plugins/ndf/scripts/tests/test_relay.py / test_token_guard.py、64b70b09 の展開物で、uv の環境の pytest）	202 passed、exit=0
継続的統合	29 件 pass

🤖 Generated with Claude Code