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
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
29 changes: 19 additions & 10 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## プロジェクト概要

**Claude Codeプラグインマーケットプレイス**の開発プロジェクトです。チーム全体でClaude Codeの導入を加速するための事前設定されたプラグインを提供します
**Claude Code / Codex / Kiro CLI 向けプラグインマーケットプレイス**の開発プロジェクトです。チーム全体で AI 開発ツールの導入を加速するための事前設定されたプラグインを提供します

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

Expand Down Expand Up @@ -40,8 +40,15 @@ ai-plugins/
├── .claude-plugin/
│ └── marketplace.json # マーケットプレイス定義(必須)
├── plugins/
│ ├── ndf/ # NDFプラグイン(メイン)
│ └── {plugin-name}/ # その他のプラグイン
│ ├── ndf-shared/ # NDF共通編集元(直接installしない)
│ ├── ndf-claude/ # Claude Code版NDF
│ ├── ndf-codex/ # Codex版NDF
│ ├── ndf-kiro/ # Kiro CLI版NDF
│ └── mcp/
│ ├── shared/ # MCPプラグイン共通編集元
│ ├── claude/ # Claude Code版MCP配布物
│ ├── codex/ # Codex版MCP配布物
│ └── kiro/ # Kiro CLI版MCP配布物
├── docs/ # リポジトリ知識
├── AGENTS.md # 共通エントリポイント
├── CLAUDE.md # Claude Code固有設定
Expand All @@ -59,18 +66,20 @@ ai-plugins/
| [docs/specifications/](docs/specifications/) | 完了済みplan/issue由来の確定仕様 |
| [docs/claude-code-skills-survey.md](docs/claude-code-skills-survey.md) | Claude Code Skills調査レポート |
| [docs/development-history/](docs/development-history/) | 開発履歴と知見 |
| [plugins/ndf/README.md](plugins/ndf/README.md) | NDFプラグインドキュメント |
| [plugins/ndf-claude/README.md](plugins/ndf-claude/README.md) | Claude Code版NDFプラグイン |
| [plugins/ndf-codex/README.md](plugins/ndf-codex/README.md) | Codex版NDFプラグイン |
| [plugins/ndf-kiro/README.md](plugins/ndf-kiro/README.md) | Kiro CLI版NDF installer |

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

**NDFプラグイン**は、このマーケットプレイスの主要プラグインです(v4.19.0)
- 8個の専門サブエージェント(director、data-analyst、corder、researcher、qa、debugger、devops-engineer、code-reviewer)
- 49個のsource Skills(PR/コードレビューワークフロー、AIクロスレビュー (codex/gemini)、plan-to-spec確定仕様化、原則・ガイドライン、MLモデル構造標準 (ml-model-structure)、issue→multi-PR ワークフロー戦略、SQL最適化、データエクスポート、skill利用統計、statusline切替 (/ndf:statusline)、Codex CLI連携、Playwrightシナリオテスト (CDPリモート接続・Google Driveエビデンス保管含む)、Google Drive/Chat連携 等)
- SessionStartフック(transcript保持期間自動管理 `cleanupPeriodDays >= 90`、statusLine未設定時のNDF標準statusline自動設定)
- Stopフック(AI要約生成 + 自動Slack通知)
**NDFプラグイン**は、このマーケットプレイスの主要プラグインです(v4.19.0)。plugin 名は全ランタイムで `ndf` を維持し、配布物は `plugins/ndf-claude` / `plugins/ndf-codex` / `plugins/ndf-kiro` に分離しています。
- 共通編集元は `plugins/ndf-shared/`
- Claude Code版は 8個の専門サブエージェント、公開Skills、SessionStart/Stopフックを提供
- Codex版は Codex向け公開Skillsと任意Slack通知hookを提供
- Kiro版は installer で `.kiro/skills/` と `.kiro/agents/default.json` を生成
- 外部AI委譲は `/ndf:codex` skill と `corder` エージェント経由で Codex CLI を呼び出し(v4.0.0 で Codex MCP サーバは廃止)

詳細は `plugins/ndf/README.md` および `docs/ndf-plugin-reference.md` を参照。
詳細は各 runtime README `docs/ndf-plugin-reference.md` を参照。

## ベストプラクティス

