@takuma-hirai/hirai-method 0.1.0

package/.claude/commands/create-tool.md

@@ -0,0 +1,496 @@
+---
+name: create
+description: "コマンド/スキル/サブエージェント/Hook作成 - 対話形式で新しいコンポーネントを生成"
+category: meta
+complexity: enhanced
+model: sonnet
+mcp-servers: []
+---
+
+# /create - コンポーネント作成コマンド
+
+## 概要
+
+コマンド、スキル、サブエージェント、Hookを対話形式で作成するメタコマンド。
+ヒアリング → 構成提案 → 仕様確認 → ファイル生成 → 一覧更新 の流れで実行します。
+
+## 使用方法
+
+```bash
+# タイプを指定して作成
+/create command     # 新しいワークフローコマンドを作成
+/create skill       # 新しいスキルを作成
+/create subagent    # 新しいサブエージェントを作成
+/create hook        # 新しいHookを作成
+
+# 対話形式でタイプを選択
+/create
+```
+
+## 作成可能なタイプ
+
+| タイプ | 配置先 | 説明 |
+|--------|--------|------|
+| `command` | `.claude/commands/` | ワークフローコマンド（/requirement, /design等） |
+| `skill` | `.claude/commands/` | ヘルパースキル（/context-fetch, /notification等） |
+| `subagent` | `.claude/agents/` | 特化型サブエージェント |
+| `hook` | `.claude/hooks/` | Pre/Post/Notification Hook |
+
+## 実行フロー
+
+```
+/create [type]
+  ↓
+Phase 1: タイプ選択
+  ↓
+Phase 2: ヒアリング
+  ↓
+Phase 3: 構成提案
+  ↓
+Phase 4: 依存コンポーネント作成  ← コマンド作成時のみ
+  ↓
+Phase 5: 仕様確認
+  ↓
+Phase 6: ファイル生成（コマンド + 依存コンポーネント一括）
+  ↓
+Phase 7: 一覧更新
+```
+
+### Phase 1: タイプ選択
+タイプが指定されていない場合、以下から選択を促す：
+- command: ワークフローを定義するコマンド
+- skill: 他のコマンドから呼び出されるヘルパー
+- subagent: 特定ドメインに特化したエージェント
+- hook: ツール実行前後に自動実行される処理
+
+### Phase 2: ヒアリング
+
+#### 共通項目
+1. **名前**: コマンド/スキル/エージェント/Hook名（英小文字、ハイフン区切り）
+2. **説明**: 日本語での簡潔な説明
+3. **目的・ユースケース**: 何を解決するか、どんな場面で使うか
+
+#### コマンド/スキル固有
+4. **カテゴリ**: workflow / skill / utility
+5. **複雑度**: basic / enhanced
+6. **MCP連携**: asana / slack / github / salesforce / context7 / なし
+7. **入力**: 必要なパラメータ
+8. **出力**: 生成されるファイルや結果
+
+#### サブエージェント固有
+4. **専門領域**: どの分野に特化するか
+5. **使用ツール**: どのツールを主に使用するか
+6. **呼び出し元**: どのコマンドから呼ばれるか
+
+#### Hook固有
+4. **Hookタイプ**: PreToolUse / PostToolUse / Notification / Stop
+5. **トリガー条件**: どのツール/イベントで発火するか
+6. **実行内容**: 何を行うか
+
+### Phase 3: 構成提案
+
+ヒアリング結果に基づき、以下を提案：
+- ファイル構造
+- 関連する既存コマンド/スキルとの連携
+- 推奨するMCP連携
+- テンプレート選択
+- **必要な依存コンポーネント（新規作成が必要なサブエージェント/スキル）**
+
+```markdown
+## 構成提案
+
+### ファイル構造
+.claude/
+├── commands/
+│   └── {command-name}.md
+├── agents/
+│   └── {subagent-name}.md      # 新規作成
+└── commands/
+    └── {skill-name}.md         # 新規作成
+
+### 連携コンポーネント
+#### 既存（再利用）
+- /context-fetch: 情報収集に利用
+- /notification: 通知送信に利用
+
+#### 新規作成が必要
+- subagent: {subagent-name} - {説明}
+- skill: {skill-name} - {説明}
+
+### MCP連携
+- asana: タスク管理
+- slack: 通知
+```
+
+### Phase 4: 依存コンポーネント作成（コマンド作成時のみ）
+
+コマンド作成時に、依存するサブエージェント/スキルの作成を行う。
+
+#### 4-1: 依存コンポーネント確認
+```
+このコマンドで使用する新規コンポーネントを作成しますか？
+
+提案された新規コンポーネント:
+1. [subagent] salesforce-validator - Salesforceメタデータの検証を行う
+2. [skill] coverage-check - テストカバレッジをチェックする
+
+選択肢:
+- すべて作成する
+- 選択して作成する（番号指定）
+- スキップ（既存のみ使用）
+```
+
+#### 4-2: サブエージェント作成フロー
+新規サブエージェントが必要な場合、以下をヒアリング：
+1. **専門領域**: どの分野に特化するか
+2. **責務**: 何を担当するか
+3. **使用ツール**: どのツールを主に使用するか
+4. **入出力**: 何を受け取り、何を返すか
+
+#### 4-3: スキル作成フロー
+新規スキルが必要な場合、以下をヒアリング：
+1. **機能**: 何をするスキルか
+2. **入力**: 必要なパラメータ
+3. **出力**: 返却する結果
+4. **MCP連携**: 使用するMCPサーバー
+
+#### 4-4: Hook作成フロー（必要な場合）
+コマンド実行前後にHookが必要な場合、以下をヒアリング：
+1. **Hookタイプ**: Pre/Post/Notification
+2. **トリガー**: いつ発火するか
+3. **実行内容**: 何を行うか
+
+### Phase 5: 仕様確認
+
+提案内容（コマンド + 依存コンポーネント）をユーザーに確認し、必要に応じて修正。
+
+```markdown
+## 作成予定ファイル一覧
+
+| タイプ | 名前 | 配置先 |
+|--------|------|--------|
+| command | deploy-check | .claude/commands/deploy-check.md |
+| subagent | salesforce-validator | .claude/agents/salesforce-validator.md |
+| skill | coverage-check | .claude/commands/coverage-check.md |
+
+この内容でよろしいですか？
+```
+
+### Phase 6: ファイル生成
+
+確定した仕様に基づきファイルを生成。
+
+#### コマンド/スキル テンプレート
+
+```markdown
+---
+name: {name}
+description: "{description}"
+category: {category}
+complexity: {complexity}
+mcp-servers: [{mcp-servers}]
+---
+
+# /{name} - {title}
+
+## 概要
+
+{overview}
+
+## トリガー
+
+- {trigger1}
+- {trigger2}
+
+## 使用方法
+
+\`\`\`
+/{name} [引数]
+\`\`\`
+
+## 実行フロー
+
+### Step 1: {step1_title}
+{step1_content}
+
+### Step 2: {step2_title}
+{step2_content}
+
+## 出力物
+
+{outputs}
+
+## MCP連携
+
+| MCP | 用途 |
+|-----|------|
+| {mcp1} | {usage1} |
+
+## 注意事項
+
+- {note1}
+- {note2}
+
+## 次のステップ
+
+{next_steps}
+```
+
+#### サブエージェント テンプレート
+
+```markdown
+---
+name: {name}
+description: "{description}"
+type: subagent
+domain: {domain}
+tools: [{tools}]
+---
+
+# {name} - サブエージェント
+
+## 専門領域
+
+{domain_description}
+
+## 責務
+
+- {responsibility1}
+- {responsibility2}
+
+## 使用ツール
+
+| ツール | 用途 |
+|--------|------|
+| {tool1} | {usage1} |
+
+## 呼び出しパターン
+
+\`\`\`
+PM Agent → {name} → [処理] → 結果返却
+\`\`\`
+
+## 入出力
+
+### 入力
+{inputs}
+
+### 出力
+{outputs}
+
+## 制約事項
+
+- {constraint1}
+- {constraint2}
+```
+
+#### Hook テンプレート
+
+```markdown
+---
+name: {name}
+description: "{description}"
+type: hook
+hook_type: {PreToolUse|PostToolUse|Notification|Stop}
+triggers: [{triggers}]
+---
+
+# {name} - Hook
+
+## Hookタイプ
+
+{hook_type}: {hook_type_description}
+
+## トリガー条件
+
+- ツール: {tool_name}
+- 条件: {condition}
+
+## 実行内容
+
+\`\`\`bash
+{script_content}
+\`\`\`
+
+## 設定例
+
+`.claude/settings.json` への追加:
+
+\`\`\`json
+{
+  "hooks": {
+    "{hook_type}": [
+      {
+        "matcher": "{matcher}",
+        "hooks": ["{hook_command}"]
+      }
+    ]
+  }
+}
+\`\`\`
+
+## 注意事項
+
+- {note1}
+- {note2}
+```
+
+### Phase 7: 一覧更新
+
+以下のファイルを自動更新：
+- `doc/manual/COMMAND-REFERENCE.md` - コマンド一覧に追加（コマンド + 依存コンポーネント全て）
+
+## 出力物
+
+```
+.claude/
+├── commands/
+│   ├── {command-name}.md   # メインコマンド
+│   └── {skill-name}.md     # 依存スキル（新規作成時）
+├── agents/
+│   └── {subagent-name}.md  # 依存サブエージェント（新規作成時）
+└── hooks/
+    └── {hook-name}.md      # 依存Hook（新規作成時）
+
+doc/manual/
+└── COMMAND-REFERENCE.md    # 一覧更新（全コンポーネント）
+```
+
+## 使用例
+
+### 例1: 新しいワークフローコマンドを作成（依存コンポーネント含む）
+
+```
+User: /create command
+
+AI: 新しいコマンドを作成します。以下の項目を教えてください。
+
+    1. コマンド名は何にしますか？
+User: deploy-check
+
+AI: 2. このコマンドの説明を教えてください。
+User: デプロイ前の検証を自動実行する
+
+AI: 3. 目的・ユースケースを教えてください。
+User: PRマージ前にApexテスト、静的解析、カバレッジチェックを一括実行したい
+
+AI: 4. MCP連携は必要ですか？
+User: github, salesforce
+
+AI: 構成を提案します...
+
+## 構成提案
+
+### ファイル構造
+.claude/
+├── commands/
+│   └── deploy-check.md
+├── agents/
+│   └── salesforce-validator.md    # 新規作成提案
+└── commands/
+    └── coverage-check.md          # 新規作成提案
+
+### 連携コンポーネント
+#### 既存（再利用）
+- /notification: 結果通知に利用
+
+#### 新規作成が必要
+- subagent: salesforce-validator - Salesforceメタデータの検証を行う
+- skill: coverage-check - テストカバレッジをチェックする
+
+AI: このコマンドで使用する新規コンポーネントを作成しますか？
+
+    提案された新規コンポーネント:
+    1. [subagent] salesforce-validator - Salesforceメタデータの検証
+    2. [skill] coverage-check - テストカバレッジのチェック
+
+    選択肢:
+    - すべて作成する
+    - 選択して作成する（番号指定）
+    - スキップ（既存のみ使用）
+
+User: すべて作成する
+
+AI: サブエージェント「salesforce-validator」について教えてください。
+    1. 主な責務は何ですか？
+User: Apexクラスのコンパイル検証、メタデータ整合性チェック
+
+AI: 2. 使用するツールは？
+User: salesforce MCP
+
+AI: スキル「coverage-check」について教えてください。
+    1. どのような出力を返しますか？
+User: カバレッジ率、未カバー行のリスト
+
+AI: 作成予定ファイル一覧:
+
+| タイプ | 名前 | 配置先 |
+|--------|------|--------|
+| command | deploy-check | .claude/commands/deploy-check.md |
+| subagent | salesforce-validator | .claude/agents/salesforce-validator.md |
+| skill | coverage-check | .claude/commands/coverage-check.md |
+
+この内容でよろしいですか？
+User: はい
+
+AI: ファイルを生成しました。
+    - .claude/commands/deploy-check.md
+    - .claude/agents/salesforce-validator.md
+    - .claude/commands/coverage-check.md
+    - doc/manual/COMMAND-REFERENCE.md を更新
+```
+
+### 例2: 新しいHookを作成
+
+```
+User: /create hook
+
+AI: 新しいHookを作成します。以下の項目を教えてください。
+
+    1. Hook名は何にしますか？
+User: commit-message-validator
+
+AI: 2. Hookタイプを選択してください。
+    - PreToolUse: ツール実行前
+    - PostToolUse: ツール実行後
+    - Notification: 通知時
+    - Stop: 停止時
+User: PreToolUse
+
+AI: 3. どのツールで発火しますか？
+User: Bash(git commit*)
+
+AI: 4. 実行内容を教えてください。
+User: コミットメッセージがConventional Commits形式か検証する
+
+AI: 構成を提案します...
+[構成提案を表示]
+
+AI: この内容でよろしいですか？
+User: はい
+
+AI: ファイルを生成しました。
+    - .claude/hooks/commit-message-validator.md
+    - .claude/settings.json を更新
+    - doc/manual/COMMAND-REFERENCE.md を更新
+```
+
+## 関連コマンド
+
+- `/requirement` - 要件定義フェーズ
+- `/design` - 設計フェーズ
+- `/build` - 構築フェーズ
+
+## 注意事項
+
+- コマンド名は英小文字とハイフンのみ使用可能
+- 既存のコマンド名と重複しないよう注意
+- Hook作成時は `.claude/settings.json` も更新される
+- 作成後は必ず動作確認を行う
+
+## 次のステップ
+
+コマンド作成後:
+1. 動作確認
+2. 必要に応じてテスト作成
+3. チームへの共有

