Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
{
"name": "ndf",
"source": "./plugins/ndf",
"description": "Claude Code plugin (v11.0.13): 8 specialized agents (plus 2 supervisor agents and 1 worker agent for the 3-layer workflow) and 49 focused NDF skills for PR/review workflows, cross-review, implementation planning, plan-to-spec, Docker container access, statusline, external AI delegation (Codex/agy), and optional Slack notifications.",
"description": "Claude Code plugin (v11.0.14): 8 specialized agents (plus 2 supervisor agents and 1 worker agent for the 3-layer workflow) and 49 focused NDF skills for PR/review workflows, cross-review, implementation planning, plan-to-spec, Docker container access, statusline, external AI delegation (Codex/agy), and optional Slack notifications.",
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
Expand All @@ -22,7 +22,7 @@
{
"name": "playwright-kit",
"source": "./plugins/playwright-kit",
"description": "Claude Code plugin (v4.0.4): 4 Playwright E2E skills — test planning by page role, script authoring with video / trace evidence, report generation with collected evidence, and the playwright_kit runtime (init, a11y / CWV scans).",
"description": "Claude Code plugin (v4.0.5): 4 Playwright E2E skills — test planning by page role, script authoring with video / trace evidence, report generation with collected evidence, and the playwright_kit runtime (init, a11y / CWV scans).",
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
Expand Down
30 changes: 30 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,36 @@
**開発版(接尾辞の付いた版)は載せない。** `9.8.0` は `9.8.0-dev.1` までしか出ておらず、
その内容は `10.0.0` で届いている。

## [mcp-serena 3.0.4] - 2026-11-22

- 依存の Python のパッケージを、公開から 7 日たった最新の安定版へ上げた。コマンドと振る舞いは変わらない(#3961)

## [playwright-kit 4.0.5] - 2026-11-22

- 依存の Python のパッケージを、公開から 7 日たった最新の安定版へ上げた。Skill の手順と振る舞いは変わらない(#3961)

## [ndf 11.0.14] - 2026-11-22

- 並列の計画の同時実行の制御を、マシン全体の稼働中のレーンの数とテストのスロットの 2 層にした。計画とレーンの設定の `max_lanes`・`max_plans`・レーンの `plans`、検査 I20・I2、`ndf lanes limits`・`ndf lanes set --plans` を消した。3 つの値を書いた `plan.json`・`lane.json` は、キーの名前を名指して断る(#4001)
- 稼働中のレーンの上限は、判定のたびにマシンの設定 → 環境変数 `NDF_RELAY_MAX_NAMED` → `relay.max-named` の順で読む。`ndf relay cap [--named N | --clear]` でマシンの設定を書く
- 行を始める起動・続きの起動は、元のラッパーを止める前に上限を判定する(`ndf relay spawn --replace --seat <席>`)。上限で断られても元のラッパーは動いたままになる
- `ndf relay ls` は登録簿に無く錠を持つラッパーも `registered: false` で載せ、`ndf lanes status` は待ちの理由(`machine-lanes`・`lock`・`observe`)と数・上限を出す
- NDF は `gh`・`claude`・`codex` を起動する前にバージョンを下限(`gh` 2.17.0・`claude` 2.1.268・`codex` 0.122.0。`plugins/ndf/contracts/domains/cli-floors.json`)と比べ、下限より古ければ起動せずに CLI の名前・見つけたバージョン・実パス・下限を出して止まる。下限と同じ数字のプレリリース(例 `0.122.0-alpha.1`)も古いとして止まる。バージョンを読めない(出力の形が違う・5 秒で返らない)ときは、標準エラーへ 1 行を出して比べずに起動する。Kiro と agy は比べない(#3961)
- ラッパー(中継)のパススルーは `ndf-relay: claude を起動できない(<理由>)` を出して終了コード 127 で終わる。`claude --version` などパススルーする起動でも、その前に NDF が `claude --version` を 1 回打つ
- ラッパーが子の claude を起動するときは `ndf-relay: 子の claude を起動できない(<理由>)` を出し、停止理由 `precondition`(終了コード 3)で終わる
- `ndf launch-args` は `precondition` で止まり、`bin/ndf-claude` はその回答を出して同じ終了コードで終わる(`exec claude` に進まない)
- NDF が使う Python の依存のバージョンが上がった(filelock 4.0.3 → 4.2.10・pydantic 2.13.5 → 2.14.3・slack-sdk 3.44.1 → 3.47.0 ほか)。DBOS(3.4.0)と httpx(0.28.1)は変わらない。コマンドと結果の形は変わらない(#3961)
- `release` の Skill が配るスライドのテンプレート(`plugins/ndf/skills/release/assets/slides/`)に `.npmrc`(`min-release-age=7`)を置いた。テンプレートで `npm install` すると、公開から 7 日たったバージョンだけを入れる(#3961)

### 移行の手順

- 外部 CLI が下限より古い環境では、`gh` を 2.17.0 以上・Claude Code を 2.1.268 以上・Codex を 0.122.0 以上へ上げる。今のバージョンは `gh --version`・`claude --version`・`codex --version` で見られる(#3961)
- 並列の計画の設定(`.ndf/parallel/<計画>/plan.json`)に `max_lanes`・`max_plans`・レーンの `plans` を書いていれば、消してから `ndf lanes start` を打ち直す。消す前に打つと、キーの名前を名指して断られる(#4001)

```bash
jq 'del(.max_lanes, .max_plans) | .lanes |= map(del(.plans))' .ndf/parallel/<計画>/plan.json > plan.json.new && mv plan.json.new .ndf/parallel/<計画>/plan.json
```

## [ndf 11.0.13] - 2026-11-21

- Fix: cross-review の run が指摘をスレッドにして閉じた指摘を resolve し、修正の記録を PR へ残す(#3939)(#3940)
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,8 +93,8 @@ Claude Code では `/ndf:<Skill 名>` と打って呼びます。**Skill** は

| プラグイン名 | バージョン | できること | 詳細 |
| --- | --- | --- | --- |
| **ndf** | 11.0.13 | 開発の工程の Skill、専門のサブエージェントと実行主体(supervisor・worker)、hook、コマンド `ndf` | [README](./plugins/ndf/README.md) |
| **playwright-kit** | 4.0.4 | Playwright による E2E テストの計画・スクリプトの作成・証跡のレポート | [README](./plugins/playwright-kit/README.md) |
| **ndf** | 11.0.14 | 開発の工程の Skill、専門のサブエージェントと実行主体(supervisor・worker)、hook、コマンド `ndf` | [README](./plugins/ndf/README.md) |
| **playwright-kit** | 4.0.5 | Playwright による E2E テストの計画・スクリプトの作成・証跡のレポート | [README](./plugins/playwright-kit/README.md) |

ndf に入るもの:

Expand Down Expand Up @@ -125,7 +125,7 @@ ndf に入るもの:

### NDF の Skill の一覧

**NDFプラグイン v11.0.13** に入る Skill の数は、AI ツールごとに違います。
**NDFプラグイン v11.0.14** に入る Skill の数は、AI ツールごとに違います。
Claude Code向け core 49個、Codex向け core 45個です(配る先は [manifests/skills.json](./plugins/ndf/manifests/skills.json) が決めます)。
元Skills(49個)の内訳は次のとおりです。
- Pull Request とレビュー (7): pr, pr-tests, fix, pr-review, cherry-pick-pr, deploy, merged
Expand Down
23 changes: 23 additions & 0 deletions docs/metrics/ndf-token-usage/2026-11-22.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
{
"per_pr": [],
"per_role": [],
"external": [],
"meta": {
"by": [
"version",
"mode",
"model",
"cc",
"reviewers"
],
"min_version": "10.27.76",
"until": "2026-11-22T00:44:00Z",
"sessions": 0,
"sessions_with_pr": 0,
"unlinked_external": 0,
"unlinked_ledger": 0,
"skipped": {},
"released": "11.0.14",
"previous": "2026-11-21.json"
}
}
73 changes: 73 additions & 0 deletions docs/metrics/ndf-token-usage/2026-11-22.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
# ndf の版ごとのトークン消費と所要時間(2026-11-22 集計・11.0.14 のリリース)

**11.0.14 を正式版として出したときの記録である。** 打ち切りの時刻は `2026-11-22T00:44:00Z`。表の最初の行は 10.27.76(前の記録: 2026-11-21.md)。既定では前の記録の最後の版で、記録どうしが 1 行ずつ重なる。生の記録・会話の本文・リポジトリ名・会話の ID は残していない。集計した日時点の記録で、以後の記録の増減には追随しない。

## 作り方

同じ打ち切りの時刻で走らせ直すと、記録が残っている間は同じ `.json` ができる。ただし kiro の記録はターンに時刻を持たないため、打ち切りをまたいで進行中だった席は credit が変わりうる。

```bash
python3 scripts/token-usage-snapshot.py --released 11.0.14 --until 2026-11-22T00:44:00Z --min-version 10.27.76
python3 scripts/token-usage.py --min-version 10.27.76 --until 2026-11-22T00:44:00Z --by version # 末尾の「集計の出力」
```

## 比べるときの注意

- **PR を作った会話が 2 件以下の版:** 無し。作業の中身の違いが版の違いより大きい
- **CHANGELOG.md にあって表に出ない版:** 10.27.76, 10.27.77, 11.0.0, 11.0.1, 11.0.2, 11.0.3, 11.0.4, 11.0.5, 11.0.6, 11.0.7, 11.0.8, 11.0.9, 11.0.10, 11.0.11, 11.0.12, 11.0.13, 11.0.14。その版で始めた PR つきの会話が無い(会話の版は最初に読んだ版で決まる)
- **打ち切りの 30 分前以降にも行がある会話を含む版:** 無し。進行中だった会話は、値が打ち切りの時刻までの分である

## 版ごとの差(PR 1 本あたり)

換算の合計は conductor・supervisor・worker の換算の和。前の版との差は、表の 1 つ上の行との比である。±30% を超えた版を下の「読み取り」で扱う。

| ndf の版 | 会話 | PR | 換算の合計 | 前の版との差 | conductor | supervisor | worker | 入力 | 所要 | codex 入力 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |

## 版と層ごとの呼び出しとキャッシュ(1 起動あたり)

P と k と書き込みは 1 起動あたり、書き直しとうち 5 分超は合計の回数である。

| ndf の版 | 層 | 起動 | P | k | 書き込み 5 分 | 書き込み 1 時間 | 書き直し | うち 5 分超 | 1 起動あたりの書き直し |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |

## 読み取り

差の大きい版は無い(すべて ±30% の内)。読み取りは要らない。

## 集計の出力

対象の会話: 0 件 / PR を作った会話: 0 件 / 寄せ先の無い外部 CLI: 0 件 / 寄せ先の無い帳簿の行: 0 件

換算は input を 1 とした費用(cache read はモデル別: claude-opus-5-5 0.05 / claude-sonnet-5-5 0.05 / claude-fable-5-2 0.025 / claude-fable-5-1 0.025 / 他 0.1。cache write 5 分 1.25・1 時間 2 / output 5)。入力は input + cache read + cache write。所要は分。

### PR 1 本あたり

| 動いた版 | 会話 | PR | conductor 換算 | supervisor 換算 | worker 換算 | 入力 | 出力 | 所要 | codex 入力 | codex 出力 | kiro credit | claude 席 換算 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |

### フェーズごと(1 起動あたり)

| 動いた版 | 層 | フェーズ | 定義 | 起動 | 換算 | 入力 | 出力 | 所要 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |

### フェーズごとの呼び出しとキャッシュ

P は起動ごとの固定費(最初の呼び出しの文脈)、k は呼び出し回数(どちらも 1 起動あたり)。書き直しは 2 回目以降の呼び出しのうち、書き込みが文脈の 50% を超え、かつ 20k を超えたものの回数(合計)。5 分超はそのうち直前の呼び出しとの間隔が 5 分を超えた回数、間隔は直前の間隔の中央値(分)。5 分超の書き直し・読み込みは、直前の間隔が 5 分を超えた呼び出しの書き直しの量と、書き直しでない呼び出しの読み込みの量(どちらも合計)。定義はサブエージェントの定義の名前。

| 動いた版 | 層 | フェーズ | 定義 | 起動 | P | k | 書き込み 5 分 | 書き込み 1 時間 | 書き直し | 5 分超 | 5 分超の書き直し | 5 分超の読み込み | 間隔 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |

### 外部 CLI(1 起動あたり)

kiro はトークン数を記録しない(値が 0)ため credit だけを載せる。agy は読まない。

| 動いた版 | ランタイム | Skill | モデル | 起動 | 入力 | cache | 出力 | credit | 所要 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |

### 外部 CLI の呼び出しとキャッシュ(1 起動あたり)

codex は input のうち cached に当たらなかった分を書き込みとみなし、呼び出しごとの値(last_token_usage)を持つ席だけで数える。kiro は呼び出し回数を記録しない(利用者のターン数は JSON の turns)。取れない値は -。

| 動いた版 | ランタイム | Skill | モデル | 起動 | P | k | 書き直し | 5 分超 | 5 分超の書き直し | 5 分超の読み込み | 間隔 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
4 changes: 2 additions & 2 deletions docs/versioning-and-distribution.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,11 +61,11 @@ NDF が開発版チャネルを持つリポジトリで使う版の形として

| 版 | 形 | 意味 |
| --- | --- | --- |
| 正式版 | `11.0.13` | 利用者が常用してよい |
| 正式版 | `11.0.14` | 利用者が常用してよい |
| 開発版 | `11.1.0-dev.1` | 検証中。入れたくない利用者は取得を控えられる |
| 公開前の確認版 | `11.1.0-rc.1` | 正式版の候補。残るのは確認だけ |

- 接尾辞は**次に出す正式版の版数へ付ける**。`11.0.13` の次を開発するなら `11.1.0-dev.1`
- 接尾辞は**次に出す正式版の版数へ付ける**。`11.0.14` の次を開発するなら `11.1.0-dev.1`
- 連番は開発版を出すたびに増やす。**同じ版数で中身を差し替えない**。差し替えると、利用者の
手元にある版と `main` の版が同じ番号で別物になり、何を確かめたのかが分からなくなる
- **正式版を出すときは接尾辞を外す。** `11.1.0-dev.3` の次は `11.1.0`
Expand Down
2 changes: 1 addition & 1 deletion plugins/mcp/mcp-serena/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "mcp-serena",
"version": "3.0.3",
"version": "3.0.4",
"description": "Serena MCP server (serena-agent 1.7.0) for symbol-level code reading and editing, with a per-project language-server setup skill and hooks that steer repeated grep/reads toward symbol tools",
"author": {
"name": "takemi-ohama",
Expand Down
2 changes: 1 addition & 1 deletion plugins/mcp/mcp-serena/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "mcp-serena",
"version": "3.0.3",
"version": "3.0.4",
"description": "Serena MCP server (serena-agent 1.7.0) for symbol-level code reading and editing, with a per-project language-server setup skill and hooks that steer repeated grep/reads toward symbol tools",
"author": {
"name": "takemi-ohama",
Expand Down
4 changes: 2 additions & 2 deletions plugins/ndf/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "ndf",
"version": "11.0.13",
"description": "Claude Code plugin (v11.0.13): 8 specialized agents (plus 2 supervisor agents and 1 worker agent for the 3-layer workflow) and 49 focused NDF skills for PR/review workflows, cross-review, implementation planning, plan-to-spec, Docker container access, statusline, external AI delegation (Codex/agy), and optional Slack notifications.",
"version": "11.0.14",
"description": "Claude Code plugin (v11.0.14): 8 specialized agents (plus 2 supervisor agents and 1 worker agent for the 3-layer workflow) and 49 focused NDF skills for PR/review workflows, cross-review, implementation planning, plan-to-spec, Docker container access, statusline, external AI delegation (Codex/agy), and optional Slack notifications.",
"author": {
"name": "takemi-ohama",
"url": "https://github.com/takemi-ohama"
Expand Down
4 changes: 2 additions & 2 deletions plugins/ndf/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "ndf",
"version": "11.0.13",
"description": "Codex plugin (v11.0.13): 45 focused NDF skills for PR/review workflows, cross-review, implementation planning, plan-to-spec, Docker container access, external AI delegation (Codex/agy), and optional Slack completion notifications.",
"version": "11.0.14",
"description": "Codex plugin (v11.0.14): 45 focused NDF skills for PR/review workflows, cross-review, implementation planning, plan-to-spec, Docker container access, external AI delegation (Codex/agy), and optional Slack completion notifications.",
"skills": [
"./skills/backlog-refinement",
"./skills/cherry-pick-pr",
Expand Down
4 changes: 2 additions & 2 deletions plugins/ndf/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -244,14 +244,14 @@ agy models # 認証確認
```text
$CODEX_HOME/plugins/cache/<marketplace>/<plugin>/<version>/skills/<skill>/SKILL.md
# 既定 ($CODEX_HOME=~/.codex) の例:
# ~/.codex/plugins/cache/ai-plugins/ndf/11.0.13/skills/deploy/SKILL.md
# ~/.codex/plugins/cache/ai-plugins/ndf/11.0.14/skills/deploy/SKILL.md
```

実体のパスは `codex plugin list` で確かめます。

```bash
codex plugin list | grep 'ndf@ai-plugins'
# => ndf@ai-plugins installed, enabled 11.0.13 <path>
# => ndf@ai-plugins installed, enabled 11.0.14 <path>
```

Claude Code では `disable-model-invocation: true` と `/ndf:deploy` のスラッシュコマンドで同じ役割を果たします。
Expand Down
4 changes: 2 additions & 2 deletions plugins/playwright-kit/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "playwright-kit",
"version": "4.0.4",
"description": "Claude Code plugin (v4.0.4): 4 Playwright E2E skills — test planning by page role, script authoring with video / trace evidence, report generation with collected evidence, and the playwright_kit runtime (init, a11y / CWV scans).",
"version": "4.0.5",
"description": "Claude Code plugin (v4.0.5): 4 Playwright E2E skills — test planning by page role, script authoring with video / trace evidence, report generation with collected evidence, and the playwright_kit runtime (init, a11y / CWV scans).",
"author": {
"name": "takemi-ohama",
"url": "https://github.com/takemi-ohama"
Expand Down
4 changes: 2 additions & 2 deletions plugins/playwright-kit/plugin.json
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "playwright-kit",
"version": "4.0.4",
"description": "Agent Plugins package (v4.0.4): 4 Playwright E2E skills — test planning by page role, script authoring with video / trace evidence, report generation with collected evidence, and the playwright_kit runtime (init, a11y / CWV scans).",
"version": "4.0.5",
"description": "Agent Plugins package (v4.0.5): 4 Playwright E2E skills — test planning by page role, script authoring with video / trace evidence, report generation with collected evidence, and the playwright_kit runtime (init, a11y / CWV scans).",
"author": {
"name": "takemi-ohama",
"url": "https://github.com/takemi-ohama"
Expand Down