yodogawa 1.0.1 → 1.0.3

package/.windsurf/scripts/setup-docs.sh

@@ -0,0 +1,92 @@
+#!/bin/bash
+
+# setup-docs.sh
+# プロジェクトのドキュメントディレクトリ構造を作成するスクリプト
+
+set -e
+
+DOCS_DIR="docs"
+
+echo "📂 ドキュメント構造のセットアップを開始します..."
+
+# 1. 現在の状態確認
+if [ -d "$DOCS_DIR" ]; then
+  echo "⚠️  '$DOCS_DIR' ディレクトリは既に存在します。"
+  read -p "既存の構造を保持したまま、不足しているディレクトリを追加しますか？ (y/N): " confirm
+  if [[ ! "$confirm" =~ ^[Yy]$ ]]; then
+    echo "❌ 中断しました。"
+    exit 0
+  fi
+fi
+
+# 2. ディレクトリ構造の作成
+echo "🔨 ディレクトリを作成中..."
+mkdir -p "$DOCS_DIR/project/01-requirements"
+mkdir -p "$DOCS_DIR/project/02-behavior"
+mkdir -p "$DOCS_DIR/project/03-domain"
+mkdir -p "$DOCS_DIR/project/04-design"
+mkdir -p "$DOCS_DIR/tasks"
+
+# 3. docs/README.md の作成
+README_FILE="$DOCS_DIR/README.md"
+if [ -f "$README_FILE" ]; then
+  echo "⚠️  '$README_FILE' は既に存在します。"
+  read -p "上書きしますか？ (y/N): " confirm_readme
+  if [[ ! "$confirm_readme" =~ ^[Yy]$ ]]; then
+    echo "ℹ️  READMEの作成をスキップしました。"
+  else
+    CREATE_README=true
+  fi
+else
+  CREATE_README=true
+fi
+
+if [ "$CREATE_README" = true ]; then
+  echo "📝 README.md を作成中..."
+  cat > "$README_FILE" <<EOF
+# プロジェクトドキュメント
+
+このディレクトリには、プロジェクト全体のドキュメントと個別タスクのドキュメントを管理します。
+
+## 構成
+
+### project/
+プロジェクト全体のドキュメント。要件定義、設計、アーキテクチャなど、プロジェクトスコープ全体に関わる情報を記載します。
+
+- **01-requirements/**: 要件定義（システム概要、機能要件、非機能要件、ユーザーストーリーなど）
+- **02-behavior/**: 振る舞い定義（シナリオ、ユースケース、ユーザージャーニーなど）
+- **03-domain/**: ドメインモデル（エンティティ、用語集など）
+- **04-design/**: 設計（アーキテクチャ、データモデル、API仕様など）
+
+### tasks/
+個別タスクのドキュメント。Issue やチケット単位で作成します。
+
+## 更新方針
+
+### プロジェクト全体のドキュメント (project/)
+- プロジェクトのスコープ全体に影響する情報を記載
+- チーム全体で共有すべき要件・設計・アーキテクチャを管理
+- 更新時は関係者にレビューを依頼
+
+### 個別タスクのドキュメント (tasks/)
+- 特定の Issue やチケットに紐づく情報を記載
+- タスク単位で作成・完了・アーカイブ
+- 完了後は参照資料として保持、または削除
+
+## ドキュメント作成ガイドライン
+
+- **具体的**: 抽象的な表現を避け、数値・期限・制約を明確に記載
+- **測定可能**: 成功基準やパフォーマンス目標を定量化
+- **最新**: 変更があれば速やかに更新し、古い情報を残さない
+- **簡潔**: 必要最低限の情報に絞り、詳細はコードやリンク先に委ねる
+EOF
+fi
+
+# 4. 完了報告
+echo ""
+echo "✅ ドキュメントディレクトリ構造のセットアップが完了しました！"
+echo ""
+find "$DOCS_DIR" -maxdepth 2 | sort
+echo ""
+echo "次のステップ:"
+echo "  - 必要に応じて 'git add $DOCS_DIR' を実行してください。"

package/.windsurf/workflows/a-001-SetupDocStructure.md

@@ -5,8 +5,6 @@ auto_execution_mode: 1
 
 # SetupDocStructure (a-001)
 
-
-
 ## 目的
 
 - プロジェクトルートに標準化されたドキュメントディレクトリ構造を作成する。
@@ -19,110 +17,44 @@ auto_execution_mode: 1
 
 ## 手順
 
-### 1. 現在の状態確認
-
-- プロジェクトルートで `docs/` ディレクトリの存在を確認する：
-  ```bash
-  ls -la docs/ 2>/dev/null || echo "docs/ ディレクトリは存在しません"
-  ```
-- 既に `docs/` が存在する場合は、ユーザーに確認する：
-  - 「既に `docs/` ディレクトリが存在します。既存の構造を保持したまま、不足しているディレクトリを追加しますか？」
-  - ユーザーが「はい」と回答した場合のみ続行する。
-
-### 2. ディレクトリ構造の作成
+### 1. スクリプトの実行
 
-- 以下のディレクトリ構造を作成する：
+- ドキュメント構造セットアップのために、環境に応じたスクリプトを実行してください。
 
-```
-docs/
-├── project/
-│   ├── 01-requirements/    # 要件定義
-│   ├── 02-behavior/         # 振る舞い定義
-│   ├── 03-domain/           # ドメインモデル
-│   └── 04-design/           # 設計
-└── tasks/                   # 個別タスク
-```
-
-- `mkdir -p` コマンドで一括作成：
   ```bash
-  mkdir -p docs/project/01-requirements docs/project/02-behavior docs/project/03-domain docs/project/04-design docs/tasks
+  # 環境を自動検出してスクリプトを実行
+  if [ -d ".agent" ]; then
+    SCRIPT_DIR=".agent"
+  elif [ -d ".windsurf" ]; then
+    SCRIPT_DIR=".windsurf"
+  elif [ -d ".cursor" ]; then
+    SCRIPT_DIR=".cursor"
+  elif [ -d ".claude" ]; then
+    SCRIPT_DIR=".claude"
+  else
+    echo "エラー: AI coding assistant ディレクトリが見つかりません"
+    exit 1
+  fi
+
+  bash "$SCRIPT_DIR/scripts/setup-docs.sh"
   ```
 
-- 作成結果を確認：
-  ```bash
-  find docs/ -type d | sort
-  ```
-
-### 3. docs/README.md の作成
-
-- `docs/README.md` が既に存在する場合は、ユーザーに確認する：
-  - 「`docs/README.md` が既に存在します。上書きしますか、それとも既存のファイルを保持しますか？」
-
-- 以下の内容で `docs/README.md` を作成（または上書き）：
-
-```markdown
-# プロジェクトドキュメント
-
-このディレクトリには、プロジェクト全体のドキュメントと個別タスクのドキュメントを管理します。
-
-## 構成
+### 2. 結果の確認
 
-### project/
-プロジェクト全体のドキュメント。要件定義、設計、アーキテクチャなど、プロジェクトスコープ全体に関わる情報を記載します。
-
-- **01-requirements/**: 要件定義（システム概要、機能要件、非機能要件、ユーザーストーリーなど）
-- **02-behavior/**: 振る舞い定義（シナリオ、ユースケース、ユーザージャーニーなど）
-- **03-domain/**: ドメインモデル（エンティティ、用語集など）
-- **04-design/**: 設計（アーキテクチャ、データモデル、API仕様など）
-
-### tasks/
-個別タスクのドキュメント。Issue やチケット単位で作成します。
-
-## 更新方針
-
-### プロジェクト全体のドキュメント (project/)
-- プロジェクトのスコープ全体に影響する情報を記載
-- チーム全体で共有すべき要件・設計・アーキテクチャを管理
-- 更新時は関係者にレビューを依頼
-
-### 個別タスクのドキュメント (tasks/)
-- 特定の Issue やチケットに紐づく情報を記載
-- タスク単位で作成・完了・アーカイブ
-- 完了後は参照資料として保持、または削除
-
-## ドキュメント作成ガイドライン
-
-- **具体的**: 抽象的な表現を避け、数値・期限・制約を明確に記載
-- **測定可能**: 成功基準やパフォーマンス目標を定量化
-- **最新**: 変更があれば速やかに更新し、古い情報を残さない
-- **簡潔**: 必要最低限の情報に絞り、詳細はコードやリンク先に委ねる
-```
-
-### 4. 作成結果の確認
-
-- ディレクトリ構造とREADMEが正しく作成されたか確認：
-  ```bash
-  ls -R docs/
-  ```
-
-- ユーザーに作成結果を報告：
+- スクリプトの実行結果を確認し、エラーがないことを確認してください。
+- 生成された構造：
   ```
-  ✅ ドキュメントディレクトリ構造を作成しました：
-
   docs/
-  ├── README.md (作成済み - ドキュメント構成の説明)
+  ├── README.md
   ├── project/
   │   ├── 01-requirements/
   │   ├── 02-behavior/
   │   ├── 03-domain/
   │   └── 04-design/
   └── tasks/
-
-  次のステップ:
-  - ドキュメントの作成を開始してください。
   ```
 
-### 5. Git への追加（オプション）
+### 3. Git への追加（オプション）
 
 - ユーザーに確認：「作成したディレクトリ構造を Git に追加しますか？」
 - 「はい」の場合、以下を実行：
@@ -131,6 +63,7 @@ docs/
   git status
   ```
 - Git status の結果を表示し、コミットメッセージの提案をする：
+
   ```
   推奨コミットメッセージ:
   ドキュメント構造の初期化
@@ -139,13 +72,11 @@ docs/
   - ドキュメント構成を説明する docs/README.md を追加
   ```
 
-### 6. 完了条件の確認
+### 4. 完了条件の確認
 
 - 以下の完了条件を満たしているか、チェックリストで確認してください：
-  - [ ] `docs/` ディレクトリが作成されている
-  - [ ] `docs/project/` 配下に `01-requirements/`, `02-behavior/`, `03-domain/`, `04-design/` ディレクトリが存在する
-  - [ ] `docs/tasks/` ディレクトリが存在する
-  - [ ] `docs/README.md` が作成されている
+  - [ ] スクリプトが正常に終了した
+  - [ ] `docs/` ディレクトリ構造が正しく作成されている
 
 ## 完了条件
 
@@ -162,4 +93,4 @@ docs/
 - ファイルシステムの権限エラーが発生した場合：
   - 「ディレクトリの作成に失敗しました。書き込み権限を確認してください。」とユーザーに通知する。
 - Git リポジトリでない場合に Git 追加を試みた場合：
-  - 「このディレクトリは Git リポジトリではありません。Git の初期化が必要な場合は `git init` を実行してください。」と案内する。
+  - 「このディレクトリは Git リポジトリではありません。Git の初期化が必要な場合は `git init` を実行してください。」と案内する。

package/.windsurf/workflows/a-002-InitializeProject.md

@@ -33,18 +33,23 @@ auto_execution_mode: 1
 
 ### 2. コードベースの自動分析と提案
 
-1. **コードベースの全体調査**:
+1. **コードベースの規模確認**:
 
-   - プロジェクトのルートにある `README.md`, `package.json`, および主要なソースコードを読み込む。
-   - 以下のコマンド等を使用して現状を把握する:
+   - プロジェクトのルートにあるファイルやディレクトリを確認する。
      ```bash
      ls -F
+     ```
+   - **スキップ判断**:
+     - ファイルがほとんど存在しない（例: `.git` ディレクトリのみ、あるいは `README.md` だけなど）、または有意なソースコードが見当たらない場合は、このステップをスキップする。
+     - スキップする場合、ユーザーに「コードベースが空、または十分な情報がないため、自動分析をスキップします。」と通知し、次のステップへ進む。
+
+2. **詳細調査と分析（コードが存在する場合）**:
+   - `README.md`, `package.json`, および主要なソースコードを読み込む。
+     ```bash
      cat package.json 2>/dev/null
      cat README.md 2>/dev/null
      find src app lib -maxdepth 2 2>/dev/null
      ```
-
-2. **AI による分析と提案**:
    - 読み込んだ情報を基に、以下の内容を分析・推測し、ユーザーに提示する。
      - **システム概要**: プロジェクトの目的、主要な技術スタック。
      - **実装済み機能**: ファイル構造やコードから推測される機能。

package/package.json

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