workflow-creator

Workflow Creator スキル

複数のエージェントとフェーズ間の調整が必要な複雑なタスク向けに、マルチエージェントのオーケストレーションワークフローを作成します。

ROUTER の更新が必須です（重要 — 省略しないでください）

ワークフローを作成した後は必ず、CLAUDE.md のセクション 8.6「ENTERPRISE WORKFLOWS」を更新してください。

### {Workflow Name}

**Path:** `.claude/workflows/{category}/{workflow-name}.md`

**When to use:** {Trigger conditions}

**Phases:**

1. **{Phase Name}** - {Description}
   ...

**Agents Involved:**

- `{agent-name}` - {Role in workflow}

確認：

grep "{workflow-name}" .claude/CLAUDE.md || echo "ERROR: CLAUDE.md SECTION 8.6 NOT UPDATED!"

理由：CLAUDE.md に記載されていないワークフローは、Router から呼び出されることがありません。

---

このスキルが起動される場合

1. 複数のエージェントを必要とする複雑なオーケストレーションをユーザーが依頼した場合
2. 繰り返し実行する複数フェーズのプロセスを標準化する必要がある場合
3. Router が一般的なタスクパターンのワークフロー不足を特定した場合
4. 既存のワークフローを強化またはカスタマイズする場合

クイックリファレンス

操作	方法
既存のワークフローを確認	Glob: .claude/workflows/**/*.md
ワークフローテンプレートを確認	Read .claude/templates/workflows/workflow-template.md
関連するエージェントを検索	Glob: .claude/agents/**/*.md
関連するスキルを検索	Glob: .claude/skills/*/SKILL.md
ワークフローを作成	Write to .claude/workflows/<category>/<name>.md

ワークフローの種類

種類	場所	目的	例
Enterprise	.claude/workflows/enterprise/	複雑な複数フェーズの開発	feature-development, c4-architecture
Operations	.claude/workflows/operations/	ランタイム手順、インシデント対応	incident-response, deployment
Rapid	.claude/workflows/rapid/	迅速で的を絞ったタスクの自動化	fix, refactor, review
Custom	.claude/workflows/	プロジェクト固有のパターン	conductor-setup

ワークフロー・エージェントのアーキタイプリファレンス

ワークフローを作成する際は、どのエージェントのアーキタイプがそのワークフローを使用するかを判断してください。詳細は .claude/docs/@WORKFLOW_AGENT_MAP.md を参照してください。

• セクション 1：ワークフローとエージェントの完全な対応表
• セクション 2：アーキタイプごとのワークフローセット（Router/Orchestrator、Implementer、Reviewer、Documenter、Researcher、Domain）

ワークフローの作成後は、必ず対応表に追加し、影響を受けるエージェントの ## Related Workflows セクションも更新してください。

ワークフロー作成プロセス

ステップ 0：存在確認と Updater への委任（必須 — 最初に実施）

ワークフローファイルを作成する前に、必ず既存のファイルを確認してください。

1. ワークフローがすでに存在するか確認します。

   test -f .claude/workflows/<category>/<workflow-name>.md && echo "EXISTS" || echo "NEW"
   

2. ワークフローが存在する場合：

   • 作成を続行しないでください

   • 代わりに artifact-updater ワークフローを呼び出してください。

     Skill({
       skill: 'artifact-updater',
       args: {
         name: '<workflow-name>',
         changes: '<description of requested changes>',
         justification: 'Update requested via workflow-creator',
       },
     });
     

   • Updater の結果を返し、処理を停止してください

3. ワークフローが新規の場合：

   • 以下のステップ 0.5 に進みます

---

ステップ 0.1：スマートな重複検出（必須）

作成を進める前に、3 層の重複チェックを実行してください。

const { checkDuplicate } = require('.claude/lib/creation/duplicate-detector.cjs');
const result = checkDuplicate({
  artifactType: 'workflow',
  name: proposedName,
  description: proposedDescription,
  keywords: proposedKeywords || [],
});

結果への対応：

• EXACT_MATCH：作成を停止します。代わりに workflow-updater スキルにルーティングします：Skill({ skill: 'workflow-updater' })
• REGISTRY_MATCH：アーティファクトは登録されていますが、ファイルがない可能性があることをユーザーに警告します。作成前に調査し、ユーザーに確認してください。
• SIMILAR_FOUND：スコアとともに候補を表示します。ユーザーに「類似するアーティファクトが見つかりました。新規作成を続けますか、それとも既存のものを更新しますか？」と尋ねてください。
• NO_MATCH：ステップ 0.5（関連ファイルの確認）に進みます。

上書き：ユーザーが --force を明示的に指定した場合、このチェックを完全にスキップしてください。

---

Step 0.5：コンパニオンの確認

作成に進む前に、エコシステムのコンパニオン確認を実行します。

1. .claude/lib/creators/companion-check.cjs の companion-check.cjs を使用します
2. checkCompanions("workflow", "{workflow-name}") を呼び出して、コンパニオン成果物を特定します
3. コンパニオンチェックリストを確認し、不足している必須・推奨コンパニオンを記録します
4. この成果物の完成後に、不足しているコンパニオンを作成または確認する計画を立てます
5. 作成後の統合メモに、コンパニオンの確認結果を含めます

このステップは情報提供のみ（作成を妨げるものではありません）ですが、成果物エコシステム全体を考慮できるようにします。

---

Step 1：既存のワークフローがないことを確認

# Search for relevant workflows
Glob: .claude/workflows/**/*.md
Grep: "<topic>" in .claude/workflows/

