Blueprint — 건설 계획 생성기
한 줄의 목표를 단계별 건설 계획으로 변환하여 모든 코딩 에이전트가 사전 정보 없이 실행할 수 있도록 합니다.
사용 시점
- 큰 기능을 여러 개의 PR로 분할하며 명확한 의존성 순서를 정해야 할 때
- 여러 세션에 걸친 리팩터링이나 마이그레이션을 계획할 때
- 하위 에이전트 간의 병렬 작업 흐름을 조정할 때
- 세션 간 컨텍스트 손실로 인해 재작업이 발생할 수 있는 모든 작업
사용하지 말아야 할 경우 — 단일 PR로 완료 가능한 작업, 3회 미만의 도구 호출, 또는 사용자가 "그냥 해"라고 말한 경우.
작동 방식
Blueprint는 5단계 파이프라인으로 작동합니다:
- 연구 — 사전 점검(git, gh 인증, 원격 저장소, 기본 브랜치) 후 프로젝트 구조, 기존 계획, 메모리 파일을 읽어 컨텍스트를 수집합니다.
- 설계 — 목표를 하나의 PR 단위로 분할(보통 3~12단계)합니다. 각 단계에 의존성 엣지, 병렬/직렬 순서, 모델 티어(가장 강력함 vs 기본), 롤백 전략을 할당합니다.
- 초안 —
plans/디렉토리에 독립적인 마크다운 계획 파일을 작성합니다. 모든 단계에는 컨텍스트 요약, 작업 목록, 검증 명령어, 종료 조건이 포함되어 있어, 새로운 에이전트가 이전 단계를 읽지 않고도 어떤 단계든 실행할 수 있습니다. - 검토 — 가장 강력한 모델 하위 에이전트(예: Opus)에게 체크리스트와 안티패턴 카탈로그를 기반으로 적대적 검토를 위임합니다. 최종 확정 전에 모든 치명적 발견 사항을 수정합니다.
- 등록 — 계획을 저장하고, 메모리 인덱스를 업데이트하며, 단계 수와 병렬 처리 요약을 사용자에게 제시합니다.
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가 없으면 자동으로 직접 모드로 전환됩니다.
- 병렬 단계 탐지 — 의존성 그래프가 공유 파일이나 출력 의존성이 없는 단계를 식별합니다.
- 계획 변경 프로토콜 — 단계를 공식 프로토콜과 감사 추적과 함께 분할, 삽입, 건너뛰기, 재정렬 또는 중단할 수 있습니다.
- 제로 런타임 위험 — 순수 마크다운 스킬입니다. 전체 리포지토리에는
.md파일만 포함되어 있습니다 — 훅, 셸 스크립트, 실행 코드,package.json, 빌드 단계가 없습니다. 설치나 호출 시 Claude Code의 네이티브 마크다운 스킬 로더 외에는 아무것도 실행되지 않습니다.
설치
이 스킬은 Everything Claude Code와 함께 제공됩니다. ECC가 설치되어 있으면 별도 설치가 필요하지 않습니다.
전체 ECC 설치
ECC 리포지토리 체크아웃에서 작업 중이라면 다음 명령어로 스킬이 있는지 확인하세요:
test -f skills/blueprint/SKILL.md
나중에 업데이트하려면 업데이트 전에 ECC diff를 검토하세요:
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에서 영감을 받음 — 업스트림 프로젝트 및 참조 설계.