Expand Down
29 changes: 14 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ Claude Code / Codex / Kiro CLI向けのスキル・MCP設定を共有するた

このマーケットプレイスは、チーム全体でAI開発ツール(Claude Code / Codex / Kiro CLI)の導入を加速するための事前設定されたプラグインを提供します。

**NDFプラグイン v4.19.0** は、以下の機能を**オールインワン**で提供する統合プラグインです:
**NDFプラグイン v4.19.0** は、同じ `ndf@ai-plugins` という名前で Claude Code / Codex / Kiro CLI へ配布されるランタイム別プラグインです。共通ソースは `plugins/ndf-shared/` に集約し、利用者が install する配布物は `plugins/ndf-claude/` / `plugins/ndf-codex/` / `plugins/ndf-kiro/` に分かれています。

- **公開Skills**: Claude Code向け core 29個、Kiro向け core 28個、Codex向け core 30個に分離。`skills-optional/` にランタイム別の除外候補を整理。
- **公開Skills**: Claude Code向け core 29個、Kiro向け core 28個、Codex向け core 30個に分離。
- **元Skills(49個)**:
- PR/レビューワークフロー (13): pr, pr-tests, fix, review, review-branch, review-pr-comments, resolve-pr-comments, cherry-pick-pr, deploy, sync-main, merged, clean, browser-test
- 原則・ガイドライン (10): ndf-policies, branch-fix-strategy, implementation-plan, plan-to-spec, investigation-rules, problem-solving, logging-guidelines, markdown-writing, issue-plan-strategy, ml-model-structure
Expand All @@ -21,7 +21,8 @@ Claude Code / Codex / Kiro CLI向けのスキル・MCP設定を共有するた
- **自動フック**: SessionStart (transcript保持期間を最低90日に保つ) + Stop (AI要約生成+Slack通知)
- **外部AI委譲**: `/ndf:codex` skill + `corder` エージェント経由で Codex CLI をバックグラウンド実行 (v4.0.0 で Codex MCP サーバは廃止)
- **AIクロスレビュー強化**: `/ndf:cross-review` は codex/gemini 両方に PR レビューを委譲し、Gemini の進捗 heartbeat、`--focus` / `--extra-instructions-file`、PR 種別別の自動レビュー観点テンプレートに対応
- **Kiro CLI対応**: インストーラーによるワンコマンドセットアップ
- **Kiro CLI対応**: `plugins/ndf-kiro/install.sh` によるワンコマンドセットアップ
- **MCPプラグイン**: `plugins/mcp/shared/` を編集元とし、Claude / Codex / Kiro 向け配布物を `plugins/mcp/{claude,codex,kiro}/` に生成

## 利用方法

Expand Down Expand Up @@ -99,7 +100,7 @@ kiro-cli chat

| プラグイン名 | バージョン | 説明 | 詳細 |
|------------|----------|------|------|
| **ndf** | 4.19.0 | Claude Code / Codex / Kiro CLI開発環境を**オールインワン**で強化する統合プラグイン。8個の専門エージェント(director、data-analyst、corder、researcher、qa、debugger、devops-engineer、code-reviewer)、公開Skills(Claude Code向け core 29個、Kiro向け core 28個、Codex向け core 30個)、SessionStartフック(transcript保持期間自動管理)、Stopフック(AI要約生成+Slack通知)を提供。v4.0.0 で Codex MCP サーバを廃止し、`/ndf:codex` skill + `corder` エージェント経由の CLI 直接実行に一本化。 | [Claude](./plugins/ndf-claude/README.md) / [Codex](./plugins/ndf-codex/README.md) / [Kiro](./plugins/ndf-kiro/README.md) |
| **ndf** | 4.19.0 | Claude Code / Codex / Kiro CLI 向けに runtime 別配布物を提供する NDF プラグイン。8個の専門エージェント(Claude版)、公開Skills(Claude Code向け core 29個、Kiro向け core 28個、Codex向け core 30個)、Claude SessionStart/Stopフック、Codex/Kiro向け通知・実行補助を提供。v4.0.0 で Codex MCP サーバを廃止し、`/ndf:codex` skill + `corder` エージェント経由の CLI 直接実行に一本化。 | [Claude](./plugins/ndf-claude/README.md) / [Codex](./plugins/ndf-codex/README.md) / [Kiro](./plugins/ndf-kiro/README.md) |