適切なワークフローが存在する場合は、重複して作成するのではなく、既存のワークフローを拡張することを検討してください。

Step 2.5：ワークフローパターンの調査（必須）

ワークフローを作成する前に、既存のパターンを調査します。

1. 既存のワークフローを確認します：

Glob: .claude/workflows/**/*.md

2. ワークフローパターンを調査します（最低2件のクエリ）：

WebSearch({ query: 'best <domain/topic name> agent workflow process 2026' });
WebSearch({ query: 'industry standard <workflow-type> orchestration phases 2026' });

3. 見つかったパターンをワークフローのコメントに記載します

ブロッキング条件：パターン調査を行わないと、ワークフローの作成には進めません。これにより、解決策を一から作り直すのではなく、確立されたパターンに従ったワークフローを作成できます。

Step 2：フェーズとエージェントを特定

プロセスを分析してフェーズに分割します：

質問	決定する内容
どのような明確な段階がありますか？	フェーズの境界
各段階はどのエージェントが担当しますか？	エージェントの割り当て
並行して実行できる段階はありますか？	並列実行の機会
どの出力が次の段階に渡されますか？	データフローと引き継ぎ
各段階で何が問題になる可能性がありますか？	エラー回復手順

一般的なフェーズパターン：

パターン	フェーズ	使用する場面
発見 -> 設計 -> レビュー -> 実装	機能開発
分析 -> 修正 -> テスト -> デプロイ	バグ修正ワークフロー
調査 -> 計画 -> レビュー	計画ワークフロー
トリアージ -> 調査 -> 解決 -> 文書化	インシデント対応
コード -> コンポーネント -> コンテナー -> コンテキスト	C4 アーキテクチャの文書化

Step 3：エージェント間の引き継ぎを定義

各フェーズの移行について、次の内容を指定します。

### Phase 1 -> Phase 2 Handoff

**Output from Phase 1**: .claude/context/plans/phase1-output.md
**Input to Phase 2**: Read output from Phase 1
**Handoff validation**: [Check output exists and is valid]

Step 4：ワークフロー定義を生成

.claude/workflows/<category>/<workflow-name>.md に書き込みます。

---
name: { workflow-name }
description: { Brief description of workflow purpose }
version: 1.0.0
agents:
  - { agent-1 }
  - { agent-2 }
tags: [{ tag1 }, { tag2 }, workflow]
---

# {Workflow Title}

{Brief description of workflow purpose and when to use it.}

**Extended Thinking**: {Detailed explanation of workflow rationale, approach, and design decisions.}

## Overview

{Detailed description of what this workflow accomplishes.}

## Configuration Options

### {Option Category 1}

- **{value_1}**: {Description}
- **{value_2}**: {Description}

## Phase 1: {Phase Name}

### Step 1: {Step Name}

**Agent**: {agent-name}

**Task Spawn**:

```javascript
Task({
  task_id: 'task-1',
  subagent_type: 'general-purpose',
  description: '{Task description}',
  prompt: `You are the {AGENT_NAME} agent.

## Task
{Task description}

## Instructions
1. Read your agent definition: .claude/agents/{category}/{agent}.md
2. **Invoke skills**: Skill({ skill: "{skill-name}" })
3. {Additional instructions}
4. Save output to: .claude/context/{output-path}

## Context
- {Context item 1}
- {Context item 2}

## Memory Protocol
1. Read .claude/context/memory/learnings.md first
2. Record decisions to .claude/context/memory/decisions.md
`,
});
```

期待される出力：{期待される出力の説明}

Phase 2：{フェーズ名}

Step 2：{ステップ名}（並列）

エージェント：{agent-a} + {agent-b}（並列で起動）

タスクの起動：

// Spawn both agents in parallel for efficiency
Task({
  task_id: 'task-2',
  subagent_type: 'general-purpose',
  description: '{Agent A task}',
  prompt: `You are {AGENT_A}...`,
});

Task({
  task_id: 'task-3',
  subagent_type: 'general-purpose',
  description: '{Agent B task}',
  prompt: `You are {AGENT_B}...`,
});

期待される出力：{説明}

エラー回復

Phase 1 が失敗した場合

