takemi-ohama · Oct 25, 2026 · Oct 25, 2026 · Oct 25, 2026 · Oct 25, 2026 · Oct 25, 2026
diff --git a/docs/ndf-plugin-reference.md b/docs/ndf-plugin-reference.md
@@ -40,7 +40,7 @@ plugin install 時に build を実行する必要はありません。
 | Claude Code | `.claude-plugin/plugin.json`（`agents/` 11 個（専門 8 個と、3 層の定義 3 個（supervisor 2・worker 1））、`hooks/claude.json`、`skills` 配列 48 個）、`scripts/` |
 | Codex | `.codex-plugin/plugin.json`（`hooks/codex.json`、`skills` 配列 44 個）、`scripts/` |
 | Kiro CLI | `dev.kiro/`（installer・agent config template・workflow prompts）、`manifests/kiro-skills.txt`、`skills/`、`scripts/` |
-| agy | `dev.agy/`（マニフェスト・`hooks.json`・`skills/` の symlink・`agents` と `scripts` への symlink） |
+| agy | `dev.agy/`（マニフェスト・`hooks.json`・`skills/` の symlink・`model` を tier 名へ変えた `agents/` の写し・`scripts` への symlink） |
 
 同じディレクトリを 4 ランタイムが共有しますが、読む対象はマニフェストと installer が決めるため、
 公開される Skill と hook はランタイムごとに異なります。Claude Code 専用の agents / statusline /

diff --git a/docs/specifications/ndf-worker-agent-and-skill-excerpts.md b/docs/specifications/ndf-worker-agent-and-skill-excerpts.md
@@ -61,7 +61,7 @@ supervisor は設計の工程に入った時点で `bash "<絶対パス>/project
 | `plugins/ndf/scripts/projects-sync.sh` | **進捗記録の入口。** 引数をチェックした後、`stage` / `mode` / `pace` / `worktree` / `plan` では、ボードの設定や `gh` が無くても先に `progress-record.sh` を呼んで issue の本文を更新し、その後でボードを更新する。`status` はボードだけに書く。自分では通過記録へ積まない |
 | `plugins/ndf/scripts/progress-record.sh` | 通過記録へ積み、issue の本文の `## 進行` を更新する。工程名の位置に `-` を受けると、チェックリストを変えずに見出し行（モード・進め方・ worktree ・実装計画のファイル）だけを更新する |
 | `plugins/ndf/agents/worker.md` | worker のエージェント定義（`ndf:worker`）。frontmatter の `disallowedTools: Skill, Agent` で 2 つのツールを外す |
-| `plugins/ndf/.claude-plugin/plugin.json` | `agents` 配列に `./agents/worker.md` を載せる。agy へは `plugins/ndf/dev.agy/agents`（`../agents` への symlink）で同じ定義が配られる |
+| `plugins/ndf/.claude-plugin/plugin.json` | `agents` 配列に `./agents/worker.md` を載せる。agy へは `plugins/ndf/dev.agy/agents/worker.md`（`scripts/build-runtime-plugins.sh` が生成する写し。`model` だけを agy の tier 名へ変える）で同じ定義が配られる |
 | `development-workflow/references/agent-layers.md` | 起動指示の雛形と守る規則。「委譲の線」から `work-vessels.md` を指す |
 | `development-workflow/references/work-vessels.md` | 実行方式の比較表、仕事ごとの選び方、小さな作業の線引き、Tool を定義で絞る理由 |
 | `development-workflow/references/context-window.md` | 「委譲する対象と、しない対象」から `work-vessels.md` を指す（写さない） |

diff --git a/docs/specifications/runtime-plugin-distribution.md b/docs/specifications/runtime-plugin-distribution.md
@@ -26,7 +26,7 @@ NDF plugin の plugin name は全 runtime で `ndf` を維持し、配布物は
 | Claude Code | `plugins/ndf/.claude-plugin/plugin.json` | `agents/`、`hooks/claude.json`、`skills` 配列 |
 | Codex | `plugins/ndf/.codex-plugin/plugin.json` | `hooks/codex.json`、`skills` 配列 |
 | Kiro CLI | `plugins/ndf/dev.kiro/install.sh` | `.kiro/agents/ndf.json`、`.kiro/steering/ndf-policies.md`、`.kiro/skills/` symlink、prompts、任意 hook |
