forge-skill-orchestrator

name	forge-skill-orchestrator
description	Use at the START of every task, before writing any code, running tests, debugging, reviewing, or designing. This skill determines which methodology and domain skills must be invoked. MUST be invoked before any implementation, debugging, review, testing, or specification work begins.

Forge Skill Orchestrator

1% ルール

1% でも適用される可能性があれば、そのスキルを呼び出せ。

スキルの呼び出しコストは低い。呼び出さなかったことによる品質低下コストは高い。 迷ったら呼び出す。迷わなくても呼び出す。

フェーズ検出テーブル

現在のコマンド名または作業内容からフェーズを判定する:

コマンド / 作業内容	フェーズ	Domain Skill 読み込み
/brainstorm	design	Read: constraints.md
/spec	spec	Read: design.md
/implement	implementation	Skill ツール（SKILL.md 全体）
/review	review	Skill ツール（SKILL.md 全体）
/test	test	Skill ツール（SKILL.md 全体）
/compound	documentation	Skill ツール（SKILL.md 全体）
/ship	all（フェーズ遷移あり）	フェーズごとに切替
バグ修正・エラー対応	debug	Skill ツール（SKILL.md 全体）
コード変更・新機能追加	implementation	Skill ツール（SKILL.md 全体）
コードレビュー依頼	review	Skill ツール（SKILL.md 全体）
テスト実行・修正	test	Skill ツール（SKILL.md 全体）
設計・要件整理	design / spec	Read: design.md

ドメイン検出

対象ファイルのパスパターンに基づいてドメインを判定する。ドメインスキルは Auto-Discovery で自動検出される。

• プロジェクト固有スキル（<project>/.claude/skills/）およびグローバルスキル（~/.claude/skills/）に配置されたドメインスキルを Claude Code が自動検出する
• 複数ドメインにまたがる場合は、該当する全ドメインの Union で適用する
• ドメインスキルが存在しない場合は、Methodology Skills のみで処理を進める

Methodology Skills レジストリ（universal -- 全ドメイン共通）

Skill 名	適用フェーズ	トリガー条件
test-driven-development	implementation, debug	コードを書く前。新機能実装、バグ修正、リファクタリング時
systematic-debugging	debug, implementation, test	バグ、テスト失敗、ビルドエラー、予期しない動作の発生時
verification-before-completion	ALL（完了境界）	タスク完了宣言の直前。「完了」と言う前に必ず
iterative-retrieval	ALL	サブエージェントとして起動された時。コードベース探索の開始時
strategic-compact	ALL	コンテキストウィンドウ 80% 超過時。フェーズ切り替え時。大量出力処理後
dispatching-parallel-agents	debug, implementation	3つ以上の独立した失敗・タスクが存在し、並列調査が可能な時

Domain Skills について: Domain Skills は Auto-Discovery 方式に移行済み。 プロジェクト固有スキル（<project>/.claude/skills/）およびグローバルスキル（~/.claude/skills/）に 配置されたドメインスキルは Claude Code が自動検出するため、ここにレジストリとして列挙する必要はない。

サブエージェント向け指示

サブエージェントにはスキル名を渡す。Claude Code がスキル名から自動的にスキル内容を解決・読み込みする。

1. 親コマンド（/implement, /spec 等）の責務:

   • ドメイン・フェーズから適用スキルを決定する
   • フェーズ検出テーブルの「Domain Skill 読み込み」列に基づき、読み込み方式を決定する
     • Read の場合: DOMAIN CONTEXT FILES として Read パスをプロンプトに記載する
     • Skill ツールの場合: REQUIRED SKILLS としてスキル名をプロンプトに記載する
   • SKILL.md の内容を自分で読む必要はない

2. プロンプト記載テンプレート:

   Phase-Aware テンプレート（/brainstorm, /spec 用）:

   REQUIRED SKILLS:
   - iterative-retrieval
   - verification-before-completion
   
   DOMAIN CONTEXT FILES (Read ツールで直接読み込むこと):
   - ~/.claude/skills/<your-domain-skill>/<phase-file>.md
   ※ ファイルが存在しない場合は Skill ツールで <your-domain-skill> を呼び出す
   ※ 関連ドメイン Skill がない場合、このセクションは省略する
   

   Standard テンプレート（/implement, /review 等 用）:

   REQUIRED SKILLS:
   - test-driven-development
   - iterative-retrieval
   - verification-before-completion
   - [ドメイン固有スキル名]
   例: <your-domain-skill>
   

   Methodology Skills は常に Skill ツールで呼び出す。Phase-Aware ファイル（Read）はドメイン Skill のみに適用する。

3. スキル解決の優先順位:

   • プロジェクト固有スキル（<project>/.claude/skills/）が優先
   • グローバルスキル（~/.claude/skills/）がフォールバック
   • Skill ツール: Claude Code が自動解決するため、パス指定は不要
   • Read ツール（Phase-Aware）: プロジェクト固有パスを先に確認し、なければグローバルパスを使用

4. サブエージェントの責務:

   • エージェント定義の skills frontmatter で宣言されたスキルに従う
   • プロンプトで追加指定されたスキルにも従う

フォールバック機構