package/.claude/commands/design-review.md

@@ -0,0 +1,138 @@
+---
+description: 設計 draft に対し reviewer-registry の design + security カテゴリ全 agent を並列起動して fan-out レビューを実行する。
+---
+
+# /design-review — 設計レビュー fan-out
+
+承認待ち設計 draft (`docs/draft/<slug>.md`) を読み、`harness-config.yml` の `reviewer_registry_design` + `reviewer_registry_security` に登録された agent を **並列起動** (`run_in_background: true` 必須) して fan-out レビューを実行。各 agent の findings を `docs/draft/<slug>-review.md` に集約する。
+
+## 前提
+
+- 対象 draft (`docs/draft/<slug>.md`) が存在する
+- `confidence-gate.sh` が subagent transcript path を正しく解決できる (commit 96da878 適用済)
+- `harness-config.yml` の reviewer_registry_* が定義されている
+
+## 使い方
+
+```
+/design-review <slug>                        # 既定: design + security 全 agent 並列起動 (min 3 強制、2026-05-26)
+/design-review <slug> --categories design    # design カテゴリのみ
+/design-review <slug> --max-reviewers 5      # 上限指定 (cost 制御、N ≥ 3 必須)
+/design-review <slug> --min-reviewers 3      # 下限指定 (default 3、N ≥ 3 必須、registry 件数不足時は user escalation)
+/design-review <slug> --skip-stack-filter    # stack heuristic 絞り込みを無効化
+```
+
+## 引数
+
+- `<slug>` — kebab-case、既存 `docs/draft/<slug>.md` の slug
+  - validation: `^[a-z0-9][a-z0-9-]{2,48}$` (git-workflow.md branch 規約準拠)
+  - path traversal 防止 (`.` `/` `..` 含む値は reject)
+
+## 動作
+
+### Phase 0: yml 参照 (task-45 Phase 2、reviewer 制御 yml 経由化)
+
+本 command 開始前に `harness-config.yml` から以下 4 値を参照 (env > yml > default、`config-loader.sh` 仕様):
+
+| 環境変数 | yml key | default | 用途 |
+|---|---|---:|---|
+| `HC_REVIEW_REQUIRED_DESIGN` | `review_required_design` | `true` | `false` なら本 command を **no-op skip** (理由付きでユーザに報告 + 終了) |
+| `HC_REVIEW_MIN_COUNT_DESIGN` | `review_min_count_design` | `3` | reviewer 範囲下限 (`--min-reviewers` 未指定時の default) |
+| `HC_REVIEW_MAX_COUNT_DESIGN` | `review_max_count_design` | `7` | reviewer 範囲上限 (`--max-reviewers` 未指定時の default) |
+| `HC_REVIEW_ITERATION_MAX` | `review_iteration_max` | `5` | Phase 4 反復ループ上限 (収束まで再 review、超過時 user escalation) |
+
+**起動前に必ず以下を実行して reviewer 数を確定する (task-64、散文参照でなく実行手順)**:
+
+```bash
+bash .claude/scripts/hc-config.sh --get review_required_design   # false なら本 command を no-op skip
+bash .claude/scripts/hc-config.sh --get review_min_count_design  # 範囲下限
+bash .claude/scripts/hc-config.sh --get review_max_count_design  # 範囲上限
+# → min ≤ 並列起動 reviewer 数 N ≤ max を保証して起動 (青天井禁止)。security category は review_required_security / review_min_count_security も別途確認。値解決順 env > harness-config.local.yml > harness-config.yml > default
+```
+
+`HC_REVIEW_REQUIRED_DESIGN=false` で skip した場合は、bypass.log に記録し、ユーザに「review_required_design=false のため /design-review を skip した、Phase 1 以降を実行しない」と明示。
+
+### Phase 1: 前提チェック
+
+1. slug を validation regex でチェック (不正なら reject)
+2. `docs/draft/<slug>.md` が存在することを確認
+3. `docs/draft/<slug>-review.md` が既存でないことを確認 (上書き防止)、存在時は `<slug>-review-2.md` `-3.md` と suffix 付与
+
+### Phase 2: reviewer-registry 読み込み + stack 推定
+
+1. `harness-config.yml` から `reviewer_registry_design` `_security` を読む
+2. 対象 draft 本文を読んで stack を heuristic 推定:
+   - mermaid 内 / 採用案 / 影響範囲セクションを grep
+   - `database` / `migration` / `RLS` keyword → database-reviewer を含む
+   - `API` / `endpoint` / `REST` / `GraphQL` → api-designer を含む
+   - `UI` / `component` / `frontend` keyword → ui-designer を含む
+   - DB/API/UI keyword 無 → 対応 reviewer を除外
+3. `--skip-stack-filter` 指定時は全件起動
+4. `--max-reviewers N` 指定時は最初の N 件に絞る
+
+### Phase 3: 並列 Agent fan-out (Loop モードでは無条件、Normal モードは user 確認 1 回)
+
+1. 選定 reviewer ごとに以下を実行:
+   - **TaskCreate** で subagent_id metadata 付きタスク登録 (CLAUDE.md §4 必須)
+   - **Agent tool** で起動 (`run_in_background: true` 必須):
+     - prompt: 共通テンプレ「対象 draft 全文 + 観点 (reviewer 別) + findings format (CRITICAL/HIGH/MED/LOW 分類, 具体修正提案、behavior-preserving) + 末尾 `confidence: 0.X` 必須 + **項目 5 プロジェクト整合性 + 他 task 影響確認** (必須、`workflow.md` §reviewer prompt 共通規約準拠): `docs/tasks/list.md` (他 task ledger) + 依存先 task.md / draft.md + `docs/tasks/next-actions.md` (副産物 registry) + `.claude/rules/*.md` (既存規範 Layer A 全 7 file) + `README.md` / `docs/INVENTORY.md` (project SSoT) + 既存実装 (Glob/Grep で `.claude/hooks/` `.claude/commands/` `.claude/skills/` 内類似探索) を Read。findings に「他 task #N との重複 / 競合 / 前提崩壊」「既存 rule §X と矛盾 / 拡張必要」「副産物 entry #Y を本対象で解決可能」「既存 hook/command/skill 再利用可 (再発明回避)」「SSoT 重複 / 矛盾」を該当時に必ず含める。bypass: `HC_REVIEW_PROJECT_CONTEXT_REQUIRED=false` (新規 feature 初回 round-1 / `.claude/rules/` 編集 change の review では NG)」
+2. 全 agent 起動後、メインは即座に user 制御に戻る (notification を待たない、ユーザは次操作可能)
+
+### Phase 4: 集約 + 収束判定 + 反復ループ (各 agent 完了通知到着時、2026-05-26 拡張)
+
+1. SubagentStop notification を受信したら以下を順次:
+   - findings を `docs/draft/<slug>-review.md` に追記 (reviewer 名 + severity 別)
+   - 並行起動中の他 reviewer はそのまま継続
+2. 全 reviewer 完了後、集約レポートを作成:
+   - severity 別件数サマリ表 (CRITICAL / HIGH / MEDIUM / LOW の 4 段階、各 reviewer prompt で severity 分類強制)
+   - blocking findings (CRITICAL / HIGH / MEDIUM) ハイライト
+   - 各 reviewer の confidence score 一覧
+3. **収束判定** (workflow.md §「収束条件」準拠、2026-05-26 追加):
+   - CRITICAL = 0 ∧ HIGH = 0 ∧ MEDIUM = 0 → 「収束」、draft ステータスを「承認待ち」に遷移可能 (LOW は許容、cosmetic finding として記録のみ)
+   - 1 件以上 → 「修正待ち」、draft 修正 → 再度 /design-review で **round-N+1 review**
+4. **反復ループ**:
+   - **reviewer 最低数**: 各 iter で **3 体以上** 並列起動 (default は reviewer-registry 全件 + stack heuristic 絞り込み、`--max-reviewers N` 指定時も `N ≥ 3` 必須、registry 件数不足で 3 体起動不能なら user escalation)
+   - **反復上限**: **5 回** (default)、超過時は user escalation
+   - **bypass**: `ECC_DESIGN_REVIEW_OFF=1` (反復 5 回上限超過時の user escalation 後の継続用、`.claude/.workflow-state/bypass.log` に append + draft §9 承認履歴末尾に bypass 理由追記)
+   - **iteration 記録**: 各 iter の reviewer 一覧 + 件数 (CRITICAL/HIGH/MEDIUM/LOW) + 修正 commit hash を `docs/draft/<slug>.md` §「レビューサイクル」table (`_DRAFT_TEMPLATE.md` §8) に append
+
+### Phase 5: ユーザ報告
+
+```
+🔍 Design Review 完了: docs/draft/<slug>-review.md
+
+並列起動 reviewer: N 件 (design X / security Y)
+集約結果: CRITICAL: A / HIGH: B / MEDIUM: C / LOW: D
+平均 confidence: 0.XX
+
+次の操作:
+  - CRITICAL/HIGH があれば draft 修正後、再度 /design-review で round-2 review
+  - 0 件なら user 明示承認 → /new-task で W2 タスク化
+```
+
+## 制約
+
+- 全 agent は **必ず** `run_in_background: true` (CLAUDE.md §1 必須、30 秒以内例外なし)
+- 各 agent 起動前後に **必ず** TaskCreate (CLAUDE.md §4 必須、subagent_id を metadata 記録)
+- 集約レポートは `docs/draft/` 配下に置く (`docs/draft/reviews/` サブディレクトリ案は v3 で検討)
+- bypass: `ECC_DESIGN_REVIEW_OFF=1` で fan-out skip (template 集約レポートのみ生成)
+
+## Loop モード時の特例
+
+- 起動前 user 確認なし (Loop モード「中間確認の停止」原則遵守)
+- 全件起動 (`--max-reviewers` 未指定時の制限なし)
+- CRITICAL/HIGH 自動修正提案も Why × 5 で評価して draft v2 を即適用
+
+## Normal モード時
+
+- 起動前に user に「N 件 reviewer を並列起動します。cost 影響 → 続行?」を 1 回確認
+- 集約後の draft 修正も user 確認
+
+## 関連
+
+- `/new-draft <slug>` — 設計 draft 起こし (本 command の前段)
+- `/test-design <slug>` — テスト設計 MECE (本 command と並行実行可能)
+- `/new-task <id> <slug>` — タスク化 (本 command + /test-design 完了後)
+- config: `.claude/harness-config.yml` の `reviewer_registry_*`
+- hook 依存: `.claude/hooks/confidence-gate.sh` (subagent transcript 解決 fix 適用済)
+- 設計 draft: `docs/draft/workflow-enforcement.md` §3 W2