fix: Kiro の導入方式を修正しエージェント定義を有効にする (0-9)

AGENTS.md

@@ -77,7 +77,7 @@ ai-plugins/
 - 共通編集元は `plugins/ndf-shared/`
 - Claude Code版は 8個の専門サブエージェント、公開Skills、SessionStart/Stopフックを提供
 - Codex版は Codex向け公開Skillsと任意Slack通知hookを提供
-- Kiro版は installer で `.kiro/skills/` と `.kiro/agents/default.json` を生成
+- Kiro版は installer で `.kiro/skills/`、`.kiro/steering/ndf-policies.md`、`.kiro/agents/ndf.json` を生成
 - 外部AI委譲は `/ndf:external-ai` skill と `corder` エージェント経由で Codex / Gemini CLI を呼び出し（v4.0.0 で Codex MCP サーバは廃止）
 
 詳細は各 runtime README と `docs/ndf-plugin-reference.md` を参照。

KIRO.md

@@ -27,7 +27,7 @@ bash plugins/ndf-kiro/install.sh --with-slack
 bash plugins/ndf-kiro/install.sh --with-slack --with-codex
 ```
 
-インストーラーは `plugins/ndf-kiro/skills/` から `.kiro/skills/` への symlink と `.kiro/agents/default.json` を生成します。`plugins/ndf-kiro/skills/` は `plugins/ndf-shared/manifests/kiro-skills.txt` から build された生成物です。
+インストーラーは `plugins/ndf-kiro/skills/` から `.kiro/skills/` への symlink、`.kiro/steering/ndf-policies.md`、`.kiro/agents/ndf.json` を生成します。`plugins/ndf-kiro/skills/` は `plugins/ndf-shared/manifests/kiro-skills.txt` から build された生成物です。`ndf-policies` だけは steering の生成元として使い、`.kiro/skills/` へは symlink しません（Skill と steering の二重注入を避けるため）。
 
 ### Slack通知の設定（オプション）
 
@@ -66,7 +66,7 @@ ls -la plugins/ndf-kiro/
 code search_symbols "ndf"
 
 # 特定のファイル内のシンボル一覧
-code get_document_symbols plugins/ndf-kiro/agents/default.json.template
+code get_document_symbols plugins/ndf-kiro/agents/ndf.json.template
 ```
 
 **パターン検索**:
@@ -82,7 +82,7 @@ grep "MCP" --include="*.md"
 
 ```
 # ファイル全体を読む
-fs_read plugins/ndf-kiro/agents/default.json.template
+fs_read plugins/ndf-kiro/agents/ndf.json.template
 
 # 特定の行範囲を読む
 fs_read plugins/ndf-kiro/README.md --start_line=1 --end_line=50

README.md

@@ -77,7 +77,7 @@ bash plugins/ndf-kiro/install.sh --with-slack
 bash plugins/ndf-kiro/install.sh --with-slack --with-codex
 ```
 
-インストーラーは `plugins/ndf-kiro/skills/` から `.kiro/skills/` への symlink と `.kiro/agents/default.json` を生成します。
+インストーラーは `plugins/ndf-kiro/skills/` から `.kiro/skills/` への symlink、`.kiro/steering/ndf-policies.md`、`.kiro/agents/ndf.json` を生成します。
 
 #### 3. Slack通知の設定（オプション）
 
@@ -91,9 +91,11 @@ SLACK_USER_MENTION=<@U0123456789>
 #### 4. 起動
 
 ```bash
-kiro-cli chat
+kiro-cli chat --agent ndf
 ```
 
+既定エージェントとして使いたい場合は `bash plugins/ndf-kiro/install.sh --set-default` を実行します。
+
 詳細は [KIRO.md](./KIRO.md) を参照。
 
 ### 利用可能なプラグイン

docs/ndf-plugin-reference.md

@@ -34,7 +34,7 @@ plugins/
 │ └── scripts/
 └── ndf-kiro/
  ├── install.sh
- ├── agents/default.json.template
+ ├── agents/ndf.json.template
  ├── prompts/
  ├── skills/
  └── scripts/

docs/specifications/ndf-knowledge-and-kiro.md

@@ -27,9 +27,9 @@ AI エージェント向けの知識は以下の層で管理する。
 
 ## Kiro CLI 対応
 
