Agent Blueprint

agentblueprint

Agent Blueprint の CLI および MCP サーバーです。構造化されたビジネスプロファイルの作成、パイプライン成果物の生成、ブループリントデータの参照、実装状態の同期、Agent Skills ディレクトリ全体のダウンロードに対応する 23 個の MCP ツールを提供します。ベンダーに依存しない出力は、ServiceNow、Salesforce、OpenClaw など、あらゆるプラットフォームで利用できます。

CLI クイックスタート

# Install globally
npm install -g agentblueprint

# Store your API token (one-time)
agentblueprint login

# List blueprints
agentblueprint list

# Get a blueprint summary (JSON to stdout)
agentblueprint get blueprint <id>

# Get other artifacts
agentblueprint get business-case <id>
agentblueprint get use-case <id>
agentblueprint get implementation-plan <id>
agentblueprint get implementation-spec <id>
agentblueprint get business-profile

# Download as Agent Skills directory
agentblueprint download <id>

# Partner cross-org access
agentblueprint list --org <customer-org-id>
agentblueprint get blueprint <id> --org <customer-org-id>

npx を使ってインストールせずに実行することもできます。

npx agentblueprint list --token <your-api-key>
npx agentblueprint get blueprint <id> --token <your-api-key>

MCP サーバーのセットアップ

stdin がパイプ接続されている（非対話型）場合、同じバイナリが MCP モードを自動検出します。別のコマンドは不要です。

Claude Code の MCP 設定（.claude/settings.json またはプロジェクト設定）に追加します。

{
  "mcpServers": {
    "agent-blueprint": {
      "command": "npx",
      "args": ["@agentblueprint/mcp-server"],
      "env": {
        "AGENT_BLUEPRINT_API_KEY": "<your-api-key>"
      }
    }
  }
}

agentblueprint serve を使って MCP サーバーを明示的に起動することもできます。

API キーの取得

1. Agent Blueprint Settings > API Tokens に移動します
2. 「Create Token」をクリックします
3. トークンをコピーします（表示されるのは一度だけです）

対応するヘッドレスワークフロー

現在の対応範囲は意図的に限定されています。

existing PAT + existing org -> create_business_profile -> generate_use_cases -> generate_blueprint or trigger_full_pipeline -> get_generation_status -> download_blueprint

このリリースでは、組織の作成、OAuth の初期設定、自由形式のコンテキストからビジネスプロファイルへの情報抽出には対応していません。

ブループリントを Agent Skills としてダウンロード

ブループリントを、あらゆるコーディングエージェントがファイルシステムから読み取れるローカルの Agent Skills ディレクトリとしてダウンロードします。ブループリントを扱う際に推奨される方法です。

# Using the CLI (after `agentblueprint login`)
agentblueprint download <id>
agentblueprint download <id> --dir ./my-skills

# Or via npx
npx agentblueprint download --token <key> --blueprint <id>

次のような Agent Skills ディレクトリ構造が作成されます。

.agent-blueprint/<blueprint-slug>/
├── SKILL.md                              # Overview + frontmatter (auto-discovered by agents)
├── references/
│   ├── business-context.md               # Use case, pain points, transformation story
│   ├── agent-specifications.md           # Full agent specs with tools, guardrails, metrics
│   ├── financial-case.md                 # ROI, cost breakdown, sensitivity, 5-year projection
│   ├── implementation-roadmap.md         # Epics, stories, timeline, roles, dependencies
│   ├── architecture-decisions.md         # Platform, pattern, integration gaps, feasibility
│   └── guardrails-and-governance.md      # Risks, mitigation, per-agent guardrails
└── scripts/
    └── validate-spec.sh                  # Structure completeness checker

Agent Skills 標準は、Claude Code、Codex、Cursor、GitHub Copilot、Windsurf など、18 種類以上のコーディングエージェントでサポートされています。SKILL.md は有効化時に自動で読み込まれ（約 100 トークン）、参照ファイルは必要に応じて読み込まれます。

利用可能なツール

ツール	説明
create_business_profile	既存の組織の構造化されたビジネスプロファイルを作成または更新します
generate_use_cases	現在のビジネスプロファイルと準備状況の評価に基づいて、正規化されたユースケースを生成します
generate_blueprint	選択したユースケースのブループリント生成を開始し、auditId を返します
trigger_full_pipeline	既存のビジネスプロファイルの完全なパイプラインを開始し、jobId を返します
get_generation_status	ブループリント生成または完全なパイプライン生成のステータスを確認します
list_blueprints	すべてのブループリント（概要）を一覧表示します
get_blueprint	ブループリントの概要 — タイトル、エージェント、フェーズ、パターン
get_business_case	ビジネスケースの概要 — ROI、パイロットの採算性、推奨事項
get_implementation_plan	実装計画の概要 — エピック、タイムライン、ストーリー数
get_use_case	ブループリントのユースケース分析
get_implementation_spec	実装仕様のメタデータ
get_business_profile	組織のビジネスプロファイル
download_blueprint	ブループリント全体を Agent Skills のファイルマニフェストとしてダウンロードします

generate_blueprint と trigger_full_pipeline ツールは非同期です。get_generation_status を使って実行が完了するまで状態を確認し、その後、確定した blueprintId を指定して download_blueprint を呼び出してください。

get_blueprint、get_business_case、get_implementation_plan ツールは、エージェントのコンテキストウィンドウ向けに最適化された簡潔な概要を返します。詳細情報（エージェント仕様、財務予測、ユーザーストーリー）をすべて取得するには、download_blueprint を使って Agent Skills ディレクトリ全体を取得してください。

利用可能なリソース

URI	説明
agentblueprint://blueprints	ブループリント一覧（JSON）
agentblueprint://blueprints/{id}	ブループリントの詳細（Markdown）
agentblueprint://blueprints/{id}/spec	実装仕様（Markdown）

認証

API トークンを指定する方法は 3 つあります（次の順に確認されます）。

1. 任意のコマンドで --token <key> フラグを指定
2. AGENT_BLUEPRINT_API_KEY 環境変数を設定
3. agentblueprint login を実行（~/.config/agentblueprint/config.json に保存）

Environment Variables

Variable	Required	Default	Description
AGENT_BLUEPRINT_API_KEY	No	—	Your API token (alternative to agentblueprint login)
AGENT_BLUEPRINT_API_URL	No	https://app.agentblueprint.ai	API base URL