yodogawa 2.0.0 → 2.1.1

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/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 tkysi-mi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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,33 @@ 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エージェントがスキルを呼び出すトリガーとなる説明文
+
+---
+
+## ライセンス
+
+[MIT License](LICENSE) — Copyright (c) 2025 tkysi-mi

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.1",
   "description": "CLI to install Yodogawa Slash Commands workflows",
   "bin": {
     "yodogawa": "bin/cli.js"
@@ -43,7 +43,7 @@
     "claude"
   ],
   "author": "",
-  "license": "ISC",
+  "license": "MIT",
   "dependencies": {
     "fs-extra": "^11.2.0",
     "kleur": "^4.1.5",

package/scripts/create-task.sh

@@ -0,0 +1,77 @@
+#!/bin/bash
+
+# create-task.sh
+# docs/tasks/ 配下に連番 ID 付きのタスクディレクトリを作成するスクリプト
+# Usage: bash scripts/create-task.sh <slug>
+# 例:    bash scripts/create-task.sh user-profile-edit
+
+set -e
+
+TASKS_DIR="docs/tasks"
+SLUG="$1"
+
+echo "📂 タスクディレクトリの作成を開始します..."
+
+# 1. 引数チェック
+if [ -z "$SLUG" ]; then
+  echo "❌ スラッグが指定されていません。"
+  echo "   使い方: bash scripts/create-task.sh <slug>"
+  echo "   例:     bash scripts/create-task.sh user-profile-edit"
+  exit 1
+fi
+
+# 2. スラッグの形式チェック（英小文字・数字・ハイフンのみ、連続ハイフン禁止）
+if ! [[ "$SLUG" =~ ^[a-z0-9]+(-[a-z0-9]+)*$ ]]; then
+  echo "❌ スラッグは英小文字・数字・ハイフンのみ使用できます: '$SLUG'"
+  echo "   例: user-profile-edit"
+  exit 1
+fi
+
+# 3. 単語数の警告（3〜5 語を推奨、範囲外は警告のみで続行）
+WORD_COUNT=$(echo "$SLUG" | awk -F'-' '{print NF}')
+if [ "$WORD_COUNT" -lt 3 ] || [ "$WORD_COUNT" -gt 5 ]; then
+  echo "⚠️  スラッグは 3〜5 語を推奨しています（現在: ${WORD_COUNT} 語）。"
+fi
+
+# 4. docs/tasks/ の存在確認
+if [ ! -d "$TASKS_DIR" ]; then
+  echo "❌ '$TASKS_DIR' が存在しません。"
+  echo "   先に /a-001-setup-doc-structure を実行してください。"
+  exit 1
+fi
+
+# 5. 既存タスクから次の ID を採番
+MAX_ID=0
+for dir in "$TASKS_DIR"/task*; do
+  [ -d "$dir" ] || continue
+  BASENAME=$(basename "$dir")
+  # task000123-xxx から 000123 を抜き出す
+  if [[ "$BASENAME" =~ ^task([0-9]{6})- ]]; then
+    NUM=$((10#${BASH_REMATCH[1]}))
+    if [ "$NUM" -gt "$MAX_ID" ]; then
+      MAX_ID=$NUM
+    fi
+  fi
+done
+
+NEXT_ID=$((MAX_ID + 1))
+TASK_ID=$(printf "task%06d" "$NEXT_ID")
+TASK_DIR="$TASKS_DIR/${TASK_ID}-${SLUG}"
+
+# 6. 同名ディレクトリの存在確認（理論上発生しないが保険）
+if [ -d "$TASK_DIR" ]; then
+  echo "❌ '$TASK_DIR' は既に存在します。"
+  exit 1
+fi
+
+# 7. 作成
+echo "🔨 ディレクトリを作成中: $TASK_DIR"
+mkdir -p "$TASK_DIR"
+
+# 8. 完了報告
+echo ""
+echo "✅ タスクディレクトリを作成しました。"
+echo "   パス: $TASK_DIR"
+echo ""
+echo "次のステップ:"
+echo "  - タスク定義書を作成する: /b-002-create-task-definition"

package/scripts/init-project-docs.sh

@@ -0,0 +1,90 @@
+#!/bin/bash
+
+# init-project-docs.sh
+# templates/project/<category>/ 配下のテンプレートを
+# docs/project/<category>/ へ一括コピーするスクリプト
+# Usage: bash scripts/init-project-docs.sh <category>
+#   category: requirements | behavior | domain | design
+# 例:    bash scripts/init-project-docs.sh requirements
+
+set -e
+
+CATEGORY="$1"
+
+# スクリプト自身の位置からテンプレートルートを解決（.claude/scripts -> .claude/templates）
+SCRIPT_SELF_DIR="$(cd "$(dirname "$0")" && pwd)"
+TEMPLATE_ROOT="$SCRIPT_SELF_DIR/../templates/project"
+
+echo "📝 プロジェクトドキュメントの一括初期化を開始します..."
+
+# 1. 引数チェック
+if [ -z "$CATEGORY" ]; then
+  echo "❌ category 引数が指定されていません。"
+  echo "   使い方: bash scripts/init-project-docs.sh <category>"
+  echo "   category: requirements | behavior | domain | design"
+  exit 1
+fi
+
+# 2. category を番号付きディレクトリ名にマッピング
+case "$CATEGORY" in
+  requirements)
+    SUBDIR="01-requirements"
+    ;;
+  behavior)
+    SUBDIR="02-behavior"
+    ;;
+  domain)
+    SUBDIR="03-domain"
+    ;;
+  design)
+    SUBDIR="04-design"
+    ;;
+  *)
+    echo "❌ 不明な category: '$CATEGORY'"
+    echo "   有効な category: requirements | behavior | domain | design"
+    exit 1
+    ;;
+esac
+
+SRC_DIR="$TEMPLATE_ROOT/$SUBDIR"
+DEST_DIR="docs/project/$SUBDIR"
+
+# 3. テンプレートディレクトリの存在確認
+if [ ! -d "$SRC_DIR" ]; then
+  echo "❌ テンプレートディレクトリが見つかりません: $SRC_DIR"
+  echo "   yodogawa CLI での再インストールを検討してください。"
+  exit 1
+fi
+
+# 4. 出力先ディレクトリの存在確認
+if [ ! -d "$DEST_DIR" ]; then
+  echo "❌ 出力先ディレクトリが存在しません: $DEST_DIR"
+  echo "   先に /a-001-setup-doc-structure を実行してください。"
+  exit 1
+fi
+
+# 5. テンプレートファイルを一括コピー（既存はスキップして冪等性を確保）
+COPIED=0
+SKIPPED=0
+
+for SRC_PATH in "$SRC_DIR"/*.md; do
+  [ -f "$SRC_PATH" ] || continue
+  FILENAME=$(basename "$SRC_PATH")
+  DEST_PATH="$DEST_DIR/$FILENAME"
+
+  if [ -f "$DEST_PATH" ]; then
+    echo "ℹ️  既に存在するためスキップ: $DEST_PATH"
+    SKIPPED=$((SKIPPED + 1))
+  else
+    echo "🔨 コピー中: $SRC_PATH → $DEST_PATH"
+    cp "$SRC_PATH" "$DEST_PATH"
+    COPIED=$((COPIED + 1))
+  fi
+done
+
+# 6. 完了報告
+echo ""
+echo "✅ プロジェクトドキュメントを初期化しました。"
+echo "   カテゴリ: $CATEGORY ($SUBDIR)"
+echo "   コピー: ${COPIED} ファイル / スキップ: ${SKIPPED} ファイル"
+echo "   パス: $DEST_DIR"

package/scripts/init-task-doc.sh

@@ -0,0 +1,77 @@
+#!/bin/bash
+
+# init-task-doc.sh
+# タスクディレクトリにテンプレートから指定のドキュメントをコピーするスクリプト
+# Usage: bash scripts/init-task-doc.sh <task-dir> <type>
+#   type: definition | research | implementation
+# 例:    bash scripts/init-task-doc.sh docs/tasks/task000001-user-profile-edit definition
+
+set -e
+
+TASK_DIR="$1"
+DOC_TYPE="$2"
+
+# スクリプト自身の位置からテンプレートルートを解決（.claude/scripts -> .claude/templates）
+SCRIPT_SELF_DIR="$(cd "$(dirname "$0")" && pwd)"
+TEMPLATE_ROOT="$SCRIPT_SELF_DIR/../templates/tasks/task-template"
+
+echo "📝 タスクドキュメントの初期化を開始します..."
+
+# 1. 引数チェック
+if [ -z "$TASK_DIR" ] || [ -z "$DOC_TYPE" ]; then
+  echo "❌ 引数が不足しています。"
+  echo "   使い方: bash scripts/init-task-doc.sh <task-dir> <type>"
+  echo "   type:   definition | research | implementation"
+  echo "   例:     bash scripts/init-task-doc.sh docs/tasks/task000001-login definition"
+  exit 1
+fi
+
+# 2. タスクディレクトリの存在確認
+if [ ! -d "$TASK_DIR" ]; then
+  echo "❌ タスクディレクトリが存在しません: $TASK_DIR"
+  echo "   先に /b-001-create-task-directory を実行してください。"
+  exit 1
+fi
+
+# 3. type をファイル名にマッピング
+case "$DOC_TYPE" in
+  definition)
+    SRC_FILE="a-definition.md"
+    ;;
+  research)
+    SRC_FILE="b-research.md"
+    ;;
+  implementation)
+    SRC_FILE="c-implementation.md"
+    ;;
+  *)
+    echo "❌ 不明な type: '$DOC_TYPE'"
+    echo "   有効な type: definition | research | implementation"
+    exit 1
+    ;;
+esac
+
+SRC_PATH="$TEMPLATE_ROOT/$SRC_FILE"
+DEST_PATH="$TASK_DIR/$SRC_FILE"
+
+# 4. テンプレートの存在確認
+if [ ! -f "$SRC_PATH" ]; then
+  echo "❌ テンプレートが見つかりません: $SRC_PATH"
+  echo "   yodogawa CLI での再インストールを検討してください。"
+  exit 1
+fi
+
+# 5. 既存ファイルはスキップ（冪等性）
+if [ -f "$DEST_PATH" ]; then
+  echo "ℹ️  既に存在するためスキップ: $DEST_PATH"
+  exit 0
+fi
+
+# 6. コピー
+echo "🔨 コピー中: $SRC_PATH → $DEST_PATH"
+cp "$SRC_PATH" "$DEST_PATH"
+
+# 7. 完了報告
+echo ""
+echo "✅ タスクドキュメントを初期化しました。"
+echo "   パス: $DEST_PATH"