-Kiro CLI 用設定は `.kiro/agents/default.json` で管理する。agent 設定は `AGENTS.md` と `README.md` を `file://` resource として読み込み、`.kiro/skills/**/SKILL.md` を `skill://` resource として参照する。
+Kiro CLI 用設定は `.kiro/agents/ndf.json` で管理する。agent 設定は `AGENTS.md` と `README.md` を `file://` resource として読み込む。`.kiro/skills/**/SKILL.md` の `skill://` 指定は組み込み agent の読み込み対象と重複するため持たない。常時適用したい指示は agent 選択に依存しない `.kiro/steering/ndf-policies.md` へ置く。
 
-Kiro CLI では `plugins/ndf-kiro/install.sh` が `plugins/ndf-kiro/skills/` から `.kiro/skills/` への symlinkと `.kiro/agents/default.json` を生成する。`agentSpawn` hook は初期化時の案内に使い、`--with-slack` 指定時のみ `stop` hook 相当の Slack 通知を有効化する。Kiro の stop hook payload に `assistant_response` が含まれる場合、`plugins/ndf-kiro/scripts/slack-notify.js` は transcript よりも `assistant_response` を優先して要約に使う。
+Kiro CLI では `plugins/ndf-kiro/install.sh` が `plugins/ndf-kiro/skills/` から `.kiro/skills/` への symlink、`.kiro/steering/ndf-policies.md`、`.kiro/agents/ndf.json` を生成する。`ndf-policies` は steering の生成元としてのみ使い、`.kiro/skills/` へは symlink しない。Kiro は `.kiro/skills/*/SKILL.md` と `.kiro/steering/**/*.md` の両方を文脈へ読み込むため、両方に置くと同じ内容が 2 回注入されるからである。manifest（`plugins/ndf-shared/manifests/kiro-skills.txt`）には steering の生成元として残す。`--scope global` を指定した場合の生成先は `~/.kiro/` 配下になる。生成した agent は既定にならないため、`--set-default` を指定したときだけ `kiro-cli agent set-default ndf` を実行する。`kiro-cli` は workspace agent を cwd 配下の `.kiro/agents/` からのみ検出するため、この呼び出しは導入先（`workspace` なら `--project` のパス、`global` なら `$HOME`）で行い、`agent list` で反映を検証する（`set-default` は agent 未検出でも終了コード 0 を返すため）。`agentSpawn` hook は初期化時の案内に使い、`--with-slack` 指定時のみ `stop` hook 相当の Slack 通知を有効化する。Kiro の stop hook payload に `assistant_response` が含まれる場合、`plugins/ndf-kiro/scripts/slack-notify.js` は transcript よりも `assistant_response` を優先して要約に使う。
 
 Codex 連携は MCP サーバではなく `/ndf:external-ai` skill と `corder` エージェント経由の Codex CLI 直接実行を標準とする。Kiro 用 `--with-codex` は Kiro セッションから Codex CLI を扱う場合の補助設定である。
 
@@ -38,14 +38,15 @@ Codex 連携は MCP サーバではなく `/ndf:external-ai` skill と `corder`
 | 設定 | 用途 |
 |---|---|
 | `cleanupPeriodDays` | Claude Code transcript 保持期間。NDF hook が 90 日以上に保つ |
-| `.kiro/agents/default.json` | Kiro CLI 用 agent 設定 |
+| `.kiro/agents/ndf.json` | Kiro CLI 用 agent 設定 |
+| `.kiro/steering/ndf-policies.md` | agent 選択に依存しない常時指示 |
 | `.kiro/skills/` | Kiro CLI 用 Skill symlink 配置 |
 
 ## 外部連携
 
 | 連携 | 仕様 |
 |---|---|
-| Kiro CLI | `.kiro/agents/default.json` と `.kiro/skills/` で Skill / hook / MCP 設定を提供 |
+| Kiro CLI | `.kiro/agents/ndf.json`、`.kiro/steering/`、`.kiro/skills/` で Skill / hook / MCP 設定を提供 |
 | Serena MCP | `mcp-serena` プラグインとして分離提供 |
 | Codex CLI | `/ndf:external-ai` skill と `corder` エージェントから直接実行 |
 | Slack | Claude Code / Kiro / Codex の終了通知に使用 |