### NDF v4.19.0 の主な変更

Expand All @@ -120,17 +121,15 @@ ai-plugins/
├── .claude-plugin/
│ └── marketplace.json # Claude Codeマーケットプレイスメタデータ
├── plugins/
│ └── {plugin-name}/
│ ├── .codex-plugin/
│ │ └── plugin.json # Codexプラグインメタデータ
│ ├── .claude-plugin/
│ │ └── plugin.json # Claude Codeプラグインメタデータ
│ ├── agents/ # サブエージェント (*.md)
│ ├── skills/ # 全Skillの実体(Claude Code/Kiroはmanifest配列で公開対象を指定)
│ ├── skills-codex/ # Codex向け公開Skill(marketplace cache対応の実ディレクトリ)
│ └── skills-optional/ # ランタイム別除外候補リスト
│ └── {skill-name}/
│ └── SKILL.md # エントリポイント(必須)
│ ├── ndf-shared/ # NDF共通編集元(直接installしない)
│ ├── ndf-claude/ # Claude Code版NDF配布物
│ ├── ndf-codex/ # Codex版NDF配布物
│ ├── ndf-kiro/ # Kiro CLI版NDF配布物/installer
│ └── mcp/
│ ├── shared/ # MCPプラグイン共通編集元
│ ├── claude/ # Claude Code版MCP配布物
│ ├── codex/ # Codex版MCP配布物
│ └── kiro/ # Kiro CLI版MCP配布物/installer
├── README.md
└── CLAUDE.md # AIエージェント向けガイドライン
```
Expand Down
2 changes: 1 addition & 1 deletion docs/claude-code-skills-survey.md
Original file line number Diff line number Diff line change
Expand Up @@ -622,7 +622,7 @@

### 1. Skillsの配置場所
```
plugins/ndf/
plugins/ndf-shared/
├── skills/
│ ├── director/
│ │ ├── brainstorming/SKILL.md
Expand Down
36 changes: 18 additions & 18 deletions docs/external-reviews/pr-57-codex-business-review.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
| **実行時間** | 約 8 分 / tokens 129,705 |
| **背景** | 技術レビュー (Codex 3 ラウンド + Amazon Q + Gemini) 完了後、事業観点のみに絞って依頼 |
| **結論** | ⚠️ **コード品質ではなく、事業的な梱包がまだ追いついていない**。power-user 向け merge は合理的、新看板機能として広報するなら周辺メッセージ修正を同時に。 |
| **直近 1ヶ月の最重要アクション** | (1) `marketplace.json` / `plugin.json` / `plugins/ndf/README.md` の storefront 文言更新 / (2) `browser-test` と `playwright-scenario-test` の役割分担を docs で明確化 / (3) 10分で動くデモケースの公開 |
| **直近 1ヶ月の最重要アクション** | (1) `marketplace.json` / `plugin.json` / `plugins/ndf-claude/README.md` の storefront 文言更新 / (2) `browser-test` と `playwright-scenario-test` の役割分担を docs で明確化 / (3) 10分で動くデモケースの公開 |
| **PR コメント** | https://github.com/takemi-ohama/ai-plugins/pull/57#issuecomment-4321871998 |

---
Expand All @@ -27,7 +27,7 @@

### 1.1 強み
この skill の本質は、Playwright そのものの代替ではなく、**Playwright を AI エージェント運用に最適化した“実務レイヤー”** にあります。
Playwright 公式はブラウザ自動化基盤として強いですが、`/work/ai-plugins/plugins/ndf/skills/playwright-scenario-test/SKILL.md` を読む限り、本 skill はそこに **テスト設計の方法論、page role 分類、証跡標準化、Drive 共有、Markdown レポート** を足しています。
Playwright 公式はブラウザ自動化基盤として強いですが、`/work/ai-plugins/plugins/ndf-shared/skills/playwright-scenario-test/SKILL.md` を読む限り、本 skill はそこに **テスト設計の方法論、page role 分類、証跡標準化、Drive 共有、Markdown レポート** を足しています。
つまり競争軸は「ブラウザを動かせるか」ではなく、**“AI が再現性の高い E2E を短時間で作り、レビュー可能な証跡まで揃えられるか”** です。
この位置づけは、Playwright / Selenium / Puppeteer のような実行基盤とは競争しつつも、実は真正面からは競合しません。
むしろ「それらをどう現場の開発運用に落とすか」の層を取ろうとしている点が重要です。
Expand Down Expand Up @@ -60,7 +60,7 @@ NDF はその上に載せられる可能性があるが、現状は **ローカ