-| agy | `plugins/ndf/dev.agy/plugin.json` | `dev.agy/hooks.json`、`dev.agy/skills/` の symlink、`agents` と `scripts` への symlink |
+| agy | `plugins/ndf/dev.agy/plugin.json` | `dev.agy/hooks.json`、`dev.agy/skills/` の symlink、`dev.agy/agents/` の生成した写し、`scripts` への symlink |
 
 `plugins/ndf/manifests/{claude,codex,kiro,agy}-skills.txt` が runtime ごとの配布 Skill 一覧を
 定義する。Claude Code と Codex は manifest と同じ内容を各 plugin.json の `skills` 配列へ書き、
@@ -138,12 +138,13 @@ bash scripts/build-runtime-plugins.sh
 bash scripts/build-runtime-plugins.sh --check
 ```
 
-生成対象は 2 つだけである。
+生成対象は次のとおりである。
 
 | 生成物 | 対象 | 内容 |
 |---|---|---|
 | `plugins/<family>/skills/<Skill 名>/agents/openai.yaml` | Skill を配るプラグイン | Codex の暗黙起動を抑える policy。codex 用 manifest に載り frontmatter が `disable-model-invocation: true` の Skill だけ |
 | `plugins/mcp/<plugin-name>/dev.kiro/install.sh` | MCP plugin | Kiro CLI 向け installer。内容はプラグイン名に依存しない |
+| `plugins/<family>/dev.agy/agents/*.md` | `dev.agy/` を持つプラグイン | `agents/*.md` の写し。agy 1.4 系は `model` に tier 名しか受け付けないため、frontmatter の `model:` の 1 行だけを `scripts/lib/agy_agents.py` の対応表（`sonnet` → `flash`、`opus` → `pro`、`haiku` → `flash`、`inherit` → `inherit`）で置き換える。対応表に無い値は生成も `--check` も非 0 で止まる |
 
 `--check` は生成先との差分を比較し、drift がある場合に非 0 で終了する。
 

diff --git a/plugins/ndf/README.md b/plugins/ndf/README.md
@@ -34,9 +34,14 @@ plugins/ndf/
 `dev.kiro` と `dev.agy` は Agent Plugins 仕様 §8.2 が定めるクライアント拡張ディレクトリです。
 
 `dev.agy/skills/` は `manifests/agy-skills.txt` から生成する symlink です
-（`scripts/build-runtime-plugins.sh`）。`dev.agy/agents` と `dev.agy/scripts` は
-`agents/` と `scripts/` を指し、実体を 4 ランタイムで共有します。**agy は配る Skill を絞る
-手段を利用者側の設定にしか持たない**ため、絞り込みはここへ何を並べるかで表します。
+（`scripts/build-runtime-plugins.sh`）。`dev.agy/scripts` は `scripts/` を指し、実体を
+4 ランタイムで共有します。**agy は配る Skill を絞る手段を利用者側の設定にしか持たない**ため、
+絞り込みはここへ何を並べるかで表します。
+
+`dev.agy/agents/` は `agents/` から同じスクリプトが生成する写しです。agy は `model` に tier 名
+（`flash` / `pro` / `inherit`）しか受け付けないため、frontmatter の `model:` の 1 行だけを
+対応表（`sonnet` → `flash`、`opus` → `pro`）で置き換えます。対応表は `scripts/lib/agy_agents.py`
+が持ちます。写しは手で直さず、`agents/` を直してから生成し直します（`--check` が食い違いを落とします）。
 
 **`skills/` に置く Skill は、少なくとも 1 つの manifest へ載せます。** 配らない Skill の
 置き場所（`optional-skills/`）は v10.5.0 で無くしました。どこからも起動できない Skill を

diff --git a/plugins/ndf/agents/code-reviewer.md b/plugins/ndf/agents/code-reviewer.md
@@ -71,11 +71,11 @@ description: |
 
 ## レビューの原則
 
-- **症状ではなく原因**: 同じ問題が他にもありそうなら指摘
+- **原因を指摘する**: 同じ原因の問題が他にもありそうなら、それも指摘する
 - **既存コードを尊重**: スタイル統一目的の大改造は指摘しない
 - **過剰指摘を避ける**: すべて指摘せず、重要度 major 以上を中心に
 - **YAGNI**: 実装されていない将来機能への「〜も追加すべき」指摘はしない
-- **根拠を添える**: 「一般にこうする」ではなく「このコードベースのルールで」「このバグが起きる」
+- **根拠を添える**: 「このコードベースのルールで」「このバグが起きる」のように、このコードベースに即した根拠を書く
 
 ## サブエージェント呼び出しの制約
 

diff --git a/plugins/ndf/agents/data-analyst.md b/plugins/ndf/agents/data-analyst.md
@@ -41,7 +41,7 @@ description: |
 | インデックス | フルスキャン | WHERE/JOIN列にインデックス |
 | JOIN最適化 | 不要な大規模JOIN | 必要な列のみ取得 |
 | ウィンドウ関数 | 複雑なサブクエリ | ROW_NUMBER(), RANK()使用 |
-| EXISTS vs IN | 遅いIN句 | EXISTSに変更 |
+| EXISTS vs IN | 遅いIN句 | EXISTSで書く |
 | LIMIT活用 | 全件取得 | SQLでページング |
 
 | DO | DON'T |

diff --git a/plugins/ndf/agents/debugger.md b/plugins/ndf/agents/debugger.md
@@ -9,7 +9,7 @@ description: |
 
 # デバッガーエージェント
 
-あなたはデバッグの専門家です。エラーメッセージ、ログ、スタックトレース、失敗テストを起点に、症状ではなく**根本原因**を特定し、最小限の修正案を提示します。
+あなたはデバッグの専門家です。エラーメッセージ、ログ、スタックトレース、失敗テストを起点に、**根本原因**を特定し、最小限の修正案を提示します。
 
 ## 専門領域
 
@@ -58,7 +58,7 @@ description: |
 
 ## 診断方針
 
-- **症状ではなく原因を直す**: `try/catch` で握り潰すような修正は避ける
+- **根本原因を直す**: `try/catch` で握り潰すような修正は避ける
 - **再現手順を常に明確化**: 「たまに起きる」を「確実に起きる」に絞る
 - **ログで推測しない**: 実行してデータを取る
 - **変更は最小限**: 1つの原因につき1つの修正

diff --git a/plugins/ndf/dev.agy/agents b/plugins/ndf/dev.agy/agents
diff --git a/plugins/ndf/dev.agy/agents/code-reviewer.md b/plugins/ndf/dev.agy/agents/code-reviewer.md
@@ -0,0 +1,111 @@
+---
+name: code-reviewer
+model: flash
+description: |
+  git diff / PR差分の一般的なコードレビューに特化したエージェント。可読性、設計、バグ、セキュリティ、テスト観点からチェックし、重要度順に指摘を返します。Codex CLIによる外部AI第二意見が欲しい場合は代わりにcorderエージェントを使ってください。
+  **Use this agent proactively** for: git diff review, PR review before merge, style/design/bug/security checks on recent changes.
+  積極的に委譲すべき場面: git diffレビュー、PRマージ前チェック、最近のコミットの品質レビュー、可読性・設計・バグ・セキュリティの総合チェック。
+---
+
+# コードレビュアーエージェント
+
+あなたはコードレビューの専門家です。git差分またはPR差分を読み、**重要度順**に指摘を整理して返します。corderと異なり外部AI（Codex）は使わず、Claude単体で広い観点から素早くレビューします。
+
+## 専門領域
+
+### 1. 可読性
+- 命名の明確さ
+- 関数/クラスの責務の単一性
+- マジックナンバー、長すぎる関数
+- コメントの必要性（WHYが書かれているか）
+
+### 2. 設計
+- 重複、early abstraction、YAGNI違反
+- 層分離、依存の向き
+- エラーハンドリングの過不足
+- 既存アーキテクチャとの整合
+
+### 3. バグ
+- null / undefined / 空配列エッジケース
+- 型ミスマッチ、暗黙変換の罠
+- 非同期処理の競合、例外の握り潰し
+- off-by-one、境界条件
+
+### 4. セキュリティ（軽量チェック）
+- 機密情報のハードコード、ログ出力
+- ユーザー入力のエスケープ漏れ（SQLi, XSS）
+- 認可チェック欠落
+- 重要: 本格的なOWASP Top10レビューは**qaエージェント**に委譲
+
+### 5. テスト
+- 変更箇所のテスト有無
+- カバレッジの妥当性
+- テストが仕様を表現しているか
+
+## 作業プロセス
+
+1. **差分取得**: `git diff main...HEAD`, `git diff HEAD`, または指定PR番号で `gh pr diff`
+2. **全体把握**: 変更の目的を1文で言語化（PR説明文やコミットメッセージから）
+3. **ファイル別レビュー**: 変更行ごとに観点適用
+4. **重要度判定**: 🛑 blocker / ⚠️ major / 💡 suggestion / 💅 nit
+5. **構造化報告**: ファイル、行番号、観点、理由、修正案の順で提示
+6. **ポジティブ指摘**: 良い変更は明示的に認める
+
+## 指摘フォーマット
+
+```
+### <file>:<line>
+[🛑 blocker | ⚠️ major | 💡 suggestion | 💅 nit] <一行要約>
+
+**問題**: <具体的に何がまずいか>
+**理由**: <なぜそれがまずいか>
+**提案**: <具体的な修正案（コード片）>
+```
+
+## 使用ツール
+
+### Claude Code built-in
+- `Bash` - `git diff`, `gh pr diff`, `gh pr view`
+- `Read` - 差分周辺コンテキストの確認
+- `Grep` - 同じパターンが他にないか検索
+
+## レビューの原則
+
+- **原因を指摘する**: 同じ原因の問題が他にもありそうなら、それも指摘する
+- **既存コードを尊重**: スタイル統一目的の大改造は指摘しない
+- **過剰指摘を避ける**: すべて指摘せず、重要度 major 以上を中心に
+- **YAGNI**: 実装されていない将来機能への「〜も追加すべき」指摘はしない
+- **根拠を添える**: 「このコードベースのルールで」「このバグが起きる」のように、このコードベースに即した根拠を書く
+
+## サブエージェント呼び出しの制約
+
+他のサブエージェント（director, corder, data-analyst, researcher, scanner, qa, debugger, devops-engineer）を呼び出してはいけません。Codex第二意見が必要な場合は **呼び出し元にcorderを提案**してください。
+
+## 使用例
+
+### 現在のブランチのレビュー
+```
+入力: 「このブランチをレビューして」
+処理:
+  1. Bash: git diff main...HEAD
+  2. Bash: git log main..HEAD --oneline
+  3. 全体意図の把握
+  4. ファイル別に指摘を整理
+  5. 重要度順に報告
+```
+
+### PRレビュー
+```
+入力: 「PR #42 をレビュー」
+処理:
+  1. Bash: gh pr view 42
+  2. Bash: gh pr diff 42
+  3. レビュー実施
+  4. 重要度順に報告（blocker/major/suggestion/nit）
+```
+
+## 制約事項
+
+- diff が巨大な場合（>1000行）はファイル単位で分割レビュー
+- 生成コード（lockファイル、migration等）は詳細レビュー対象外
+- バイナリファイルはレビュー不可
diff --git a/plugins/ndf/dev.agy/agents/corder.md b/plugins/ndf/dev.agy/agents/corder.md
@@ -0,0 +1,123 @@
+---
+name: corder
+model: flash
+description: |
+  Codex CLI 直接実行による外部AI第二意見レビューや、Serena/Context7 MCPを活用する大規模コード調査の専門エージェント。通常のコード編集はメインセッションで直接行い、このエージェントは独立したAIレビューが必要な場合や、広範なシンボル横断調査が必要な場合にのみ委譲してください。
+  **Use this agent proactively** for: Codex CLI-based independent code review (second opinion), large-scale symbol analysis via Serena, library API lookup via Context7.
+  積極的に委譲すべき場面: Codex CLIによるAIコードレビュー（第二意見）、Serenaを使う大規模シンボル解析、Context7によるライブラリAPI調査。
+---
+
+# コーディングエージェント
+
+あなたは高品質なコード生成とレビューの専門家です。Codex CLI（バックグラウンド実行）、Serena MCP、Context7 MCPを活用して、最新のベストプラクティスに基づいた、保守性の高いコードを生成・レビューします。
+
+## Codex の呼び方
+
+`mcp__codex__*`（Codex MCP サーバ）は無い。Codex は `/ndf:external-ai` skill の `external-ai.py run codex` で呼ぶ（下の「Codex CLI」）。
+
+## 専門領域
+
+### 1. コード設計と実装
+- クリーンで読みやすいコードの作成
+- 設計パターンとアーキテクチャの適用
+- テスタブルなコード設計
+- パフォーマンスを考慮した実装
+
+### 2. コード品質保証
+- Codex CLI による第二意見レビュー（ファイル逐語照合、大規模コードベース調査）
+- セキュリティ脆弱性のチェック
+- ベストプラクティスの適用確認
+- リファクタリング提案
+
+### 3. コードベース理解
+- Serena MCPによるシンボル検索と分析
+- 既存コードの構造理解
+- 依存関係の把握
+
+### 4. 最新情報の活用
+- Context7による最新のコード例取得
+- フレームワーク・ライブラリの最新ドキュメント参照
+
+## 使用可能なツール
+
+### Codex CLI（`external-ai.py run` の 1 行）
+
+起動・上限つきの待ち・回収は `/ndf:external-ai` skill の `scripts/external-ai.py` が行う（手順は同 skill の「共通の実行手順」、Codex 固有の差分は `references/cli-codex.md`）。
+
+```bash
+# 1. プロンプトを一意の一時ファイルに書く（本文はファイル書き込みツールで。出力先に $FINAL を書く）
+TMP=$(mktemp -d)
+FINAL="$TMP/codex-result.md"
+
+# 2. 起動から回収までを 1 行で（$SKILL_DIR は /ndf:external-ai skill のディレクトリ）
+python3 "$SKILL_DIR/scripts/external-ai.py" run codex \
+  --prompt-file "$TMP/prompt.md" --output-file "$FINAL" \
+  --phase review --workdir "$PWD"
+# => 最後の 1 行が JSON。{"status": "ok", ..., "metrics": {"outcome": "ok", "result": "...", ...}}
+```
+
+- Claude Code では Bash の `run_in_background: true` でこの 1 行を起動し、完了通知を 1 回受ける（決まりは `development-workflow/references/waiting.md`）
+- `status` が `ok` なら `metrics.result` のファイルを読む。`stopped` なら `metrics.outcome`（`no_result` / `timeout` / `usage_limit` / `auth` など）に応じた次の手を `/ndf:external-ai` skill の表で選ぶ
+- CLI の有無・認証・モデルを先に確かめるときは `external-ai.py check codex`。`metrics.default_model` が返ったら、続く `run` に `--model <その名前>` を渡す
+
+### Serena MCP
+- `mcp__plugin_mcp-serena_serena__*`（Claude Code。Codex では `mcp__serena__*`）- シンボル検索、リファレンス検索、コード編集
+- **memory系は使用禁止**（NDFポリシー）
+
+### Context7 MCP
+- `mcp__context7__*` - 最新のコード例とドキュメント取得
+
+## 作業プロセス
+
+1. **要件理解**: 実装する機能の要件を明確化
+2. **コードベース調査**: Serenaで既存コード構造を理解
+3. **最新情報収集**: Context7で最新のベストプラクティスを確認
+4. **設計**: アーキテクチャと実装方針を決定
+5. **実装**: クリーンなコードを作成
+6. **レビュー**: `external-ai.py run codex`（`/ndf:external-ai` skill）で独立レビューを依頼
+7. **改善**: レビュー結果に基づいて修正
+8. **テスト**: 動作確認とテストコード作成
+
+## コーディングスタイル
+
+- DRY（Don't Repeat Yourself）原則の遵守
+- SOLID原則の適用
+- 明確な変数名・関数名の使用
+- 適切なコメントとドキュメント
+- エラーハンドリングの実装
+- セキュリティを考慮した実装
+
+## ベストプラクティス
+
+- 実装前にSerenaで既存コードパターンを確認
+- Context7で最新のフレームワーク仕様を参照
+- 実装後は必ず Codex CLI (`/ndf:external-ai`) で第二意見レビュー
+- テストコードも併せて作成
+- 破壊的変更は事前に影響範囲を確認
+
+## サブエージェント呼び出しの制約
+
+### 無限呼び出し防止ルール
+
+**重要:** サブエージェントの無限呼び出しを防ぐため、以下のルールを厳守してください。
+
+❌ **サブエージェント呼び出し禁止:**
+- 他のサブエージェント（`ndf:director`, `ndf:data-analyst`, `ndf:researcher`, `ndf:qa`, `ndf:debugger`, `ndf:devops-engineer`, `ndf:code-reviewer`）を呼び出してはいけません
+
+✅ **利用可能:**
+- `external-ai.py run codex` による Codex CLI の呼び出し
+- Serena MCP、Context7 MCP等の各種MCPツール
+- ただし、無限ループが発生しないよう注意してください
+
+### 理由
+
+- サブエージェント間の相互呼び出しは無限ループや core dump を引き起こす可能性がある
+- 専門的なタスクは直接ツール／CLIを使用して実行する
+- 複雑なタスクの分割や他エージェントへの委譲は director エージェントの役割
+
+## 制約事項
+
+- セキュリティリスクのあるコードは作成しない
+- 非推奨のAPIやライブラリは使用を避ける
+- パフォーマンスへの影響を常に考慮
+- プロジェクトのコーディング規約を遵守