Communitygithub.com

Blueprint

一行の目的を、どのコーディングエージェントでも即座に実行可能な段階的な構築計画に変換します。

Blueprint とは?

Blueprintは、任意のコーディングエージェント(Claude Codeなど)が即座に実行できる、自己完結型の段階的な構築計画を生成するスキルです。大規模な機能を複数のPRに分割したり、複数セッションにまたがるリファクタリングを計画する場合や、サブエージェント間で並行作業を調整する場合に特に有用です。5フェーズのパイプライン(調査→設計→下書き→レビュー→登録)を通じて、各ステップにはコンテキスト要約、タスクリスト、検証コマンド、終了条件が含まれ、以前のステップを読まずに新しいエージェントが任意のステップを実行できます。特に、最強モデルのサブエージェントによる敵対的レビューのゲート、依存関係グラフに基づく並行ステップの自動検出、ブランチ/PR/CIワークフローの統合(Gitがない場合は直接モードに自動切替)が特徴です。スキル全体は純粋なMarkdownファイルのみで構成され、実行時リスクはゼロです。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/blueprint

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Blueprint — 構築計画ジェネレータ

一行の目的を、どのコーディングエージェントでも即座に実行可能な段階的な構築計画に変換します。

使用するタイミング

  • 大きな機能を明確な依存関係順序を持つ複数のPRに分割する場合
  • 複数セッションにまたがるリファクタリングや移行を計画する場合
  • サブエージェント間での並行作業ストリームを調整する場合
  • セッション間のコンテキスト喪失が手戻りを引き起こす可能性のあるタスク

使用しないでください 単一のPRで完了可能なタスク、3回未満のツール呼び出し、またはユーザーが「そのまま実行して」と指示した場合。

仕組み

Blueprintは5フェーズのパイプラインを実行します:

  1. 調査 — 事前チェック(git、gh認証、リモート、デフォルトブランチ)を実行し、プロジェクト構造、既存の計画、メモリファイルを読み込んでコンテキストを収集します。
  2. 設計 — 目的を1PRサイズのステップ(通常3~12)に分割します。各ステップに依存関係エッジ、並行/直列の順序付け、モデル層(最強 vs デフォルト)、ロールバック戦略を割り当てます。
  3. 下書き — 自己完結型のMarkdown計画ファイルを plans/ に書き込みます。各ステップにはコンテキスト要約、タスクリスト、検証コマンド、終了条件が含まれるため、新しいエージェントは以前のステップを読まずに任意のステップを実行できます。
  4. レビュー — 敵対的レビューを最強モデルのサブエージェント(例:Opus)に委任し、チェックリストとアンチパターンカタログに照らして確認します。最終決定前にすべての重大な指摘を修正します。
  5. 登録 — 計画を保存し、メモリインデックスを更新し、ステップ数と並列性の概要をユーザーに提示します。

Blueprintはgit/ghの利用可能性を自動検出します。git + GitHub CLIがあれば、完全なブランチ/PR/CIワークフロー計画を生成します。それらがない場合は、直接モード(インプレース編集、ブランチなし)に切り替えます。

例

基本的な使用法

/blueprint myapp "データベースをPostgreSQLに移行"

plans/myapp-migrate-database-to-postgresql.md を生成し、以下のようなステップを含みます:

  • ステップ1: PostgreSQLドライバと接続設定を追加
  • ステップ2: 各テーブル用のマイグレーションスクリプトを作成
  • ステップ3: リポジトリ層を新しいドライバに更新
  • ステップ4: PostgreSQLに対する統合テストを追加
  • ステップ5: 古いデータベースコードと設定を削除

マルチエージェントプロジェクト

/blueprint chatbot "LLMプロバイダをプラグインシステムに抽出"

可能な場合は並行ステップを含む計画を生成します(例:「Anthropicプラグインの実装」と「OpenAIプラグインの実装」はプラグインインターフェースステップ完了後に並行実行)、モデル層の割り当て(インターフェース設計ステップには最強モデル、実装にはデフォルト)、各ステップ後に検証される不変条件(例:「すべての既存テストがパスすること」、「コアにプロバイダのインポートがないこと」)も含まれます。

主な機能

  • コールドスタート実行 — 各ステップには自己完結型のコンテキスト要約が含まれます。事前のコンテキストは不要です。
  • 敵対的レビューゲート — すべての計画は最強モデルのサブエージェントによって、完全性、依存関係の正確性、アンチパターン検出をカバーするチェックリストに照らしてレビューされます。
  • ブランチ/PR/CIワークフロー — すべてのステップに組み込まれています。git/ghがない場合は直接モードにグレースフルに低下します。
  • 並行ステップ検出 — 依存関係グラフが共有ファイルや出力依存関係のないステップを特定します。
  • 計画変更プロトコル — ステップの分割、挿入、スキップ、順序変更、破棄が正式なプロトコルと監査証跡とともに可能です。
  • ゼロランタイムリスク — 純粋なMarkdownスキルです。リポジトリ全体には .md ファイルのみが含まれています — フック、シェルスクリプト、実行可能コード、package.json、ビルドステップは一切ありません。インストール時や呼び出し時に、Claude CodeのネイティブMarkdownスキルローダー以外は何も実行されません。

インストール

このスキルは Everything Claude Code に同梱されています。ECCがインストールされている場合、別途インストールは不要です。

ECCフルインストール

ECCリポジトリのチェックアウトから作業している場合、スキルが存在することを確認してください:

test -f skills/blueprint/SKILL.md

後で更新するには、更新前にECCの差分を確認してください:

cd /path/to/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main       # 更新前に新しいコミットを確認
git checkout <レビュー済みの完全なSHA>    # 特定のレビュー済みコミットに固定

ベンダースタンドアロンインストール

このスキルのみをECCフルインストールの外部でベンダリングする場合は、レビュー済みファイルをECCリポジトリから ~/.claude/skills/blueprint/SKILL.md にコピーしてください。ベンダリングされたコピーにはgitリモートがないため、git pull を実行するのではなく、レビュー済みのECCコミットからファイルを再コピーして更新してください。

要件

  • Claude Code(/blueprint スラッシュコマンド用)
  • Git + GitHub CLI(オプション — 完全なブランチ/PR/CIワークフローを有効にします。Blueprintは不在を検出し、自動的に直接モードに切り替えます)

ソース

antbotlab/blueprint に触発されました — アップストリームプロジェクトおよび参照設計。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

関連スキル