Skip to content
Merged
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
2 changes: 0 additions & 2 deletions .github/workflows/runtime-plugin-authenticated-smoke.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,6 @@ on:
- all
- claude
- codex
- kiro
- agy

jobs:
authenticated-smoke:
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/runtime-plugin-smoke-latest.yml
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ jobs:
strategy:
fail-fast: false
matrix:
runtime: [claude, codex, kiro, agy]
runtime: [claude, codex]
env:
RUNTIME: ${{ matrix.runtime }}
LATEST_VERSIONS: tmp/runtime-smoke-latest/cli-versions.env
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/runtime-plugin-smoke.yml
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ jobs:
strategy:
fail-fast: false
matrix:
runtime: [claude, codex, kiro, agy]
runtime: [claude, codex]
env:
SKIP_HEAVY: ${{ needs.ci-scope.outputs.skip == 'true' }}
steps:
Expand Down
4 changes: 2 additions & 2 deletions .ndf/pace.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,12 @@
"fast": {
"enabled": true,
"modes": ["light", "standard", "legacy-refactor"],
"verify": "python3 plugins/ndf/scripts/release-verification-steps.py verify-install --ref develop --runtimes claude,codex,kiro"
"verify": "python3 plugins/ndf/scripts/release-verification-steps.py verify-install --ref develop --runtimes claude,codex"
},
"auto": {
"enabled": true,
"modes": ["light", "standard", "legacy-refactor"],
"verify": "python3 plugins/ndf/scripts/release-verification-steps.py verify-install --ref develop --runtimes claude,codex,kiro"
"verify": "python3 plugins/ndf/scripts/release-verification-steps.py verify-install --ref develop --runtimes claude,codex"
},
"areas": [
{"name": "駆動", "common": true,
Expand Down
4 changes: 1 addition & 3 deletions .ndf/project.json
Original file line number Diff line number Diff line change
Expand Up @@ -192,10 +192,8 @@
"required-checks-check",
"runtime-plugin-build-check",
"runtime-plugin-validate",
"runtime-smoke (agy)",
"runtime-smoke (claude)",
"runtime-smoke (codex)",
"runtime-smoke (kiro)",
"script-structure-check",
"skill-frontmatter-check",
"skill-repo-assumptions-check",
Expand All @@ -209,7 +207,7 @@
},
"delivery": [
{
"target": "ndf プラグイン(Claude Code・Codex・Kiro)",
"target": "ndf プラグイン(Claude Code・Codex)",
"kind": "manual",
"trigger": "release の工程で版を上げ、main へマージしてタグ ndf--v<版> を打つ",
"branch": "main",
Expand Down
2 changes: 1 addition & 1 deletion .ndf/supervise.json
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,6 @@
"release": {
"form": "package-plugin",
"plugin": "ndf",
"runtimes": ["claude", "codex", "kiro"]
"runtimes": ["claude", "codex"]
}
}
19 changes: 9 additions & 10 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## プロジェクト概要

**Claude Code / Codex / Kiro CLI / agy 向けプラグインマーケットプレイス**の開発プロジェクトです。チーム全体で AI 開発ツールの導入を加速するための事前設定されたプラグインを提供します。
**Claude Code / Codex 向けプラグインマーケットプレイス**の開発プロジェクトです。Kiro CLI と agy へは配らず、cross-review / cross-refactoring の相手役として起動するだけです。チーム全体で AI 開発ツールの導入を加速するための事前設定されたプラグインを提供します。

**リポジトリ**: https://github.com/devbasex/ai-plugins

Expand Down Expand Up @@ -116,15 +116,15 @@ ai-plugins/
├── .claude-plugin/
│ └── marketplace.json # マーケットプレイス定義(必須)
├── plugins/
│ ├── ndf/ # NDF(4ランタイム共通の単一ディレクトリ)
│ ├── playwright-kit/ # playwright-kit(3ランタイム共通の単一ディレクトリ)
│ ├── ndf/ # NDF(Claude Code・Codex 共通の単一ディレクトリ)
│ ├── playwright-kit/ # playwright-kit(Claude Code・Codex 共通の単一ディレクトリ)
│ └── mcp/
│ └── mcp-*/ # MCPプラグイン10個(3ランタイム共通)
│ └── mcp-*/ # MCPプラグイン10個(Claude Code・Codex 共通)
├── docs/ # リポジトリ知識
├── factory/ # Web サービス(Neural Development Factory)。プラグインと分け、自分の LICENSE を持つ
├── AGENTS.md # 共通エントリポイント
├── CLAUDE.md # Claude Code固有設定
├── KIRO.md # Kiro CLI固有設定
├── KIRO.md # 相手役として起動される Kiro CLI の説明
└── README.md # プロジェクト説明
```

Expand All @@ -144,16 +144,15 @@ ai-plugins/
| [docs/articles/](docs/articles/README.md) | 社外ブログへ載せる記事の正本。**書いた日時点の記録で、以後の構成変更には追随しない** |
| [docs/claude-code-skills-survey/](docs/claude-code-skills-survey/01-findings.md) | Claude Code Skills調査レポート(3 本) |
| [docs/development-history/](docs/development-history/) | 2026-09-02 までの開発履歴と知見。**以降の振り返りは、起点の issue か Pull Request のコメントに残す**(`/ndf:retrospective`) |
| [plugins/ndf/README.md](plugins/ndf/README.md) | NDFプラグイン(4ランタイム共通) |
| [plugins/ndf/README.md](plugins/ndf/README.md) | NDFプラグイン(Claude Code・Codex 共通) |

## NDFプラグインについて

**NDFプラグイン**は、このマーケットプレイスの主要プラグインです。plugin 名は全ランタイムで `ndf` を維持し、配布物は `plugins/ndf/` の1ディレクトリにまとまっています。
- Skill の実体は `plugins/ndf/skills/` の1箇所。配布先は `plugins/ndf/manifests/*-skills.txt` が決める
**NDFプラグイン**は、このマーケットプレイスの主要プラグインです。plugin 名は Claude Code・Codex のどちらでも `ndf` を維持し、配布物は `plugins/ndf/` の1ディレクトリにまとまっています。
- Skill の実体は `plugins/ndf/skills/` の1箇所。配布先は Claude Code と Codex の 2 つで、配る Skill は `plugins/ndf/manifests/{claude,codex}-skills.txt` が決める
- Claude Code版は専門サブエージェントと実行主体(supervisor・worker)の定義(`plugins/ndf/agents/`)、公開Skills、PreToolUse/SessionStart/Stopフックを提供
- Codex版は Codex向け公開Skillsと任意Slack通知hookを提供
- Kiro版は `plugins/ndf/dev.kiro/install.sh` で `.kiro/skills/`、`.kiro/steering/ndf-policies.md`、`.kiro/agents/ndf.json` を生成
- agy版は `plugins/ndf/dev.agy/` を `agy plugin install` で導入し、公開Skills・エージェント定義・PreToolUse/PreInvocationフックを提供
- Kiro CLI と agy へは何も配らない。cross-review のレビュー担当、cross-refactoring の提案・実装の担当(相手役)として、ホスト(Claude Code・Codex)から CLI プロセスで起動する。相手役が読む手順書はホストの導入先から担当の worktree へ写す(起動の形の正本は `plugins/ndf/skills/external-ai/references/cli-kiro.md`・`cli-agy.md`)
- 外部AI委譲は `/ndf:external-ai` skill と `corder` エージェント経由で Codex / agy を呼び出す

詳細は各 runtime README と `docs/ndf-plugin-reference.md` を参照。
Expand Down
58 changes: 9 additions & 49 deletions KIRO.md
Original file line number Diff line number Diff line change
@@ -1,57 +1,17 @@
# AI Plugins - Kiro CLI開発ガイドライン
# AI Plugins - Kiro CLI の扱い

共通の開発ガイドラインは **@AGENTS.md** を参照してください。

このファイルにはKiro CLI固有の設定のみを記載します。
このファイルには Kiro CLI に固有のことだけを書きます。

## NDFプラグインのセットアップ
## 配布しない。相手役として起動する

### 前提条件
- Kiro CLI がインストール済み
- Node.js(Slack通知を使う場合)
- Codex CLI(`/ndf:external-ai` skill で外部AI委譲を使う場合、または `--with-codex` で Kiro に Codex MCP サーバ設定を生成する場合): `npm install -g @openai/codex`
NDF とマーケットプレイスのプラグインは Kiro CLI へ配りません(配布先は Claude Code と Codex)。Kiro CLI は、cross-review のレビュー担当と cross-refactoring の提案・実装の担当(相手役)として、ホスト(Claude Code・Codex)から CLI プロセスで起動されるだけです。

### インストール
- 起動の形(`kiro-cli chat --no-interactive --trust-all-tools …`)の正本は `plugins/ndf/skills/external-ai/references/cli-kiro.md` にあります
- 相手役に `--agent` は渡しません。相手役が読む手順書は、ホストの導入先から担当の worktree の `.kiro/skills/` へ写します(`plugins/ndf/skills/cross-refactoring/scripts/prepare-worktrees.sh`)
- 相手役に使えるかは `.ndf/runtimes.json` と `kiro-cli` の認証で決まります

```bash
# 基本(Skills + agentSpawn / userPromptSubmit フック)
bash plugins/ndf/dev.kiro/install.sh
## 既に Kiro CLI へ NDF を入れた利用者

# Slack通知も有効化
bash plugins/ndf/dev.kiro/install.sh --with-slack

# 全部入り(Slack通知 + Kiro 側 Codex MCP 設定生成)
# 注: NDF の外部 AI 委譲は /ndf:external-ai skill が CLI を直接実行し、Codex MCP に依存しない。
# --with-codex は Kiro セッションで `mcp__codex__*` を直接呼びたい場合だけ付ける
# (Codex MCP サーバの設定と .kiro/prompts/codex.md を追加する)。
bash plugins/ndf/dev.kiro/install.sh --with-slack --with-codex
```

インストーラーは `plugins/ndf/skills/` から `.kiro/skills/` への symlink、`.kiro/steering/ndf-policies.md`、`.kiro/agents/ndf.json` を生成します。リンクする Skill は `plugins/ndf/manifests/kiro-skills.txt` が決めます。`ndf-policies` だけは steering の生成元として使い、`.kiro/skills/` へは symlink しません(Skill と steering の二重注入を避けるため)。

`.kiro/agents/ndf.json` の `hooks` には worktree 運用の 2 つが入ります。

| hook | 実行するもの | 起きること |
|---|---|---|
| `agentSpawn` | `scripts/worktree-session.sh` | メインディレクトリに残った未コミット変更の提示。ブランチの追従は既定では行わず、`.ndf/worktree.json` の `follow_branch: true` で有効にする |
| `userPromptSubmit` | `scripts/worktree-guard.sh` | worktree で作業する旨の案内 |

Kiro CLI では tool 実行前の hook を使いません。この事象でモデルへ案内を渡す手段が終了コード 2 に限られ、それが tool の実行を拒否するためです。拒否しない方針のもとでは置けないため、パスを見ない案内をプロンプト送信時の hook が担います。

**どちらもリポジトリ側に `.ndf/worktree.json` があるときだけ動きます。** 無ければ何も出力せず終了コード 0 で終わります。書き方は `plugins/ndf/README.md` の「Hooks」節にあります。

### Slack通知の設定(オプション)

`.env` に以下を設定:
```
SLACK_CHANNEL_ID=C0123456789
SLACK_BOT_TOKEN=xoxb-...
SLACK_USER_MENTION=<@U0123456789>
```

### 利用方法

- スキルはdescriptionのキーワードに基づいて自動参照されます
- ワークフロー系スキル(pr, fix, review等)は手動で指示してください
- 例: 「prスキルの手順に従ってPRを作成して」
- `plugins/ndf/manifests/kiro-skills.txt` に skill が追加された場合、再度インストーラーを実行してください
配布を終えた版より前に `plugins/ndf/dev.kiro/install.sh` で入れた手元の残し方と消し方は、`plugins/ndf/README.md` の「agy・Kiro CLI への配布の終了」にあります。
35 changes: 8 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# AI Plugins

Claude Code / Codex / Kiro CLI / agy で使うプラグインを配るマーケットプレイスです。
Claude Code / Codex で使うプラグインを配るマーケットプレイスです。
入れると、Pull Request の作成・レビュー・修正といった開発の作業を、手順どおりに AI へ任せられます。
よく使う外部サービス(Notion・BigQuery・データベースなど)へつなぐ設定も入ります。

Expand All @@ -22,29 +22,10 @@ codex plugin marketplace add https://github.com/devbasex/ai-plugins
codex plugin add ndf@ai-plugins
```

### Kiro CLI
### Kiro CLI と agy

Kiro CLI はマーケットプレイスから入れられません。clone したディレクトリでインストーラーを実行します。

```bash
git clone https://github.com/devbasex/ai-plugins.git
cd ai-plugins
bash plugins/ndf/dev.kiro/install.sh
```

起動の方法は [plugins/ndf/README.md の「Kiro CLI」](./plugins/ndf/README.md#kiro-cli) にあります。

### agy

agy もマーケットプレイスから入れられません。clone したディレクトリから導入します。

```bash
git clone https://github.com/devbasex/ai-plugins.git
cd ai-plugins
agy plugin install plugins/ndf/dev.agy
```

hook を効かせる手順は [plugins/ndf/README.md の「agy」](./plugins/ndf/README.md#agy) にあります。
Kiro CLI と agy へはプラグインを配りません。cross-review と cross-refactoring が、別の AI の意見を得る相手役として CLI を起動するだけです(Claude Code か Codex に ndf を入れれば使えます)。
前の版で入れた手元の扱いは [plugins/ndf/README.md の「agy・Kiro CLI への配布の終了」](./plugins/ndf/README.md#agykiro-cli-への配布の終了) にあります。

更新の方法と Slack 通知の設定は [plugins/ndf/README.md](./plugins/ndf/README.md) にあります。

Expand All @@ -67,10 +48,10 @@ Claude Code では `/ndf:<Skill 名>` と打って呼びます。**Skill** は

| プラグイン名 | バージョン | できること | 詳細 |
| --- | --- | --- | --- |
| **ndf** | 10.27.3 | 開発の作業手順(Skill)と専門のサブエージェント。4 つの AI ツールへ同じ名前で入る | [README](./plugins/ndf/README.md) |
| **ndf** | 10.27.3 | 開発の作業手順(Skill)と専門のサブエージェント。Claude Code と Codex へ同じ名前で入る | [README](./plugins/ndf/README.md) |
| **playwright-kit** | 3.0.2 | Playwright による E2E テストの計画・スクリプト作成・証跡のレポート | [README](./plugins/playwright-kit/README.md) |

外部サービスへつなぐ MCP サーバーの設定のプラグインが 10 個あります(Claude Code / Codex / Kiro CLI 向け)。
外部サービスへつなぐ MCP サーバーの設定のプラグインが 10 個あります(Claude Code / Codex 向け)。
使うものだけを入れます(Claude Code なら `/plugin install <プラグイン名>@ai-plugins`)。

| プラグイン名 | つなぐ先 |
Expand All @@ -89,7 +70,7 @@ Claude Code では `/ndf:<Skill 名>` と打って呼びます。**Skill** は
### NDF プラグインの Skill の一覧

**NDFプラグイン v10.27.3** に入る Skill の数は、AI ツールごとに違います。
Claude Code向け core 49個、Kiro向け core 46個、Codex向け core 45個、agy向け core 45個です。
Claude Code向け core 49個、Codex向け core 45個です。
元Skills(49個)の内訳は次のとおりです。
- Pull Request とレビュー (7): pr, pr-tests, fix, pr-review, cherry-pick-pr, deploy, merged
- 開発の進め方 (17): development-workflow, requirements-design, design, document-rebuild, document-sources, document-drafting, tdd-cycle, refactoring, quality-gates, release, release-verification, retrospective, out-of-scope, progress-tracking, backlog-refinement, layout-review, estimate
Expand All @@ -105,7 +86,7 @@ Skill のほかに、次のものが入ります。
| 部品 | できること |
| --- | --- |
| サブエージェント(Claude Code) | 調査・データ分析・デバッグ・コードレビュー・CI/CD などを任せる専門のサブエージェント 8 個 |
| 外部 AI への委譲 | Codex や agy をバックグラウンドで動かし、別の AI の意見を得る |
| 外部 AI への委譲 | Codex・Kiro CLI・agy をバックグラウンドで動かし、別の AI の意見を得る |
| hook | 会話の記録を 90 日以上残す。回答や承認を待つときに Slack へ知らせる。リポジトリに `.ndf/worktree.json` があるときは git worktree での作業を案内する |

## もっと知る
Expand Down
Loading
Loading