Agent skill

Blueprint

by affaan-m in affaan-m/ECC

1行の目的を複数セッション、複数エージェントエンジニアリングプロジェクト向けのステップバイステップ構築計画に変換します。各ステップには自己完結型コンテキストブリーフがあり、新しいエージェントがそれをコールドで実行できます。

MITAuto-check passedDatabases

Install Blueprint

skills CLI
$ npx skills add affaan-m/ECC --skill blueprint -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install affaan-m/ECC blueprint --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/ja-JP/skills/blueprint .claude/skills/blueprint && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
blueprint
GitHub stars
276k
Token cost
~421 tokens
SKILL.md length
44 words
Files
1
Skills in repo
683
Repo updated
First seen
Licence
MIT

At a glance

1行の目的を複数セッション、複数エージェントエンジニアリングプロジェクト向けのステップバイステップ構築計画に変換します。各ステップには自己完結型コンテキストブリーフがあり、新しいエージェントがそれをコールドで実行できます。

  • Works in 5 steps: 研究 —… → 設計 — 目的を1… → ドラフト —… → …
  • Databases work in your project
  • SKILL.md covers 使用時期, 動作方法, 例 and インストール
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Blueprint is an agent skill from affaan-m/ECC. 1行の目的を複数セッション、複数エージェントエンジニアリングプロジェクト向けのステップバイステップ構築計画に変換します。各ステップには自己完結型コンテキストブリーフがあり、新しいエージェントがそれをコールドで実行できます。 敵対的なレビューゲート、依存グラフ、平行ステップ検出、アンチパターンカタログ、計画変更プロトコルを含みます。 トリガー:ユーザーが複雑なマルチPRタスク用の計画、ブループリント、またはロードマップをリクエストするか、複数のセッションが必要な作業を説明する場合。 トリガーしない場合:タスクが単一のPRまたは3未満のツール呼び出しで完成可能な場合、またはユーザーが「単にやってくれ」と言う場合。

Its SKILL.md is about 420 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Databases. It works with PostgreSQL and Git. The repository describes itself as: The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. The licence is MIT.

When your agent uses it

  • Databases work in your project

Example prompts

  • “/blueprint”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 研究 — 飛行前チェック(git、gh認証、リモート、デフォルトブランチ)、次にプロジェクト構造、既存計画、メモリファイルを読んでコンテキストを収集。
  2. 設計 — 目的を1 PRサイズのステップに分割(典型的には3~12)。依存関係エッジ、平行/順序付け、モデル層、ロールバック戦略を割り当て。
  3. ドラフト — 自己完結型マークダウン計画ファイルをplans/に書く。すべてのステップにはコンテキストブリーフ、タスクリスト、検証コマンド、出口基準を含む — 新しいエージェントが前のステップを読まずに任意のステップを実行できます。
  4. レビュー — 敵対的なレビューを最強モデルサブエージェント(例:Opus)にチェックリストとアンチパターンカタログに対して委任。最終化する前にすべての重大な知見を修正。
  5. 登録 — 計画を保存、メモリインデックスを更新、ステップ数と並列性概要をユーザーに提示。

What it can do on your machine

Read from SKILL.md and the folder at commit 4eb71d9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Blueprint loads about 421 tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 44 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~421

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from affaan-m/ECC at commit 4eb71d9, republished under its MIT licence (© affaan-m). 44 words, ~421 tokens.