@@ -54,7 +55,7 @@ Codex 連携は MCP サーバではなく `/ndf:external-ai` skill と `corder`
 
 | 領域 | 確認内容 |
 |---|---|
-| Kiro CLI | `.kiro/agents/default.json` が resources / hooks / mcpServers を持つこと |
+| Kiro CLI | `.kiro/agents/ndf.json` が resources と hooks を持ち、`kiro-cli agent list` に `ndf` が現れること。`mcpServers` は `--with-codex` 指定時、または既存の利用者管理設定を引き継いだ場合にのみ現れる |
 | ドキュメント | `AGENTS.md` / `CLAUDE.md` / `KIRO.md` / `docs/` の役割が重複しすぎていないこと |
 
 ## 関連リンク

docs/specifications/runtime-plugin-container-smoke.md

@@ -98,6 +98,7 @@ Kiro adapter は以下を実行する。
 | `assert-plugin-files.sh` | runtime 側の install 先に plugin manifest、Skill、hook、agent / prompt / MCP runtime link が存在することを確認する |
 | `assert-mcp-config.sh` | `mcp-bigquery` config に `BIGQUERY_PROJECT`、`BIGQUERY_LOCATION`、`BIGQUERY_DATASET`、`BIGQUERY_KEY_FILE` の placeholder があり、secret 実値や `/tmp/runtime-secrets` が混入していないことを確認する |
 | `assert-hook-fixtures.sh` | fixture payload で Claude / Codex / Kiro の hook script を非認証実行できることを確認する |
+| `assert-kiro-agent.sh` | Kiro の `ndf` エージェント定義と steering を検査する。`kiro-cli` が使える場合は `agent list` に `ndf` が現れること、`--set-default` で既定が切り替わることも確認し、確認後に既定を元へ戻す。文脈ファイルの合計文字数が予算内であることも検査する |
 | `assert-authenticated-smoke.sh` | `--with-secrets` が有効な場合に、利用可能な runtime / BigQuery secret で認証付き smoke を実行する |
 | `assert-no-host-contamination.sh` | `HOME` と project が `/tmp/runtime-*` 配下であり、repo root や host-like credential path が汚染されていないことを確認する |
 

docs/specifications/runtime-plugin-distribution.md

@@ -31,7 +31,7 @@ NDF plugin の plugin name は全 runtime で `ndf` を維持する。旧 `plugi
 |---|---|---|
 | Claude Code | `plugins/ndf-claude/.claude-plugin/plugin.json` | Claude Code agents、hooks、skills、scripts |
 | Codex | `plugins/ndf-codex/.codex-plugin/plugin.json` | Codex 用 skills、hooks、scripts |
-| Kiro CLI | `plugins/ndf-kiro/install.sh` | `.kiro/agents/default.json`、`.kiro/skills/` symlink、prompts、任意 hook |
+| Kiro CLI | `plugins/ndf-kiro/install.sh` | `.kiro/agents/ndf.json`、`.kiro/steering/ndf-policies.md`、`.kiro/skills/` symlink、prompts、任意 hook |
 
 `plugins/ndf-shared/manifests/{claude,codex,kiro}-skills.txt` は runtime ごとの配布 Skill 一覧を定義する。`scripts/build-runtime-plugins.sh` はこの manifest を読み、`plugins/ndf-shared/skills` から各 runtime の `skills/` へ同期する。
 
@@ -60,6 +60,8 @@ Claude 用配布物は `.claude-plugin/plugin.json` と `.mcp.json` を持つ。
 
 Kiro MCP installer は対象 project の `.mcp.json` へ MCP server 設定を merge する。hooks や skills を持つ MCP plugin では、必要に応じて `.kiro/agents/default.json` や `.kiro/skills/` も更新する。
 
+NDF installer が生成する agent は `.kiro/agents/ndf.json` であり、MCP installer が更新する `.kiro/agents/default.json` とは別である。NDF と Kiro MCP plugin を併用する場合、MCP server 設定は `ndf.json` へ写す必要がある（`plugins/ndf-kiro/README.md`「旧バージョンからの移行」）。MCP installer 側の出力先統一は未対応。
+
 ## Marketplace
 
 Claude Code marketplace は `.claude-plugin/marketplace.json` で管理する。各 entry の `source` は Claude 用配布ディレクトリを指す。