### 1.2 弱み / 競合との差
弱みは明確で、**今のままだと“何でも入った NDF の一機能”に見えてしまい、単独価値として発見されにくい**ことです。
`plugins/ndf/.claude-plugin/plugin.json` の description には機能が多く並びますが、焦点が広すぎます。
`plugins/ndf-claude/.claude-plugin/plugin.json` の description には機能が多く並びますが、焦点が広すぎます。
利用者は「PR ワークフロー」「Codex 連携」「Slack 通知」「Google Drive」「E2E テスト」のどれを主価値として認識すべきか迷います。

`plugin.json` の `keywords` に `playwright` `pytest` `e2e` `qa` `accessibility` `testing` が入っていないのも機会損失です。
Expand Down Expand Up @@ -185,7 +185,7 @@ OSS として広げるなら、**“Claude Code plugin でありつつ、中身
## 3. Skill のディスカバラビリティと活性化

### 3.1 description / Triggers の妥当性
`/work/ai-plugins/plugins/ndf/skills/playwright-scenario-test/SKILL.md` の `description` は情報量が豊富で、技術的にはかなり良いです。
`/work/ai-plugins/plugins/ndf-shared/skills/playwright-scenario-test/SKILL.md` の `description` は情報量が豊富で、技術的にはかなり良いです。
ただし business 観点では、**少し盛り込みすぎ**です。
利用者に価値を伝える文章としては強いが、AI の auto-invoke trigger としては信号が散っています。

Expand All @@ -194,7 +194,7 @@ OSS として広げるなら、**“Claude Code plugin でありつつ、中身
AI にとっても人にとっても、「これは E2E planning skill なのか、動画証跡 skill なのか、品質ゲート skill なのか」が一読で定まりにくい。

`when_to_use` で Triggers を分離した設計自体は正しいです。
`plugins/ndf/CLAUDE.md` でもその改善意図が記録されており、方向性は良いです。
`CLAUDE.md` でもその改善意図が記録されており、方向性は良いです。
ただし trigger phrase はまだ改善余地があります。

現状の trigger は、技術者寄りの言葉に少し偏っています。
Expand Down Expand Up @@ -225,7 +225,7 @@ Claude Code plugin モデルと相性は良いです。

ただし問題は、**scenario-test 単体の価値に最短で到達できない**ことです。
利用者はまず NDF 全体を理解させられます。
`plugins/ndf/README.md` も大きな統合プラグインの説明が先に来るため、testing use case の人には情報密度が高すぎます。
`plugins/ndf-claude/README.md` も大きな統合プラグインの説明が先に来るため、testing use case の人には情報密度が高すぎます。

`marketplace.json` の `ndf` description が古いのは、導線上かなり痛いです。
ここは marketplace 上の第一印象なので、**PR #57 の価値を最初に伝える場所**です。
Expand Down Expand Up @@ -335,7 +335,7 @@ Drive 共有、HUD 動画、a11y/CWV は、単体では売りにくいです。

### 6.1 v0.4.0 で優先すべきこと (Top 3)
**Top 1: プロダクトの見せ方を刷新すること**
`marketplace.json`、`plugin.json`、`plugins/ndf/README.md` の scenario-test 訴求を更新し、
`marketplace.json`、`plugin.json`、`plugins/ndf-claude/README.md` の scenario-test 訴求を更新し、
「AI が pytest-playwright テストを書き、証跡を残し、共有まで行う skill」
と一文で伝わるようにするべきです。
これは最優先です。
Expand Down Expand Up @@ -405,7 +405,7 @@ NDF は test management ではなく **AI-assisted test execution workflow** に
- 逆に、これを「広く採用される新看板機能」として出すなら、周辺メッセージ修正を同時にやるべきです。

- 直近 1 ヶ月の最重要アクション 1:
- `marketplace.json` `plugin.json` `plugins/ndf/README.md` を更新し、scenario-test の価値を storefront レベルで伝える。
- `marketplace.json` `plugin.json` `plugins/ndf-claude/README.md` を更新し、scenario-test の価値を storefront レベルで伝える。
- ここで「AI が pytest-playwright テストと証跡を自動生成する」という一文を明示する。

