From 678ee7dc32f458adbd4fbcd9c25aa85eed46d5e9 Mon Sep 17 00:00:00 2001
From: ant <dev@antbotlab.com>
Date: Tue, 10 Mar 2026 23:19:09 +0800
Subject: [PATCH] feat(skills): add blueprint skill for multi-session
 construction planning

---
 skills/blueprint/SKILL.md | 69 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 skills/blueprint/SKILL.md

diff --git a/skills/blueprint/SKILL.md b/skills/blueprint/SKILL.md
new file mode 100644
index 00000000..c8326f71
--- /dev/null
+++ b/skills/blueprint/SKILL.md
@@ -0,0 +1,69 @@
+---
+name: blueprint
+description: >-
+  Turn a one-line objective into a step-by-step construction plan for
+  multi-session, multi-agent engineering projects. Each step has a
+  self-contained context brief so a fresh agent can execute it cold.
+  Includes adversarial review gate, dependency graph, parallel step
+  detection, anti-pattern catalog, and plan mutation protocol.
+  TRIGGER when: user requests a plan, blueprint, or roadmap for a
+  complex multi-PR task, or describes work that needs multiple sessions.
+  DO NOT TRIGGER when: task is completable in a single PR or fewer
+  than 3 tool calls, or user says "just do it".
+origin: community
+---
+
+# Blueprint — Construction Plan Generator
+
+Turn a one-line objective into a step-by-step construction plan that any coding agent can execute cold.
+
+```
+/blueprint myapp "migrate database to PostgreSQL"
+```
+
+## What You Get
+
+A Markdown plan file in `plans/` where every step is independently executable — a fresh agent in a new session can pick up any step without reading prior steps or conversation history:
+
+- **Steps** — each one-PR sized, with task list, rollback strategy, verification commands, and exit criteria
+- **Dependency graph** — which steps can run in parallel, which must be serial
+- **Design decisions** — rationale for key choices, locked against re-litigation
+- **Invariants** — properties verified after every step
+- **Progress log** — single source of truth for execution state across sessions
+- **Review log** — findings from an adversarial review gate
+
+## Installation
+
+```bash
+mkdir -p ~/.claude/skills
+git clone https://github.com/antbotlab/blueprint.git ~/.claude/skills/blueprint
+```
+
+## Usage
+
+```
+/blueprint <project> <objective>
+```
+
+## Key Features
+
+**Cold-start execution** — Every step includes a self-contained context brief. No prior context needed.
+
+**Adversarial review gate** — Every plan is reviewed by a strongest-model sub-agent (e.g., Opus) against a checklist covering completeness, dependency correctness, and anti-pattern detection.
+
+**Branch/PR/CI workflow** — Built into every step. Detects git/gh availability and degrades gracefully to direct mode when absent.
+
+**Parallel step detection** — Dependency graph identifies steps with no shared files or output dependencies.
+
+**Zero runtime risk** — Pure markdown skill. No hooks, no shell scripts, no executable code. No attack surface.
+
+**Plan mutation protocol** — Steps can be split, inserted, skipped, reordered, or abandoned with formal protocols and audit trail.
+
+## Requirements
+
+- Claude Code (for `/blueprint` slash command)
+- Git + GitHub CLI (optional — enables full branch/PR/CI workflow; Blueprint detects absence and auto-switches to direct mode)
+
+## Source
+
+[github.com/antbotlab/blueprint](https://github.com/antbotlab/blueprint) — MIT License