1. {回復手順}
2. Phase 1 を再開します

Phase 2 のレビューでブロッカーが見つかった場合

1. {回復手順}
2. レビューを再実行します

成功基準

• {基準 1}
• {基準 2}
• すべてのエージェントが担当フェーズを完了している
• メモリファイルが更新されている

使用例

// Router spawning workflow orchestrator
Task({
  task_id: 'task-4',
  subagent_type: 'general-purpose',
  description: 'Orchestrating {workflow-name} workflow',
  prompt: `Execute {workflow-name} workflow.

## Parameters
- {Parameter 1}
- {Parameter 2}

## Instructions
Follow the phased workflow in: .claude/workflows/{category}/{workflow-name}.md
`,
});

### Step 5: Validate Workflow References (BLOCKING)

**Before writing workflow file, verify ALL references are valid:**

| Reference | Validation |
|-----------|-----------|
| Agent files | All agents in `agents:` array exist in `.claude/agents/` |
| Skills | All skills referenced in prompts exist in `.claude/skills/` |
| Output paths | All output directories exist or will be created |
| Context files | All context files referenced are accessible |

**Validation checklist before writing:**

[ ] 参照されているすべてのエージェントが存在する [ ] 参照されているすべてのスキルが存在する [ ] 出力パスが有効である [ ] エラー回復手順がすべて揃っている [ ] 成功基準を測定できる

**BLOCKING**: Do not write workflow file if any reference is invalid.

### Step 5.5: Model and Tool Validation (CRITICAL)

**Model Validation for Agent Spawns (CRITICAL):**

When workflow templates spawn agents via Task tool:
- model field MUST be base name only: `haiku`, `sonnet`, or `opus`
- DO NOT use dated versions like `claude-opus-4-5-20251101`
- Choose model based on task complexity:
  - `haiku`: Quick validation, simple tasks
  - `sonnet`: Standard work (default)
  - `opus`: Complex reasoning, architecture

**Example:**
```javascript
// CORRECT
Task({
  task_id: 'task-5',
  model: 'sonnet',
  // ...
});

// WRONG - causes validation failures
Task({
  task_id: 'task-6',
  model: 'claude-sonnet-4-20250514',
  // ...
});

ツール配列の検証：

起動するエージェントに許可する allowed_tools を指定する場合：

• 標準ツールを使用します：Read、Write、Edit、Bash、TaskUpdate、TaskList など
• routing-table.cjs の許可リストに登録されていない限り、MCP ツール（mcp__*）を含めないでください
• MCP ツールを含めると、ルーターの強制チェックで失敗します

許可されるツール（標準）：

allowed_tools: [
  'Read',
  'Write',
  'Edit',
  'Bash',
  'TaskUpdate',
  'TaskList',
  'TaskCreate',
  'TaskGet',
  'Skill',
];

制限付きツール（明示的な許可リストへの登録が必要）：

• mcp__Exa__* - evolution-orchestrator のみ
• mcp__github__* - 特定の GitHub 操作のみ
• その他の MCP ツール - routing-table.cjs の許可リストへの登録が必要です

エージェント起動時の検証チェックリスト：

[ ] Model field uses base name (haiku/sonnet/opus)
[ ] allowed_tools contains only standard tools OR explicitly whitelisted MCP tools
[ ] No dated model versions (e.g., claude-opus-4-5-20251101)

ステップ 6：CLAUDE.md のセクション 8.6 を更新する（必須 - ブロッキング）

このステップは自動的に実行され、ブロッキングとなります。省略しないでください。

ワークフローファイルを書き込んだ後、必ず CLAUDE.md を更新してください。

1. セクション 8.6（「エンタープライズワークフロー」）を見つけます。
2. 次の形式でワークフローエントリーを生成します。

### {Workflow Name}

**Path:** `.claude/workflows/{category}/{workflow-name}.md`

**When to use:** {Trigger conditions - be specific}

**Phases:**

1. **{Phase 1 Name}** - {Brief description}
2. **{Phase 2 Name}** - {Brief description}
   ...

**Configuration Options:**

- {Option category}: `{values}`

**Agents Involved:**

- `{agent-name}` - {Role description}

1. 適切な場所に挿入します（アルファベット順、またはセクションの末尾）。
2. 次のコマンドで確認します。

grep "{workflow-name}" .claude/CLAUDE.md || echo "ERROR: CLAUDE.md NOT UPDATED - BLOCKING!"

ブロッキング：CLAUDE.md の更新に失敗した場合、ワークフローの作成は未完了です。先に進まないでください。

ステップ 7：システム影響分析（ブロッキング）

任意のワークフローを作成した後、システム全体への影響を分析し、更新してください。

[WORKFLOW-CREATOR] System Impact Analysis for: <workflow-name>

1. CLAUDE.md UPDATE (MANDATORY)
   - Add entry to Section 8.6 (Enterprise Workflows)
   - Add to Section 3 (Multi-Agent Workflows) if referenced by Router
   - Verify with grep

2. AGENT COORDINATION CHECK
   - Do all agents referenced exist?
   - Do agents need new skills for this workflow?
   - Should any agent's definition reference this workflow?

3. SKILL AVAILABILITY CHECK
   - Are all skills referenced available?
   - Does this workflow need new skills? -> Invoke skill-creator
   - Should existing skills be enhanced?

4. MEMORY INTEGRATION CHECK
   - Does workflow use Memory Protocol?
   - Are output paths writable?
   - Will artifacts be properly persisted?

5. RELATED WORKFLOW CHECK
   - Does this duplicate existing workflow functionality?
   - Should existing workflows reference this one?
   - Are there workflow dependencies to document?

6. WORKFLOW-AGENT MAP UPDATED (MANDATORY)
   - Added new workflow to @WORKFLOW_AGENT_MAP.md Section 1 matrix
   - Determined which agent archetypes use this workflow
   - Updated affected agents' `## Related Workflows` sections
   - Verified: `grep "<workflow-name>" .claude/docs/@WORKFLOW_AGENT_MAP.md || echo "ERROR: Workflow not in agent map!"`

