CLAUDE CODE SKILL

workflow-architect

動的 Claude Code ワークフロー（.claude/workflows/*.js）を、 最終成果物（返り値の契約＋品質バー）から逆算して設計・生成するスキル。「ワークフロー版 grille-me」として 1 問 1 答で要件を詰め、承認ゲート 1 回を経て、決定論的 JS のスケルトンを生成し、同梱 linter で検証します。

v1.0 設計ワークフロー fan-out / pipeline / loop macOS / Linux 秘密情報不要

インストール

1コマンドで導入できます（Claude Code がインストール済みであること）。API key や認証情報の入力は不要です。

curl -fsSL https://workflow-architect-98k.pages.dev/install | bash

導入後、Claude Code を再起動してください。同梱の validate-workflow.mjs を使うには Node 18+ が必要です（無くてもスキル本体は動作）。

このスキルでできること

逆算設計: 「最終成果物 → 返り値の契約 → 品質バー」を先に固め、トポロジー（fan-out / pipeline / loop）は最後に決める
1問1答ヒアリング: 各設問に推奨デフォルト付き。決定木を 1 ブランチずつ詰めて認識を合わせる
承認ゲート 1 回: 設計サマリを提示し、ユーザー承認を取ってから生成に進む
決定論 JS の生成: 制御フロー（loop / 条件分岐 / fan-out）は決定論コード、判断はモデル駆動サブエージェントに分離したスケルトンを出力
自前 linter で検証: 依存ゼロの validate-workflow.mjs で生成物を lint
実行は提案のみ: 自動実行はせず、実行コマンドを提案して止まる

いつ発動するか

発動する（TRIGGER）	発動しない（DO NOT）
「ワークフロー作って」「ワークフロー設計して」「動的ワークフロー」「目的からワークフロー組んで」「`.claude/workflows` を作りたい」「多段／並列ジョブをワークフロー化」「fan-out / pipeline / loop ワークフロー」	既存ワークフローを実行するだけ → `Workflow({name})` / `/name` 単発のサブエージェント作業 → `Agent` ツールスキル自体を作る → skill-factory Web リサーチがしたいだけ → deep-research

同梱パターン（テンプレート）

パターン	用途
`fan-out.template.js`	独立タスクを並列展開して結果を集約（barrier あり）
`pipeline.template.js`	各アイテムを多段ステージに流す（ステージ間 barrier なし＝既定）
`loop.template.js`	目標件数 / 予算 / 枯渇まで繰り返す動的ループ

実例として deep-research-custom.js / deep-verify.js（観点分解 → 並列調査 → 主張ごと敵対的検証 → 引用付きレポート）を同梱しています。

ファイル構成

~/.claude/skills/workflow-architect/
├── SKILL.md                       # スキル定義（逆算設計プロトコル）
├── DESIGN.md                      # 設計思想
├── references/
│   ├── api-reference.md           # agent()/parallel()/pipeline() などの API
│   ├── backward-design.md         # 逆算設計の手順
│   └── patterns.md                # 実証済みパターン集
├── assets/
│   ├── templates/                 # fan-out / pipeline / loop 雛形
│   └── examples/                  # deep-research-custom / deep-verify 実例
└── scripts/
    └── validate-workflow.mjs      # 依存ゼロの自前 linter (Node 18+)

動作要件

Claude Code インストール済み（macOS / Linux / WSL）
curl, tar
Node 18+（同梱 validator を使う場合のみ。任意）
API key・認証情報は不要（純設計スキル）

アンインストール

rm -rf ~/.claude/skills/workflow-architect