yodogawa 2.0.0 → 2.1.0

package/CHANGELOG.md

@@ -5,6 +5,45 @@
 フォーマットは [Keep a Changelog](https://keepachangelog.com/ja/1.0.0/) に基づいており、
 このプロジェクトは [Semantic Versioning](https://semver.org/lang/ja/spec/v2.0.0.html) に準拠しています。
 
+## [2.1.0] - 2026-04-16
+
+### 変更
+
+- **CLI の配置先を 2 択に簡素化**: Cursor / Codex / Antigravity が Claude Code の SKILL.md 標準に収束したため、インストール先ディレクトリを `.claude/`（Claude Code 用）と `.agents/`（その他 3 IDE 共通）の 2 つに統合しました。
+  - 既存ユーザーへの影響: Cursor / Codex / Antigravity をお使いの場合、旧バージョンで作成された `.cursor/` / `.codex/` / `.agent/` は削除し、本バージョンで `.agents/` に再インストールしてください。
+- **用語統一**: スキル本文で「ワークフロー」と「スキル」が混在していた箇所を「スキル」に統一しました（Phase 4）。
+- **`c-001-implement-task` に検証ループを追加**: 各ステップ実行後に型チェック・Lint・ユニットテスト・ビルドを自動実行し、失敗時は最大 3 回まで原因分析と修正を繰り返す仕組みを明文化しました。
+
+### 追加
+
+- **Claude Code Skill 高度機能の活用**: 全 22 スキルに以下のフロントマターフィールドを追加しました（Phase 5）。
+  - `allowed-tools`: 各スキルに必要な最小限のツール権限を明示
+  - `argument-hint`: タスク系スキルでコマンド引数（`[task-id]` 等）の使い方を明示
+  - `context: fork`: レビュー系スキル（`a-006` / `a-015` / `b-005`）でコンテキストを分離
+- **`b-001-create-task-directory` で `$ARGUMENTS` をサポート**: `/b-001 auth-login` のように引数でスラッグを渡せるようになりました。
+- **`c-001-implement-task` に検証ループの参考資料を追加**: `reference/validation-loop.md` として検証フロー・コマンド表・エスカレーション基準を整備しました。
+
+### 内部
+
+- `.gitignore` に Yodogawa CLI のローカルインストール出力ディレクトリ（`.agents/` / `.agent/` / `.cursor/` / `.codex/`）を追加。
+
+## [2.0.0] - 2026-04-16
+
+### 破壊的変更
+
+- **スキル形式への全面移行**: 旧 `workflows/*.md` 形式を廃止し、Claude Code の SKILL.md 標準（`skills/{name}/SKILL.md`）に全面移行しました。各スキルは YAML frontmatter（`name` / `description`）と 6 セクション構成（目的 / 前提 / 手順 / 完了条件 / エスカレーション / 参考）を持ちます。
+- **Windsurf のサポートを終了**: Windsurf はアクティブメンテナンスが停止しているため、公式サポート対象から外しました。
+- **Progressive disclosure パターンの採用**: 長文スキルを `SKILL.md` + `examples/` + `reference/` に分割し、12,000 文字のワークフロー上限に収まるよう最適化しました。
+
+### 追加
+
+- **Codex のサポート**: OpenAI Codex (`.codex/`) を新たにサポート対象に追加しました。
+
+### 変更
+
+- **README をスキルフォーマットに合わせて全面書き換え**。
+- `bin` フィールドのパスを `npm pkg fix` で修正。
+
 ## [1.0.7] - 2026-01-27
 
 ### 追加

package/README.md

@@ -1,28 +1,44 @@
 # Yodogawa
 
-> **🌟 AIネイティブIDE向けの仕様駆動開発ワークフロー集**
+> **🌟 AIネイティブIDE向けの仕様駆動開発スキル集**
 
 ---
 
 ## 概要
 
-**Yodogawa**は、プロダクトマネージャーや開発者が**ステークホルダーと合意できる高品質なドキュメント**を作成・維持するための**仕様駆動開発ワークフロー集**です。
+**Yodogawa**は、プロダクトマネージャーや開発者が**ステークホルダーと合意できる高品質なドキュメント**を作成・維持するための**仕様駆動開発スキル集**です。
 
 生成AIを使ったコーディングでは、**コンテキスト（文脈）がすべて**です。  
 AIに「何を作りたいのか」を正確に伝えるには、チーム全体で合意された詳細なドキュメントが欠かせません。
 
 Yodogawaは、このドキュメント作成プロセスを標準化し、AIエージェントが理解しやすい形式で仕様・設計・タスクを管理できるようにします。
 
+### スキルの仕組み
+
+各スキルは `skills/{name}/SKILL.md` という形式で定義されています。  
+`SKILL.md` はYAML frontmatterに `name`（識別子）と `description`（AIが呼び出すトリガー）を持ち、手順・完了条件・エスカレーション指針を記述したMarkdownドキュメントです。
+
+```
+skills/
+├── a-001-setup-doc-structure/
+│   └── SKILL.md
+├── a-002-initialize-project/
+│   └── SKILL.md
+└── ...
+```
+
+インストール後、各IDEはスキルを自動的に認識し、AIエージェントが呼び出せるようになります。
+
 ### 対応環境
 
-以下のAIネイティブIDE・コードエディタで使用できます：
+以下のAIネイティブIDE・コードエディタで使用できます。すべて Claude Code が策定したSKILL.md標準に収束しているため、2つのディレクトリのいずれかに配置するだけで動作します：
 
-| IDE / エディタ  | 使い方                                              |
-| :-------------- | :-------------------------------------------------- |
-| **Antigravity** | `.agent/skills/{name}/SKILL.md` にコピーして参照    |
-| **Cursor**      | `.cursor/skills/{name}/SKILL.md` として認識         |
-| **Claude Code** | `.claude/skills/{name}/SKILL.md` として認識         |
-| **Codex**       | `.codex/skills/{name}/SKILL.md` として認識          |
+| IDE / エディタ  | スキルの場所                                        | 呼び出し方              |
+| :-------------- | :-------------------------------------------------- | :---------------------- |
+| **Claude Code** | `.claude/skills/{name}/SKILL.md`                    | `/a-001` などで呼び出し |
+| **Cursor**      | `.agents/skills/{name}/SKILL.md`                    | `/a-001` などで呼び出し |
+| **Codex**       | `.agents/skills/{name}/SKILL.md`                    | `/a-001` などで呼び出し |
+| **Antigravity** | `.agents/skills/{name}/SKILL.md`                    | `/a-001` などで呼び出し |
 
 ---
 
@@ -92,11 +108,11 @@ Why? ─── What? ─── How?
 
 ---
 
-## ワークフロー
+## スキル一覧
 
 開発ライフサイクルに沿って、**3つのシリーズ**を提供しています。
 
-### プロジェクト設計
+### A-Series：プロジェクト設計
 
 > プロジェクトの立ち上げや、大規模な設計変更時に使用
 
@@ -118,11 +134,11 @@ Why? ─── What? ─── How?
 | 14  | `/a-014` | **Define Infrastructure** | インフラ構成・非機能要件（RPO/RTO）を定義          |
 | 15  | `/a-015` | **Review Design**         | ⚠️ **全体設計の一貫性をレビュー**                  |
 
-> ⚠️ マークのワークフローは**必ず実施**してください。
+> ⚠️ マークのスキルは**必ず実施**してください。
 
 ---
 
-### タスク管理
+### B-Series：タスク管理
 
 > 機能開発タスクを定義し、実装可能なレベルまで詳細化
 
@@ -136,7 +152,7 @@ Why? ─── What? ─── How?
 
 ---
 
-### 実装
+### C-Series：実装
 
 > 承認された計画に基づき、コード実装・テスト・ドキュメント更新
 
@@ -154,25 +170,23 @@ Why? ─── What? ─── How?
 ```bash
 npm install -g yodogawa
 cd your-project-dir
-yodogawa init
+yodogawa
 ```
 
-これにより各IDE向けのスキルがプロジェクトに配置されます。
+対話形式でIDEを選択すると、`skills/`, `templates/`, `scripts/` がプロジェクトの IDE ディレクトリに配置されます。
 
 ### 方法2: 手動導入
 
 このリポジトリの `skills/`, `templates/`, `scripts/` をプロジェクトの IDE ディレクトリにコピーしてください：
 
-- Antigravity: `.agent/`
-- Cursor: `.cursor/`
-- Claude Code: `.claude/`
-- Codex: `.codex/`
+- **Claude Code**: `.claude/` 配下にコピー
+- **Cursor / Codex / Antigravity**: `.agents/` 配下にコピー
 
 ---
 
 ## 使い方
 
-### 1️⃣ プロジェクトの立ち上げ（A-Series）
+### 1️⃣ プロジェクトの立ち上げ（A-Series スキル）
 
 新規プロジェクトや大規模機能の開発時に、**A-Series**を順番に実行します。
 
@@ -185,7 +199,7 @@ yodogawa init
 
 ---
 
-### 2️⃣ 機能開発のループ（B & C Series）
+### 2️⃣ 機能開発のループ（B & C Series スキル）
 
 個々のタスクは以下のサイクルで進めます：
 
@@ -200,3 +214,27 @@ yodogawa init
 |    7     | `/c-002` | ドキュメント更新                                     |
 
 > ⚠️ `/b-005` でRejectされた場合は `/b-002` に戻って修正
+
+---
+
+## スキルのフォーマット
+
+各 `SKILL.md` は以下の構造を持ちます：
+
+```markdown
+---
+name: a-001-setup-doc-structure
+description: プロジェクトのドキュメントディレクトリ構造を作成する軽量セットアップワークフロー
+---
+
+# スキル名
+
+## 目的
+## 前提
+## 手順
+## 完了条件
+## エスカレーション
+```
+
+- **`name`**: スキルの識別子（kebab-case）
+- **`description`**: AIエージェントがスキルを呼び出すトリガーとなる説明文

package/bin/cli.js

@@ -13,10 +13,8 @@ async function main() {
     name: 'type',
     message: 'Which configuration would you like to install?',
     choices: [
-      { title: 'Antigravity (.agent)', value: 'antigravity' },
-      { title: 'Cursor (.cursor)', value: 'cursor' },
-      { title: 'Claude Code (.claude)', value: 'claude' },
-      { title: 'Codex (.codex)', value: 'codex' }
+      { title: 'Claude Code (.claude/skills/)', value: 'claude' },
+      { title: 'Other IDEs — Cursor / Codex / Antigravity (.agents/skills/)', value: 'agents' }
     ]
   });
 
@@ -27,10 +25,8 @@ async function main() {
 
   const pkgRoot = path.join(__dirname, '..');
   const dirMap = {
-    antigravity: '.agent',
-    cursor: '.cursor',
     claude: '.claude',
-    codex: '.codex',
+    agents: '.agents',
   };
   const targetDirName = dirMap[response.type];
   const targetDir = path.join(process.cwd(), targetDirName);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yodogawa",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "CLI to install Yodogawa Slash Commands workflows",
   "bin": {
     "yodogawa": "bin/cli.js"

package/skills/a-001-setup-doc-structure/SKILL.md

@@ -1,100 +1,67 @@
----
-name: a-001-setup-doc-structure
-description: プロジェクトのドキュメントディレクトリ構造を作成し、README で構成を説明する軽量セットアップワークフロー
-auto_execution_mode: 1
----
-
-# SetupDocStructure (a-001)
-
-## 目的
-
-- プロジェクトルートに標準化されたドキュメントディレクトリ構造を作成する。
-- `docs/README.md` を作成し、ドキュメント構成と更新方針を明文化する。
-
-## 前提
-
-- プロジェクトのルートディレクトリへの書き込み権限があること。
-- `docs/` ディレクトリが存在しない、または既存の構造を拡張したいこと。
-
-## 手順
-
-### 1. スクリプトの実行
-
-- ドキュメント構造セットアップのために、環境に応じたスクリプトを実行してください。
-
-  ```bash
-  # 環境を自動検出してスクリプトを実行
-  if [ -d ".agent" ]; then
-    SCRIPT_DIR=".agent"
-  elif [ -d ".cursor" ]; then
-    SCRIPT_DIR=".cursor"
-  elif [ -d ".claude" ]; then
-    SCRIPT_DIR=".claude"
-  elif [ -d ".codex" ]; then
-    SCRIPT_DIR=".codex"
-  else
-    echo "エラー: AI coding assistant ディレクトリが見つかりません"
-    exit 1
-  fi
-
-  bash "$SCRIPT_DIR/scripts/setup-docs.sh"
-  ```
-
-### 2. 結果の確認
-
-- スクリプトの実行結果を確認し、エラーがないことを確認してください。
-- 生成された構造：
-
-  ```
-  docs/
-  ├── README.md
-  ├── project/
-  │   ├── 01-requirements/
-  │   ├── 02-behavior/
-  │   ├── 03-domain/
-  │   └── 04-design/
-  └── tasks/
-  ```
-
-### 3. Git への追加（オプション）
-
-- ユーザーに確認：「作成したディレクトリ構造を Git に追加しますか？」
-- 「はい」の場合、以下を実行：
-
-  ```bash
-  git add docs/
-  git status
-  ```
-
-- Git status の結果を表示し、コミットメッセージの提案をする：
-
-  ```
-  推奨コミットメッセージ:
-  ドキュメント構造の初期化
-
-  - 標準的な構造を持つ docs/ ディレクトリを追加
-  - ドキュメント構成を説明する docs/README.md を追加
-  ```
-
-### 4. 完了条件の確認
-
-- 以下の完了条件を満たしているか、チェックリストで確認してください：
-  - [ ] スクリプトが正常に終了した
-  - [ ] `docs/` ディレクトリ構造が正しく作成されている
-
-## 完了条件
-
-- プロジェクトルートに `docs/` ディレクトリが作成されている。
-- `docs/project/` 配下に `01-requirements/`, `02-behavior/`, `03-domain/`, `04-design/` ディレクトリが存在する。
-- `docs/tasks/` ディレクトリが存在する。
-- `docs/README.md` が作成されている。
-- ユーザーに作成結果が報告されている。
-
-## エスカレーション
-
-- 既存の `docs/` ディレクトリが存在し、重要なファイルが含まれている場合：
-  - 「既存のドキュメント構造が検出されました。上書きや削除のリスクがあるため、手動で確認してください。」と警告し、処理を中断する。
-- ファイルシステムの権限エラーが発生した場合：
-  - 「ディレクトリの作成に失敗しました。書き込み権限を確認してください。」とユーザーに通知する。
-- Git リポジトリでない場合に Git 追加を試みた場合：
-  - 「このディレクトリは Git リポジトリではありません。Git の初期化が必要な場合は `git init` を実行してください。」と案内する。
+---
+name: a-001-setup-doc-structure
+description: docs/ 配下にプロジェクト/タスク用のディレクトリ構造と README を作成する。新規リポジトリでドキュメント基盤を初期化する際に使用。
+disable-model-invocation: true
+allowed-tools: Read, Write, Bash, Glob
+---
+
+# SetupDocStructure (a-001)
+
+## 目的
+
+- プロジェクトルートに標準化されたドキュメントディレクトリ構造を作成する。
+- `docs/README.md` を作成し、ドキュメント構成と更新方針を明文化する。
+
+## 前提
+
+- プロジェクトのルートディレクトリへの書き込み権限があること
+- `docs/` ディレクトリが存在しない、または既存の構造を拡張したいこと
+
+## 手順
+
+### 1. スクリプトの実行
+
+環境に応じたスクリプトを実行。スクリプト本体とフォールバック実装は [reference/directory-structure.md](reference/directory-structure.md#スクリプト実行コマンド) を参照。
+
+```bash
+SCRIPT_DIR=$(for d in .agent .cursor .claude .codex; do [ -d "$d" ] && echo "$d" && break; done)
+bash "$SCRIPT_DIR/scripts/setup-docs.sh"
+```
+
+### 2. 結果の確認
+
+スクリプト実行結果にエラーがないこと、および期待した構造が生成されていることを確認。生成構造と各ディレクトリの用途は [reference/directory-structure.md](reference/directory-structure.md#生成されるディレクトリ構造) を参照。
+
+### 3. Git への追加（オプション）
+
+ユーザーに確認し、「はい」なら:
+
+```bash
+git add docs/
+git status
+```
+
+推奨コミットメッセージは [reference/directory-structure.md](reference/directory-structure.md#git-追加時の推奨コミットメッセージ) を参照。
+
+### 4. 完了条件の確認
+
+- [ ] スクリプトが正常に終了した
+- [ ] `docs/` ディレクトリ構造が正しく作成されている
+
+## 完了条件
+
+- プロジェクトルートに `docs/` ディレクトリが作成されている
+- `docs/project/` 配下に `01-requirements/`, `02-behavior/`, `03-domain/`, `04-design/` が存在する
+- `docs/tasks/` ディレクトリが存在する
+- `docs/README.md` が作成されている
+- ユーザーに作成結果が報告されている
+
+## エスカレーション
+
+- **既存の `docs/` が存在し重要ファイルを含む**: 「既存のドキュメント構造が検出されました。上書きや削除のリスクがあるため、手動で確認してください。」と警告し処理を中断
+- **権限エラー**: 「ディレクトリの作成に失敗しました。書き込み権限を確認してください。」
+- **Git リポジトリでない**: 「このディレクトリは Git リポジトリではありません。必要なら `git init` を実行してください。」
+
+## 参考
+
+- [reference/directory-structure.md](reference/directory-structure.md) — 生成構造、各ディレクトリの用途、スクリプト詳細、推奨コミットメッセージ

package/skills/a-001-setup-doc-structure/reference/directory-structure.md

@@ -0,0 +1,52 @@
+# docs ディレクトリ構造とコミットメッセージ
+
+SKILL.md 手順2〜3で参照する生成構造とコミットメッセージテンプレート。
+
+## 生成されるディレクトリ構造
+
+```
+docs/
+├── README.md
+├── project/
+│   ├── 01-requirements/
+│   ├── 02-behavior/
+│   ├── 03-domain/
+│   └── 04-design/
+└── tasks/
+```
+
+### 各ディレクトリの用途
+
+- `project/01-requirements/` — 要件定義（システム概要、機能要件、非機能要件、ユーザーストーリー）
+- `project/02-behavior/` — 振る舞い定義（Gherkin シナリオ）
+- `project/03-domain/` — ドメインモデル、ユビキタス言語
+- `project/04-design/` — 画面設計、データモデル、API 仕様、アーキテクチャ等
+- `tasks/` — 個別タスク（`task{ID}-{SLUG}/` 形式）
+
+## Git 追加時の推奨コミットメッセージ
+
+```
+ドキュメント構造の初期化
+
+- 標準的な構造を持つ docs/ ディレクトリを追加
+- ドキュメント構成を説明する docs/README.md を追加
+```
+
+## スクリプト実行コマンド
+
+```bash
+if [ -d ".agent" ]; then
+  SCRIPT_DIR=".agent"
+elif [ -d ".cursor" ]; then
+  SCRIPT_DIR=".cursor"
+elif [ -d ".claude" ]; then
+  SCRIPT_DIR=".claude"
+elif [ -d ".codex" ]; then
+  SCRIPT_DIR=".codex"
+else
+  echo "エラー: AI coding assistant ディレクトリが見つかりません"
+  exit 1
+fi
+
+bash "$SCRIPT_DIR/scripts/setup-docs.sh"
+```