検証チェックリスト（作成のたびに実行）- ブロッキング

# Validate workflow file exists
ls .claude/workflows/<category>/<workflow-name>.md

# Verify all referenced agents exist
for agent in $(grep -oE '\\.claude/agents/[^"]+\\.md' .claude/workflows/<category>/<workflow>.md); do
  [ -f "$agent" ] || echo "BROKEN: $agent"
done

# Verify all referenced skills exist
for skill in $(grep -oE 'skill: "[^"]+"' .claude/workflows/<category>/<workflow>.md | cut -d'"' -f2); do
  [ -f ".claude/skills/$skill/SKILL.md" ] || echo "BROKEN: $skill"
done

# Check CLAUDE.md has workflow entry - MANDATORY
grep "<workflow-name>" .claude/CLAUDE.md || echo "ERROR: Not in CLAUDE.md - WORKFLOW CREATION INCOMPLETE"

完了チェックリスト（すべてにチェックを入れる必要があります）：

[ ] Workflow pattern research completed (Step 2.5)
[ ] Workflow file created at .claude/workflows/<category>/<name>.md
[ ] All referenced agents exist in .claude/agents/
[ ] All referenced skills exist in .claude/skills/
[ ] Model fields use base names only (haiku/sonnet/opus)
[ ] allowed_tools arrays contain only standard or whitelisted tools
[ ] CLAUDE.md Section 8.6 updated
[ ] Workflow entry verified with grep
[ ] Memory Protocol included in all agent prompts

ブロッキング：いずれかの項目に失敗した場合、ワークフローの作成は未完了です。先に進む前にすべての問題を修正してください。

ステップ 8：作成後のワークフロー登録（フェーズ 3 の統合）

このステップは非常に重要です。 ワークフローの成果物を作成した後、必ずワークフロー検出システムに登録してください。

フェーズ 3 の背景： フェーズ 1 ではツールマニフェスト（ツール）を作成し、フェーズ 2 ではスキルインデックス（スキル）を作成しました。フェーズ 3 ではワークフローレジストリを作成し、オーケストレーターがワークフローを検出して呼び出せるようにします。

ワークフローファイルを書き込み、検証した後：

1. 適切な場所にワークフローレジストリエントリーを作成／更新します。

   レジストリが存在しない場合は、.claude/context/artifacts/catalogs/workflow-registry.json を作成します。

   {
     "workflows": [
       {
         "name": "{workflow-name}",
         "id": "{workflow-name}",
         "description": "{Brief description from workflow}",
         "category": "{enterprise|core|operations}",
         "version": "1.0.0",
         "triggerConditions": ["{Condition 1}", "{Condition 2}"],
         "participatingAgents": ["{agent-1}", "{agent-2}"],
         "phases": [
           { "name": "{Phase 1 Name}", "description": "{Brief description}" },
           { "name": "{Phase 2 Name}", "description": "{Brief description}" }
         ],
         "filePath": ".claude/workflows/{category}/{workflow-name}.md",
         "orchestratorReferences": []
       }
     ]
   }
   

2. 適切なオーケストレーターに登録します。

   このワークフローを使用するオーケストレーターを更新します。

   • master-orchestrator.md：他のワークフローを調整するメタワークフロー
   • evolution-orchestrator.md：EVOLVE フェーズのワークフロー（調査、作成、検証）
   • party-orchestrator.md：コンセンサス／投票のワークフロー
   • swarm-coordinator.md：調整ワークフロー

   オーケストレーターのワークフロー参照に追加します。

   ## Available Workflows
   
   - `{workflow-name}` (.claude/workflows/{category}/{workflow-name}.md)
   