Download SKILL.mdSave it as .claude/skills/blueprint/SKILL.md (or your agent's skills folder).
name
blueprint
description
1行の目的を複数セッション、複数エージェントエンジニアリングプロジェクト向けのステップバイステップ構築計画に変換します。各ステップには自己完結型コンテキストブリーフがあり、新しいエージェントがそれをコールドで実行できます。 敵対的なレビューゲート、依存グラフ、平行ステップ検出、アンチパターンカタログ、計画変更プロトコルを含みます。 トリガー:ユーザーが複雑なマルチPRタスク用の計画、ブループリント、またはロードマップをリクエストするか、複数のセッションが必要な作業を説明する場合。 トリガーしない場合:タスクが単一のPRまたは3未満のツール呼び出しで完成可能な場合、またはユーザーが「単にやってくれ」と言う場合。
origin
community

ブループリント — 構築計画ジェネレータ

1行の目的を、任意のコーディングエージェントがコールドで実行できるステップバイステップ構築計画に変換します。

使用時期

  • 大きな機能をクリアな依存関係の順序で複数のPRに分割
  • 複数のセッションにまたがるリファクタリングまたは移行を計画
  • サブエージェント間の平行作業流を調整
  • セッション間のコンテキスト損失がやり直しを引き起こす可能性のあるタスク

しないでください単一のPR、3未満のツール呼び出しで完成可能なタスク、またはユーザーが「単にやってくれ」と言う場合。

動作方法

ブループリントは5段階パイプラインを実行します:

  1. 研究 — 飛行前チェック(git、gh認証、リモート、デフォルトブランチ)、次にプロジェクト構造、既存計画、メモリファイルを読んでコンテキストを収集。
  2. 設計 — 目的を1 PRサイズのステップに分割(典型的には3~12)。依存関係エッジ、平行/順序付け、モデル層、ロールバック戦略を割り当て。
  3. ドラフト — 自己完結型マークダウン計画ファイルをplans/に書く。すべてのステップにはコンテキストブリーフ、タスクリスト、検証コマンド、出口基準を含む — 新しいエージェントが前のステップを読まずに任意のステップを実行できます。
  4. レビュー — 敵対的なレビューを最強モデルサブエージェント(例:Opus)にチェックリストとアンチパターンカタログに対して委任。最終化する前にすべての重大な知見を修正。
  5. 登録 — 計画を保存、メモリインデックスを更新、ステップ数と並列性概要をユーザーに提示。

ブループリントはgit/gh可用性を自動的に検出します。git + GitHub CLIを使用すると、完全なブランチ/PR/CIワークフロー計画を生成します。それらなしでは、ダイレクトモードに切り替わります。

例

基本的な使用方法
/blueprint myapp "PostgreSQLにデータベースを移行"

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

  • ステップ1:PostgreSQLドライバーと接続構成を追加
  • ステップ2:各テーブルの移行スクリプトを作成
  • ステップ3:新しいドライバーを使用するようにリポジトリレイヤーを更新
  • ステップ4:PostgreSQLに対する統合テストを追加
  • ステップ5:古いデータベースコードと構成を削除

インストール

このスキルはECCに付属します。ECCがインストールされている場合、別のインストールは必要ありません。

完全なECCインストール

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

bash
test -f skills/blueprint/SKILL.md

© affaan-m, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in docs/ja-JP/skills/blueprint of affaan-m/ECC.

Open the folder on GitHubat commit 4eb71d9

Compare with similar skills

Blueprint next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Blueprint compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Blueprint this skillaffaan-m/ECC276k—~421Automated safety check: PassMIT
Citus Check Style Reindentcitusdata/citus13k—~1.5kAutomated safety check: NotesAGPL-3.0
Find Postgres Bugdigoal/blog8.6k—~4kAutomated safety check: PassGPL-2.0
DB AI GitHub Paper Weekly Newsdigoal/blog8.6k—~1.2kAutomated safety check: PassGPL-2.0
DB AI GitHub Paper Weekly Newsdigoal/blog8.6k—~2.4kAutomated safety check: PassGPL-2.0
Setup Devrelytcloud/pg_ducklake144—~2kAutomated safety check: NotesMIT

Similar skills

  • Fix a failing citusdata/citus check-style job by running make reindent with the exact uncrustify/citusindent versions the currently checked-out branch pins (read from its own STYLEGUIDE.md and its…

    13k GitHub stars~1.5k tokensUpdated 2 days ago
    DatabasesAuto-check: notes
  • Find latent bugs in a local PostgreSQL source tree (RELxxSTABLE branch or HEAD) the way a core hacker does: build a heavily-poisoned debug instance (cassert + cache-discard + -O0/-ggdb3 + core…

    8.6k GitHub stars~4k tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • 抓取并汇总"数据库、AI、GitHub、AI 论文"近 1 周新闻,输出图文并茂(含 mermaid 图)的 markdown 周报到当前项目的 markdown/ 目录。覆盖 10 个数据源:postgresweekly.com/issues(自动解析最新 issue…

    8.6k GitHub stars~1.2k tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • 抓取并分析"数据库、AI、GitHub、AI论文"相关的近1周内最新内容,分类汇总,输出图文并茂(含内置 Mermaid 图)的 Markdown 周报到当前项目的 markdown/ 目录。

    8.6k GitHub stars~2.4k tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • Setup Dev

    relytcloud/pg_ducklake

    Dev environment setup for build tools, PostgreSQL, submodules, and worktrees.

    144 GitHub stars~2k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Git PR Flow

    wgzhao/Addax

    Standard branch, commit, and pull-request workflow for this repo.

    1.4k GitHub stars~216 tokensUpdated 2 days ago
    DevelopmentAuto-check passed

More from affaan-m/ECC

All 682 skills in this repo
  • Skill Stocktake

    affaan-m/ECC

    Audits your installed Claude skills and commands for quality, with a quick mode for recently changed skills and a full mode that evaluates all of them through subagents.

    277k GitHub starsUsed in 5 repos~3.1k tokens
    Auto-check passed
  • Ingests, indexes, searches, edits and monitors video, audio and live streams through the VideoDB Python SDK, returning stream links, clips and timestamps.

    277k GitHub starsUsed in 3 repos~3.5k tokens
    Auto-check: notes
  • Docs Governance

    affaan-m/ECC

    Route broad documentation-governance requests to existing ECC skills and run an opt-in, read-only audit of mapped documentation roles, links, ADR indexes, and evidence references.

    277k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Rules Distillation

    affaan-m/ECC

    Scans installed skills for principles that recur across them and proposes rule-file changes: append, revise, add a section, create a file or leave as covered.

    277k GitHub starsUsed in 2 repos~2.3k tokens
    Auto-check passed
  • Builds DRAFT counterparty agreements from one markdown template and a small JSON spec per party, with clauses picked by the party's role.

    277k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Set an ECC-specific frontend design direction for production UI work.

    277k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed

Works with

Categories

Questions about Blueprint

What does Blueprint do?

1行の目的を複数セッション、複数エージェントエンジニアリングプロジェクト向けのステップバイステップ構築計画に変換します。各ステップには自己完結型コンテキストブリーフがあり、新しいエージェントがそれをコールドで実行できます。. Blueprint is an agent skill from affaan-m/ECC.

When should I use Blueprint?

Blueprint fits situations like: databases work in your project.

How do I install Blueprint in Claude Code?

Run `npx skills add affaan-m/ECC --skill blueprint -a claude-code`. Or copy the skill folder (docs/ja-JP/skills/blueprint in affaan-m/ECC) into .claude/skills/blueprint in your project. Claude Code loads it when a task matches its description.

How do I install Blueprint in Codex?

Run `npx skills add affaan-m/ECC --skill blueprint -a codex`. Or copy the skill folder (docs/ja-JP/skills/blueprint in affaan-m/ECC) into .agents/skills/blueprint in your project. Codex loads it when a task matches its description.

Can I use Blueprint in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add affaan-m/ECC --skill blueprint -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/blueprint, .gemini/skills/blueprint, .github/skills/blueprint and .opencode/skills/blueprint in your project.

What does Blueprint need to run?

SKILL.md names no scripts, command-line tools or credentials: Blueprint is instructions for the agent only.

Does Blueprint access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Blueprint safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Blueprint use?

Blueprint is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Blueprint use?

About 421 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Blueprint?

Skills that share tags, products or a category with Blueprint: Citus Check Style Reindent (citusdata/citus, 13k stars), Find Postgres Bug (digoal/blog, 8.6k stars), DB AI GitHub Paper Weekly News (digoal/blog, 8.6k stars) and DB AI GitHub Paper Weekly News (digoal/blog, 8.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Blueprint?

affaan-m (a GitHub user) maintains it in affaan-m/ECC, which has 276,111 GitHub stars. The repository holds 683 skills in this directory. The repository was last updated on October 10, 2026.

Source: affaan-m/ECC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.