- 直近 1 ヶ月の最重要アクション 2:
Expand Down Expand Up @@ -443,17 +443,17 @@ NDF は test management ではなく **AI-assisted test execution workflow** に
- [CLAUDE.md](/work/ai-plugins/CLAUDE.md)
- [docs/project-overview.md](/work/ai-plugins/docs/project-overview.md)
- [docs/ndf-plugin-reference.md](/work/ai-plugins/docs/ndf-plugin-reference.md)
- [plugins/ndf/README.md](/work/ai-plugins/plugins/ndf/README.md)
- [plugins/ndf/CLAUDE.md](/work/ai-plugins/plugins/ndf/CLAUDE.md)
- [plugins/ndf/.claude-plugin/plugin.json](/work/ai-plugins/plugins/ndf/.claude-plugin/plugin.json)
- [plugins/ndf-claude/README.md](/work/ai-plugins/plugins/ndf-claude/README.md)
- [CLAUDE.md](/work/ai-plugins/CLAUDE.md)
- [plugins/ndf-claude/.claude-plugin/plugin.json](/work/ai-plugins/plugins/ndf-claude/.claude-plugin/plugin.json)
- [.claude-plugin/marketplace.json](/work/ai-plugins/.claude-plugin/marketplace.json)
- [plugins/ndf/skills/playwright-scenario-test/SKILL.md](/work/ai-plugins/plugins/ndf/skills/playwright-scenario-test/SKILL.md)
- [plugins/ndf/skills/playwright-scenario-test/docs/README.md](/work/ai-plugins/plugins/ndf/skills/playwright-scenario-test/docs/README.md)
- [plugins/ndf/skills/playwright-scenario-test/docs/01-methodology.md](/work/ai-plugins/plugins/ndf/skills/playwright-scenario-test/docs/01-methodology.md)
- [plugins/ndf/skills/playwright-scenario-test/docs/02-page-roles.md](/work/ai-plugins/plugins/ndf/skills/playwright-scenario-test/docs/02-page-roles.md)
- [plugins/ndf/skills/playwright-scenario-test/docs/06-pytest-playwright.md](/work/ai-plugins/plugins/ndf/skills/playwright-scenario-test/docs/06-pytest-playwright.md)
- [plugins/ndf/skills/playwright-scenario-test/pyproject.toml](/work/ai-plugins/plugins/ndf/skills/playwright-scenario-test/pyproject.toml)
- [plugins/ndf/skills/playwright-scenario-test/templates/conftest.py.template](/work/ai-plugins/plugins/ndf/skills/playwright-scenario-test/templates/conftest.py.template)
- [plugins/ndf-shared/skills/playwright-scenario-test/SKILL.md](/work/ai-plugins/plugins/ndf-shared/skills/playwright-scenario-test/SKILL.md)
- [plugins/ndf-shared/skills/playwright-scenario-test/docs/README.md](/work/ai-plugins/plugins/ndf-shared/skills/playwright-scenario-test/docs/README.md)
- [plugins/ndf-shared/skills/playwright-scenario-test/docs/01-methodology.md](/work/ai-plugins/plugins/ndf-shared/skills/playwright-scenario-test/docs/01-methodology.md)
- [plugins/ndf-shared/skills/playwright-scenario-test/docs/02-page-roles.md](/work/ai-plugins/plugins/ndf-shared/skills/playwright-scenario-test/docs/02-page-roles.md)
- [plugins/ndf-shared/skills/playwright-scenario-test/docs/06-pytest-playwright.md](/work/ai-plugins/plugins/ndf-shared/skills/playwright-scenario-test/docs/06-pytest-playwright.md)
- [plugins/ndf-shared/skills/playwright-scenario-test/pyproject.toml](/work/ai-plugins/plugins/ndf-shared/skills/playwright-scenario-test/pyproject.toml)
- [plugins/ndf-shared/skills/playwright-scenario-test/templates/conftest.py.template](/work/ai-plugins/plugins/ndf-shared/skills/playwright-scenario-test/templates/conftest.py.template)

## 外部比較で参照した公式情報
- Playwright Python: https://playwright.dev/python/
Expand Down
Loading