3. .claude/docs/WORKFLOW_CATALOG.md に記録します。

   カタログが存在しない場合は作成します。次のエントリーを追加します。

   ### {Workflow Title}
   
   **Path:** `.claude/workflows/{category}/{workflow-name}.md`
   
   **When to use:** {Trigger conditions - specific scenarios}
   
   **Participating Agents:**
   
   - {agent-1}: {role in workflow}
   - {agent-2}: {role in workflow}
   
   **Phases:**
   
   1. **{Phase 1 Name}** - {Description}
   2. **{Phase 2 Name}** - {Description}
   
   **Orchestrator Integration:**
   
   - Invoked by: {orchestrator-name}
   - Trigger: {How orchestrator discovers/triggers this}
   

4. ワークフローを検出できることを確認します。

   ワークフローを検出できることをテストします。

   # Check workflow registry exists and is valid JSON
   node -e "console.log(JSON.stringify(require('./.claude/context/artifacts/catalogs/workflow-registry.json'), null, 2))"
   
   # Verify orchestrator references it
   grep "{workflow-name}" .claude/agents/orchestrators/*-orchestrator.md
   

5. メモリを更新します。

   .claude/context/memory/learnings.md に追記します。

   ## Workflow: {workflow-name}
   
   - **Purpose:** {Workflow purpose}
   - **Orchestrator:** {Which orchestrator uses it}
   - **Key Pattern:** {Key pattern discovered}
   - **Integration Notes:** {Any special integration considerations}
   

重要な理由： ワークフローを登録しないと：

• オーケストレーターが利用可能なワークフローを検出できません
• 複雑なタスクに対してワークフローを動的に選択できません
• システムからワークフローネットワークの可視性が失われます
• 「不可視の成果物」パターンが発生します

フェーズ 3 の統合： ワークフローレジストリはフェーズ 3 の検出メカニズムです。これにより、オーケストレーターは利用可能なワークフローを照会し、複雑なマルチエージェントタスクに適したワークフローを選択できます。

ステップ 9：統合の検証（ブロッキング - 省略禁止）

このステップでは、成果物がエコシステムに適切に統合されていることを検証します。

TaskUpdate({ status: "completed" }) を呼び出す前に、必ず作成後検証ワークフローを実行してください。

1. 10 項目の統合チェックリストを実行します。

   node .claude/tools/cli/validate-integration.cjs .claude/workflows/<category>/<workflow-name>.md
   

2. 終了コードが 0 であることを確認します（すべてのチェックに合格）。

3. 終了コードが 1 の場合（1 つ以上のチェックに失敗）：

   • エラー出力を読み、具体的な失敗箇所を確認します。
   • それぞれの失敗を修正します。
     • CLAUDE.md のエントリーがない -> セクション 8.6 に追加
     • ワークフローレジストリがない -> レジストリエントリーを作成（ステップ 8）
     • オーケストレーターの参照がない -> オーケストレーター定義に追加
     • メモリの更新がない -> learnings.md を更新
   • 終了コードが 0 になるまで検証を再実行します。

4. 検証に合格してから先に進みます。

このステップはブロッキングです。 検証に合格するまで、タスクを完了としてマークしないでください。

重要な理由： Party Mode のインシデントでは、完全に実装された成果物でも、統合手順が抜けていると Router から見えなくなることが示されました。この検証により、「不可視の成果物」パターンを防ぎます。

参照： .claude/workflows/core/post-creation-validation.md

---

ワークフロー作成の鉄則

これらのルールは絶対に守らなければなりません。違反すると、気づかれないまま失敗します。

1. NO WORKFLOW WITHOUT AGENT VALIDATION
   - Every agent referenced must exist in .claude/agents/
   - Verify with: ls .claude/agents/<category>/<agent>.md

2. NO WORKFLOW WITHOUT SKILL VALIDATION
   - Every skill referenced must exist in .claude/skills/
   - Verify with: ls .claude/skills/<skill>/SKILL.md

3. NO PARALLEL EXECUTION WITHOUT INDEPENDENCE
   - Only spawn agents in parallel if their work is independent
   - Dependent work must be sequential

4. NO HANDOFF WITHOUT OUTPUT SPECIFICATION
   - Every phase must specify its output location
   - Every phase must specify what it reads from previous phases

5. NO WORKFLOW WITHOUT MEMORY PROTOCOL
   - Every agent prompt must include Memory Protocol section
   - Without it, learnings and decisions are lost

6. NO CREATION WITHOUT CLAUDE.MD UPDATE
   - After creating workflow, add to Section 8.6
   - Unregistered workflows are never invoked by Router

7. NO CREATION WITHOUT SYSTEM IMPACT ANALYSIS
   - Check if new agents are needed
   - Check if new skills are needed
   - Update @WORKFLOW_AGENT_MAP.md with new workflow row (MANDATORY)
   - Update affected agents' Related Workflows sections (MANDATORY)
   - Document all system changes made

8. NO AGENT SPAWN WITHOUT MODEL VALIDATION
   - model field MUST be base name only: haiku, sonnet, or opus
   - DO NOT use dated versions like claude-opus-4-5-20251101
   - Dated versions cause validation failures

9. NO AGENT SPAWN WITH UNRESTRICTED MCP TOOLS
   - Use standard tools: Read, Write, Edit, Bash, TaskUpdate, etc.
   - MCP tools (mcp__*) require explicit whitelisting
   - Unwhitelisted MCP tools cause router enforcement failures

10. NO WORKFLOW WITHOUT PATTERN RESEARCH
    - Research existing workflow patterns before creating new ones
    - Minimum 2 WebSearch queries for domain patterns
    - Document patterns found in workflow comments

---

ワークフローの統合

このスキルは、統合アーティファクトライフサイクルの一部です。完全なマルチエージェントオーケストレーションについては、以下を参照してください。

ルーターの判断： .claude/workflows/core/router-decision.md

• ルーターがこのスキルのアーティファクトを検出して呼び出す方法

アーティファクトのライフサイクル： .claude/workflows/core/skill-lifecycle.md

• 検出、作成、更新、非推奨化の各フェーズ
• バージョン管理とレジストリの更新
• CLAUDE.md の統合要件

外部統合： .claude/workflows/core/external-integration.md

• 外部アーティファクトの安全な統合
• セキュリティレビューと検証の各フェーズ

---

相互参照：クリエイターエコシステム

このスキルはクリエイターエコシステムの一部です。ワークフローを作成した後、関連するクリエイターが必要かどうかを検討してください。

発見された不足	必要なアーティファクト	呼び出すクリエイター	タイミング
ドメイン知識を再利用可能なスキルにする必要がある	スキル	Skill({ skill: 'skill-creator' })	不足がスキル全体に関わる場合
既存のスキルのカバレッジが不十分である	スキルの更新	Skill({ skill: 'skill-updater' })	関連するスキルが存在するが不完全な場合
専用エージェントが必要な機能	エージェント	Skill({ skill: 'agent-creator' })	機能を担当するエージェントが必要な場合
既存のエージェントに機能の更新が必要である	エージェントの更新	Skill({ skill: 'agent-updater' })	関連するエージェントが存在するが不完全な場合
ドメインにコード／プロジェクトのひな形が必要である	テンプレート	Skill({ skill: 'template-creator' })	再利用可能なコードパターンが必要な場合
振る舞いに実行前／実行後のガードが必要である	フック	Skill({ skill: 'hook-creator' })	強制適用する振る舞いが必要な場合
プロセスに複数フェーズのオーケストレーションが必要である	ワークフロー	Skill({ skill: 'workflow-creator' })	複数ステップの調整が必要な場合
アーティファクトに構造化された I/O 検証が必要である	スキーマ	Skill({ skill: 'schema-creator' })	アーティファクトの I/O に JSON スキーマが必要な場合
ユーザーとのやり取りにスラッシュコマンドが必要である	コマンド	Skill({ skill: 'command-creator' })	ユーザー向けのショートカットが必要な場合
繰り返し使うロジックに再利用可能な CLI ツールが必要である	ツール	Skill({ skill: 'tool-creator' })	CLI ユーティリティが必要な場合
対象が限定的で、単一のアーティファクトに関わる機能のみ	インライン	このアーティファクト内にのみ記述	一般化するには具体的すぎる場合

統合ワークフロー

追加機能が必要なワークフローを作成した後：

// 1. Workflow created but needs new agent
Skill({ skill: 'agent-creator' });
// Create the agent, then update workflow's agents: array

// 2. Workflow needs new skill
Skill({ skill: 'skill-creator' });
// Create the skill, then reference in workflow prompts

// 3. Workflow needs hooks for critical steps
// Create hooks in .claude/hooks/workflows/<workflow-name>/
// Reference in workflow's hooks: section

エコシステム統合の作成後チェックリスト

ワークフローの作成と検証が完了した後：

[ ] Does workflow need agents that don't exist? -> Use agent-creator
[ ] Does workflow need skills that don't exist? -> Use skill-creator
[ ] Does workflow need entry/exit hooks? -> Create hooks
[ ] Does workflow need input validation? -> Create schemas
[ ] Should workflow be part of larger orchestration? -> Update master-orchestrator
[ ] Run post-creation validation -> node .claude/tools/cli/validate-integration.cjs .claude/workflows/<category>/<workflow-name>.yaml

---

例

例 1：機能開発ワークフローの作成

リクエスト：「エンドツーエンドの機能開発ワークフローを作成してください」

1. フェーズを特定する：発見 -> アーキテクチャ -> 実装 -> テスト -> デプロイ
2. エージェントを割り当てる：planner -> architect + security-architect -> developer -> qa -> devops
3. 引き継ぎを定義する：各フェーズの出力先は .claude/context/plans/feature-<name>/
4. 参照先：.claude/workflows/enterprise/feature-development-workflow.md を参照してください

例 2：インシデント対応ワークフローの作成

リクエスト：「本番環境のインシデント対応ワークフローを作成してください」

1. フェーズを特定する：トリアージ -> 調査 -> 解決 -> 事後分析
2. エージェントを割り当てる：incident-responder -> devops-troubleshooter + developer -> devops -> planner
3. 引き継ぎを定義する：各フェーズの出力先は .claude/context/incidents/
4. 作成する：.claude/workflows/operations/incident-response.md

例 3：C4 アーキテクチャワークフローの作成

依頼：「C4 モデルを使用してシステムアーキテクチャを文書化するワークフローを作成してください」

1. フェーズを特定する：コード分析 -> コンポーネントの統合 -> コンテナーのマッピング -> コンテキストの文書化
2. エージェントを割り当てる：c4-code -> c4-component -> c4-container -> c4-context
3. 引き継ぎを定義する：ボトムアップで、各レベルが前のレベルの文書を基に構築します
4. 参照先：.claude/workflows/enterprise/c4-architecture-workflow.md を参照してください

---

ワークフローテンプレートのクイックリファレンス

一貫した構成にするには、.claude/templates/workflows/workflow-template.md のテンプレートを使用してください。

すべてのワークフローに必須のセクション：

1. YAML フロントマター：name、description、version、agents、tags
2. 概要：目的と使用する場面
3. 設定オプション：カスタマイズ可能なパラメーター
4. フェーズ：順次または並列で実行するブロック
5. タスクの起動：完全なプロンプトを指定した実際の Task() 呼び出し
6. エラーからの復旧：フェーズが失敗した場合の対応
7. 成功基準：ワークフローが正常に完了したことを確認する方法
8. 使用例：Router がワークフローを呼び出す方法

---

アーキテクチャへの準拠

ファイルの配置（ADR-076）

• ワークフロー：.claude/workflows/{category}/（core、enterprise、operations、creators）
• テスト：tests/（.claude/ 内には配置しません）
• 関連エージェント：.claude/agents/{category}/
• 関連スキル：.claude/skills/{name}/
• 関連テンプレート：.claude/templates/

ドキュメントの参照（CLAUDE.md v3.1.0）

• 参照ファイルでは @notation を使用します：@ENTERPRISE_WORKFLOWS.md、@AGENT_ROUTING_TABLE.md
• 配置場所：.claude/docs/@*.md
• 参照先：CLAUDE.md セクション 8.6（ENTERPRISE WORKFLOWS の参照）

シェルのセキュリティ（ADR-077）

• ワークフローの起動テンプレートには、バックグラウンドタスク用に cd "$PROJECT_ROOT" || exit 1 を含める必要があります
• 環境変数でバリデーターを制御します（block/warn/off モード）
• 参照先：.claude/docs/SHELL-SECURITY-GUIDE.md
• 適用先：エージェント起動プロンプト、タスク実行例

最近の ADR

• ADR-075：Router の設定を考慮したモデル選択
• ADR-076：ファイル配置アーキテクチャの再設計
• ADR-077：シェルコマンドセキュリティアーキテクチャ

---

ファイルの配置と標準

出力場所のルール

このスキルの出力先：.claude/workflows/<category>/

カテゴリ：

• core/ - 基本的なワークフロー（router-decision、skill-lifecycle）
• enterprise/ - 複雑なマルチエージェントフロー（feature-development）
• operations/ - 運用手順（incident-response）
• creators/ - ワークフロー YAML ファイル

必須の参照先

• ファイルの配置：.claude/docs/FILE_PLACEMENT_RULES.md を参照してください
• 開発者ワークフロー：.claude/docs/DEVELOPER_WORKFLOW.md を参照してください
• 成果物の命名：.claude/docs/ARTIFACT_NAMING.md を参照してください

適用

ファイルの配置は file-placement-guard.cjs フックによって適用されます。 本番モードでは、不正な配置はブロックされます。

---

メモリプロトコル（必須）

開始前：

cat .claude/context/memory/learnings.md

以下を確認します：

• 以前に作成されたワークフロー
• 効果のあったワークフローのパターン
• 既存のワークフローに関する問題

完了後：

• 新しいワークフローを作成した場合 -> .claude/context/memory/learnings.md に追記します
• ワークフローの問題を見つけた場合 -> .claude/context/memory/issues.md に追記します
• アーキテクチャ上の決定を行った場合 -> .claude/context/memory/decisions.md に追記します

中断を想定してください：コンテキストがリセットされることがあります。メモリに記録されていなければ、実行されていないものとします。

---

作成後の統合

作成が完了したら、エコシステム統合チェックリストを実行します。

1. .claude/lib/creators/creator-commons.cjs の runIntegrationChecklist(artifactType, artifactPath) を呼び出します
2. .claude/lib/creators/creator-commons.cjs の queueCrossCreatorReview(artifactType, artifactPath) を呼び出します
3. 影響レポートを確認し、タスクを完了とする前にすべての mustHave 項目に対応します
4. shouldHave 項目はフォローアップタスクとして記録します

統合の検証：

• ワークフローが @WORKFLOW_AGENT_MAP.md に追加されている
• ワークフローが CLAUDE.md で参照されている（エンタープライズワークフローの場合）
• ワークフローが少なくとも 1 つのエージェントに割り当てられている
• ワークフローのカタログエントリーが追加されている（該当する場合）

エコシステム整合性契約（必須）

このクリエータースキルは、連携するクリエーターエコシステムの一部です。ここで作成する成果物は、関連するクリエーターとの整合性を確保し、検証する必要があります。

• 所有権と実行経路については agent-creator
• 機能のパッケージ化と割り当てについては skill-creator
• 実行可能な自動化の仕組みについては tool-creator
• 適用とガードレールについては hook-creator
• ポリシーと静的チェックについては rule-creator および semgrep-rule-creator
• 標準化されたひな形については template-creator
• オーケストレーションとフェーズのゲート設定については workflow-creator
• ユーザー／オペレーター向けのコマンド UX については command-creator

クリエーター間ハンドシェイク（必須）

完了前に、関連するすべてのハンドシェイクを確認します。

1. 成果物のルートが .claude/CLAUDE.md と関連するルーティングドキュメントに記載されていること。
2. ディスカバリー／レジストリーのエントリーが更新されていること（該当する場合、カタログ／インデックス／レジストリー）。
3. 関連する成果物が作成されているか、理由を明記して明示的に免除されていること。
4. 作成した成果物に対して validate-integration.cjs が成功すること。
5. スキルのメタデータを変更した場合、スキルインデックスが再生成されていること。

リサーチゲート（Exa + arXiv — 両方必須）

新しいパターン、テンプレート、ワークフローを作成する場合、リサーチは必須です。

1. 実装とエコシステムのパターンを調べるには Exa を使用します。
   • mcp__Exa__web_search_exa({ query: '<topic> 2025 best practices' })
   • mcp__Exa__get_code_context_exa({ query: '<topic> implementation examples' })
2. 学術研究を調べるには arXiv を検索します（AI/ML、エージェント、評価、オーケストレーション、メモリ/RAG、セキュリティでは必須）。
   • Exa 経由：mcp__Exa__web_search_exa({ query: 'site:arxiv.org <topic> 2024 2025' })
   • 直接 API：WebFetch({ url: 'https://arxiv.org/search/?query=<topic>&searchtype=all&start=0' })
3. 決定事項、制約、対象外事項を成果物の参照資料／ドキュメントに記録します。
4. 更新は最小限にとどめ、過剰なエンジニアリングを避けます。

トピックに以下が含まれる場合、arXiv の検索は代替ではなく必須です： AI エージェント、LLM 評価、オーケストレーション、メモリ/RAG、セキュリティ、静的解析、または新たな手法。

回帰に安全なデリバリー

• 振る舞いを変更する場合は、厳密に RED → GREEN → REFACTOR に従います。
• 変更したモジュールを対象にテストを実行します。
• 変更したファイルに対して lint／format を実行します。
• コミットは関心事（ロジック／ドキュメント／生成された成果物）ごとに範囲を限定します。

任意：評価品質ゲート

共有評価フレームワークを実行して、ワークフローの品質を検証します。

node .claude/skills/skill-creator/scripts/eval-runner.cjs --skill workflow-creator

ワークフロー成果物に対するグレーダーのアサーション：

• フェーズの網羅性：必須のすべてのフェーズ（トリアージ → 設計 → 実装 → レビュー → デプロイ → ドキュメント化 → 振り返り）が含まれているか、正当な理由を付けて明示的にスキップされていること
• エージェント連携のハンドオフ：各フェーズで agents、inputs、outputs、gates が定義され、フェーズ間のハンドオフ契約が明示されていること
• 測定可能な品質ゲートの基準：各ゲートに合否条件が指定されていること（曖昧な説明ではないこと）。ブロッキングとノンブロッキングのゲートが明示されていること
• ワークフローの種類の分類：ワークフローが正しいカテゴリ（core/、enterprise/、creation/、security/、operations/）に登録されていること
• レジストリーエントリーの存在：ワークフローが @ENTERPRISE_WORKFLOWS.md と @WORKFLOW_AGENT_MAP.md に追加されていること

評価プロトコル全体と、グレーダー／アナライザーエージェントの使用方法については .claude/skills/skill-creator/EVAL_WORKFLOW.md を参照してください。