Phase-Aware ファイル（例: ~/.claude/skills/<your-domain-skill>/design.md）を Read ツールで読み込もうとしてファイルが存在しない場合:

1. SKILL.md にフォールバック: Skill ツールでスキル名（例: <your-domain-skill>）を呼び出し、SKILL.md 全体を読み込む
2. 警告を出力: 「[skill-name] の [phase-file].md が未作成です。/skill-format <skill-name> で分割してください」

フォールバックはファイル分割未実施の Skill への後方互換性を確保するための機構。 分割が完了した Skill では常に Phase-Aware ファイルが優先される。

決定フローチャート

START
  │
  ├─ 1. フェーズ判定
  │     └─ コマンド名 or 作業内容 → フェーズ検出テーブル → phases[], suffix
  │
  ├─ 2. ドメイン判定
  │     └─ 対象ファイルパス → Auto-Discovery でドメインスキル検出 → domains[]
  │
  ├─ 3. スキル照合
  │     ├─ Methodology Skills: phases[] でレジストリ照合 → matched_methodology[]
  │     └─ Domain Skills: domains[] から Auto-Discovery（Claude Code が自動検出） → matched_domain[]
  │
  ├─ 4. 読み込み方式決定
  │     ├─ Methodology Skills: Skill ツールで呼び出し（常に SKILL.md 全体）
  │     └─ Domain Skills:
  │        ├─ Phase-Aware ファイルあり → Read ツールでファイルパスを指定
  │        │  例: phase-file="design" → ~/.claude/skills/<your-domain-skill>/design.md
  │        │  ファイルが存在しない場合はフォールバック機構を適用
  │        └─ Phase-Aware ファイルなし → Skill ツールで呼び出し（SKILL.md 全体）
  │
  ├─ 5. Union
  │     └─ skills_to_invoke = matched_methodology ∪ matched_domain（サフィックス付き）
  │
  ├─ 6. 1% ルール適用
  │     └─ 「本当に除外してよいか？」を各 Skill について確認
  │     └─ 疑わしければ追加
  │
  ├─ 7. プロジェクトスキル考慮
  │     └─ Claude Code が検出したプロジェクト固有スキル（<project>/.claude/skills/）も
  │        ドメイン・フェーズとの関連性を判断して追加
  │
  └─ 8. 呼び出し
        ├─ メインセッション: `Skill` ツールで各スキルを名前で呼び出す
        └─ サブエージェント: プロンプトにテンプレートを記載
              ├─ Methodology Skills + Phase-Aware なし Domain Skills → REQUIRED SKILLS に記載
              └─ Phase-Aware あり Domain Skills → DOMAIN CONTEXT FILES に Read パスを記載

使用例

例 1: /implement でプロジェクトファイル実装時（Standard テンプレート）

1. フェーズ: implementation → サフィックス: なし
2. ドメイン: 対象ファイルのパスパターンから Auto-Discovery で判定
3. Methodology Skills: test-driven-development, verification-before-completion, iterative-retrieval
4. Domain Skills（Auto-Discovery）: <your-domain-skill> 等（サフィックスなし = SKILL.md 全体）
5. → Methodology Skills + 検出された Domain Skills を呼び出し

例 2: /spec で仕様策定時（Phase-Aware テンプレート）

1. フェーズ: spec → Phase-Aware ファイル: design.md
2. ドメイン: proposal.md の内容と各スキルの description を LLM セマンティック判定で照合
3. Methodology Skills（REQUIRED SKILLS）: iterative-retrieval, verification-before-completion
4. Domain Skills（DOMAIN CONTEXT FILES）:
   • ~/.claude/skills/<your-domain-skill>/design.md
5. → コンテキスト効率: Phase-Aware ファイルにより、SKILL.md 全体よりも大幅にトークン削減

例 3: /brainstorm でアイデア出し（Phase-Aware テンプレート）

1. フェーズ: design → Phase-Aware ファイル: constraints.md
2. ドメイン: 要件キーワードから Auto-Discovery で関連スキルを推論
3. Methodology Skills（REQUIRED SKILLS）: iterative-retrieval
4. Domain Skills（DOMAIN CONTEXT FILES）:
   • ~/.claude/skills/<your-domain-skill>/constraints.md
5. → コンテキスト効率: constraints.md のみの読み込みにより最小限のコンテキスト消費

例 4: ドメイン固有ファイルのデバッグ時（Standard テンプレート）

1. フェーズ: debug → サフィックス: なし
2. ドメイン: 対象ファイルのパスパターンから Auto-Discovery で判定
3. Methodology Skills: systematic-debugging, test-driven-development, iterative-retrieval
4. Domain Skills（Auto-Discovery）: <your-domain-skill> 等（サフィックスなし = SKILL.md 全体）
5. → Methodology Skills + 検出された Domain Skills を呼び出し

例 5: 3つ以上の独立したテスト失敗時

1. フェーズ: debug → サフィックス: なし
2. ドメイン: 各テストファイルから判定
3. Methodology Skills: systematic-debugging, dispatching-parallel-agents, iterative-retrieval
4. Domain Skills（Auto-Discovery）: 該当ドメインのスキルを自動検出（サフィックスなし = SKILL.md 全体）
5. → 並列エージェントで各失敗を独立調査