yodogawa 1.0.7 → 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 / エディタ  | 使い方                                             |
-| :-------------- | :------------------------------------------------- |
-| **Windsurf**    | `.windsurf/workflows` として自動認識               |
-| **Cursor**      | `@filename.md` で参照、または `CLAUDE.md` に統合   |
-| **Antigravity** | `.agent/workflows` にコピーして参照                |
-| **Claude Code** | `CLAUDE.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
 ```
 
-これにより `.windsurf/workflows` とテンプレートがプロジェクトに配置されます。
+対話形式でIDEを選択すると、`skills/`, `templates/`, `scripts/` がプロジェクトの IDE ディレクトリに配置されます。
 
 ### 方法2: 手動導入
 
-このリポジトリの `.windsurf/workflows` ディレクトリを、プロジェクトにコピーしてください：
+このリポジトリの `skills/`, `templates/`, `scripts/` をプロジェクトの IDE ディレクトリにコピーしてください：
 
-- Windsurf: `.windsurf/workflows`
-- Cursor: `.cursor/rules` または `docs/workflows`
-- Antigravity: `.agent/workflows`
-- Claude Code: プロジェクトルート、または `CLAUDE.md` に統合
+- **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

@@ -6,17 +6,15 @@ const prompts = require('prompts');
 const { bold, green, cyan, red } = require('kleur');
 
 async function main() {
-  console.log(bold().cyan('\n🚀 Welcome to Yodogawa Slash Commands Installer!\n'));
+  console.log(bold().cyan('\n🚀 Welcome to Yodogawa Skills Installer!\n'));
 
   const response = await prompts({
     type: 'select',
     name: 'type',
     message: 'Which configuration would you like to install?',
     choices: [
-      { title: 'Windsurf (.windsurf)', value: 'windsurf' },
-      { title: 'Antigravity (.agent)', value: 'antigravity' },
-      { title: 'Cursor (.cursor)', value: 'cursor' },
-      { title: 'Claude Code (.claude)', value: 'claude' }
+      { title: 'Claude Code (.claude/skills/)', value: 'claude' },
+      { title: 'Other IDEs — Cursor / Codex / Antigravity (.agents/skills/)', value: 'agents' }
     ]
   });
 
@@ -25,29 +23,14 @@ async function main() {
     process.exit(0);
   }
 
-  // Determine source directory (where the package is installed)
-  const sourceDir = path.join(__dirname, '..', '.windsurf');
-  
-  // Determine target directory (current working directory of the user)
-  let targetDirName;
-  if (response.type === 'windsurf') {
-    targetDirName = '.windsurf';
-  } else if (response.type === 'antigravity') {
-    targetDirName = '.agent';
-  } else if (response.type === 'cursor') {
-    targetDirName = '.cursor';
-  } else {
-    targetDirName = '.claude';
-  }
-  
+  const pkgRoot = path.join(__dirname, '..');
+  const dirMap = {
+    claude: '.claude',
+    agents: '.agents',
+  };
+  const targetDirName = dirMap[response.type];
   const targetDir = path.join(process.cwd(), targetDirName);
 
-  if (!fs.existsSync(sourceDir)) {
-    console.error(red(`✖ Error: Source directory not found at ${sourceDir}`));
-    console.error(red(`  Please ensure the package is installed correctly.`));
-    process.exit(1);
-  }
-
   try {
     if (fs.existsSync(targetDir)) {
       const confirm = await prompts({
@@ -56,34 +39,25 @@ async function main() {
         message: `Directory ${targetDirName} already exists. Overwrite?`,
         initial: false
       });
-
       if (!confirm.overwrite) {
         console.log(red('✖ Operation cancelled.'));
         process.exit(0);
       }
     }
 
-    console.log(`\nCopying workflows to ${bold(targetDirName)}...`);
-    await fs.copy(sourceDir, targetDir);
+    console.log(`\nInstalling Yodogawa skills to ${bold(targetDirName)}...`);
 
-    // Special handling for Cursor and Claude Code: rename workflows to commands
-    if (response.type === 'cursor' || response.type === 'claude') {
-      const workflowsDir = path.join(targetDir, 'workflows');
-      const commandsDir = path.join(targetDir, 'commands');
-      
-      if (fs.existsSync(workflowsDir)) {
-        console.log(`Renaming workflows to commands for ${response.type}...`);
-        await fs.move(workflowsDir, commandsDir, { overwrite: true });
-      }
-    }
-    
-    console.log(green(`\n✔ Successfully installed ${response.type} workflows!`));
+    await fs.copy(path.join(pkgRoot, 'skills'), path.join(targetDir, 'skills'));
+    await fs.copy(path.join(pkgRoot, 'templates'), path.join(targetDir, 'templates'));
+    await fs.copy(path.join(pkgRoot, 'scripts'), path.join(targetDir, 'scripts'));
+
+    console.log(green(`\n✔ Successfully installed Yodogawa skills for ${response.type}!`));
     console.log(`\nNext steps:`);
-    console.log(`1. Open ${bold(targetDirName)} to explore the workflows.`);
+    console.log(`1. Open ${bold(targetDirName + '/skills/')} to explore the skills.`);
     console.log(`2. Start using them in your project!\n`);
-    
+
   } catch (err) {
-    console.error(red(`\n✖ Error copying files: ${err.message}`));
+    console.error(red(`\n✖ Error installing skills: ${err.message}`));
     process.exit(1);
   }
 }

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "yodogawa",
-  "version": "1.0.7",
+  "version": "2.1.0",
   "description": "CLI to install Yodogawa Slash Commands workflows",
   "bin": {
-    "yodogawa": "./bin/cli.js"
+    "yodogawa": "bin/cli.js"
   },
   "files": [
     "bin",
-    ".windsurf",
+    "skills",
+    "templates",
+    "scripts",
     "README.md",
     "CHANGELOG.md"
   ],
@@ -18,10 +20,10 @@
     "prepare": "husky"
   },
   "keywords": [
-    "windsurf",
     "antigravity",
     "cursor",
     "claude-code",
+    "codex",
     "workflows",
     "slash-commands",
     "spec-driven-development",

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

@@ -0,0 +1,67 @@
+---
+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"
+```

package/skills/a-002-initialize-project/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: a-002-initialize-project
+description: プロジェクトの要件を対話形式で収集し、システム概要・機能要件・非機能要件・ユーザーストーリーのドキュメントを生成する。新規プロジェクト開始時、または要件が未整備の場合に使用。
+disable-model-invocation: true
+allowed-tools: Read, Write, Edit, Bash, Grep, Glob
+---
+
+# InitializeProject (a-002)
+
+## 目的
+
+- プロジェクトの目的・背景・機能要件を詳細にヒアリングし、具体的で実装可能なドキュメントを作成する。
+- システム概要・実装済み機能・予定機能・非機能要件・ユーザーストーリーを網羅する。
+- 抽象的・曖昧な表現を避け、対話を通じて具体的な数値・期限・制約・優先度を明確化する。
+
+## 前提
+
+- `docs/project/requirements/` ディレクトリが存在すること（なければ先に `/a-001-setup-doc-structure` を実行）
+- `docs/` に書き込み権限があること
+- ユーザーがプロジェクト概要と主要機能の基本情報を提供できること
+
+## 手順
+
+### 1. ドキュメントディレクトリの確認
+
+```bash
+ls -la docs/project/requirements/ 2>/dev/null || echo "ディレクトリが存在しません"
+```
+
+存在しない場合: 「`docs/project/requirements/` がありません。先に `/a-001-setup-doc-structure` を実行してください。」
+
+### 2. コードベースの自動分析と提案
+
+**規模確認**:
+
+```bash
+ls -F
+```
+
+ファイルがほとんど無い／ソースコードが無い場合はスキップし、ユーザーへ通知。
+
+**詳細調査**（コードがある場合）:
+
+```bash
+cat package.json 2>/dev/null
+cat README.md 2>/dev/null
+find src app lib -maxdepth 2 2>/dev/null
+```
+
+結果から以下を推測・提示: システム概要（目的・技術スタック）、実装済み機能（ファイル構造からの推測）、想定ユーザー像。
+
+### 3. システム概要の作成
+
+1. テンプレートをコピー:
+
+   ```bash
+   SCRIPT_DIR=$(for d in .agent .cursor .claude .codex; do [ -d "$d" ] && echo "$d" && break; done)
+   cp "$SCRIPT_DIR/templates/project/01-requirements/01-system-overview.md" \
+      "docs/project/requirements/01-system-overview.md"
+   ```
+
+2. 「背景」「目的」をヒアリングして記入。質問例は [reference/hearing-questions.md](reference/hearing-questions.md) を参照。
+
+### 4. 実装済み機能一覧
+
+1. `02-features-implemented.md` をテンプレートからコピー。
+2. コードベースを調査し、検出したディレクトリ/ファイル名から機能を提案。
+3. ヒアリング結果をテーブルに記入（Category 1/2、機能名、説明、機能 ID）。
+
+コード調査コマンドとヒアリング項目は [reference/hearing-questions.md](reference/hearing-questions.md#手順4-実装済み機能一覧) を参照。
+
+### 5. 予定機能一覧
+
+1. `03-features-planned.md` をテンプレートからコピー。
+2. システム概要と実装済み機能のギャップを分析し、未実装機能を提案。
+3. ヒアリング結果をテーブルに記入（機能 ID・優先度は未確定のまま）。
+
+### 6. 非機能要件一覧
+
+1. `04-non-functional-requirements.md` をテンプレートからコピー。
+2. 詳細定義が必要か確認。不要なら標準ベースラインで仮置き（[examples/nfr-baseline.md](examples/nfr-baseline.md)）。
+3. パフォーマンス/セキュリティ/可用性/スケーラビリティ/ユーザビリティ・保守性の観点で**定量的な目標**をヒアリング。
+
+### 7. ユーザーストーリー
+
+1. `05-user-stories.md` をテンプレートからコピー。
+2. 作成済みドキュメントから主要ユーザージャーニーを抽出し、ストーリー案を提示。
+3. ヒアリング結果をテーブルに記入（優先度・受け入れ基準含む）。
+
+ストーリーテンプレート: 「[役割]として、[〇〇機能]を使いたい、なぜなら[価値]だから」
+
+### 8. 全体レビュー
+
+- 作成した全ドキュメントをユーザーに提示し、以下を確認:
+  - 「記載内容に誤りや漏れはありませんか？」
+  - 「抽象的すぎる記述や、解釈が分かれそうな表現はありますか？」
+  - 「テンプレートのコメントや不要な例示は適切に処理されていますか？」
+
+### 9. 完了条件と構造の確認
+
+- ファイルの存在と主要セクション/テーブル構造を検証。
+- 検証コマンド・チェックリスト・Git コミット手順は [reference/structure-check.md](reference/structure-check.md) を参照。
+
+### 10. Git への追加（オプション）
+
+詳細は [reference/structure-check.md](reference/structure-check.md#git-への追加オプション) を参照。
+
+## 完了条件
+
+- `docs/project/requirements/` に 5 つの要件定義ドキュメントが作成されている
+- すべてのドキュメントで抽象的表現が最小化され、具体的な数値・期限・制約が記載されている
+- ユーザーがドキュメント内容を確認し、承認またはフィードバックを提供している
+
+## エスカレーション
+
+- **ユーザーが重要な情報を提供できない**: 「この情報は後続の設計・実装で必須です。確認できる担当者や資料はありますか？」と確認し、TODO として記録。
+- **競合する要件や矛盾**: 「以下の要件が競合しています: [詳細]。優先順位や調整方針を確認させてください。」と報告。
+- **想定工数が非現実的に大きい**: 「現在の計画では実現が困難です。スコープ縮小や優先度調整を検討しませんか？」と提案。
+
+## 参考
+
+- [reference/hearing-questions.md](reference/hearing-questions.md) — 手順3〜7のヒアリング質問集
+- [reference/structure-check.md](reference/structure-check.md) — 手順9の構造チェックコマンドと Git コミット手順
+- [examples/nfr-baseline.md](examples/nfr-baseline.md) — 非機能要件の標準ベースライン提案値

package/skills/a-002-initialize-project/examples/nfr-baseline.md

@@ -0,0 +1,38 @@
+# 非機能要件の標準ベースライン
+
+SKILL.md 手順6で「標準的な設定で仮置き」する際の提案値。
+
+## Web アプリケーションの一般的な目標値
+
+### パフォーマンス
+
+- ページ読み込み: 3 秒以内
+- API 応答: 500ms 以内
+
+### セキュリティ
+
+- HTTPS 必須
+- パスワードはハッシュ化（bcrypt 推奨）
+- 認証方式: 基本認証 / OAuth
+
+### 可用性
+
+- 稼働率: 99.5%（平日日中）
+- 日次バックアップ
+
+### スケーラビリティ
+
+- 想定同時接続数の 2 倍のバースト耐性
+- 水平スケーリング可能なアーキテクチャ
+
+### ユーザビリティ
+
+- WCAG 2.1 レベル AA 準拠（アクセシビリティ）
+- 対応ブラウザ: 最新 2 バージョン（Chrome / Safari / Edge / Firefox）
+- レスポンシブデザイン（PC / タブレット / モバイル）
+
+### 保守性
+
+- 構造化ログ（JSON 形式）
+- 監視: APM + アラート通知
+- デプロイ: 日次 or オンデマンド