blueprint

Blueprint — 시공 계획 생성기

한 줄 목표를 어떤 코딩 에이전트든 컨텍스트 없이 바로 실행할 수 있는 단계별 시공 계획으로 바꿉니다.

사용 시점

• 큰 기능을 명확한 의존 순서가 있는 여러 PR로 나눌 때
• 여러 세션에 걸친 리팩터링이나 마이그레이션을 계획할 때
• 서브에이전트 간 병렬 워크스트림을 조정할 때
• 세션 간 컨텍스트 손실이 재작업을 부를 작업일 때

단일 PR로 끝나거나, 도구 호출 3회 미만이거나, 사용자가 "그냥 해"라고 하면 사용하지 않습니다.

동작 방식

Blueprint는 5단계 파이프라인을 실행합니다.

1. Research: git, gh auth, remote, 기본 브랜치를 점검하고 프로젝트 구조, 기존 계획, 메모리 파일을 읽어 컨텍스트를 수집합니다.
2. Design: 목표를 PR 단위 단계로 분해합니다. 각 단계에 의존성, 병렬/직렬 순서, 모델 계층, 롤백 전략을 붙입니다.
3. Draft: plans/에 self-contained Markdown 계획 파일을 작성합니다. 각 단계에는 컨텍스트 브리프, 작업 목록, 검증 명령, 종료 기준이 들어갑니다.
4. Review: 강한 모델 서브에이전트에게 적대적 리뷰를 맡겨 체크리스트와 안티패턴 카탈로그로 점검합니다. 치명적 이슈를 다 해결한 뒤 확정합니다.
5. Register: 계획을 저장하고 메모리 인덱스를 갱신한 뒤, 단계 수와 병렬성 요약을 사용자에게 보여줍니다.

git과 GitHub CLI가 있으면 완전한 branch/PR/CI 워크플로 계획을 생성하고, 없으면 direct mode로 내려갑니다.

예시

기본 사용

/blueprint myapp "migrate database to PostgreSQL"

멀티 에이전트 프로젝트

/blueprint chatbot "extract LLM providers into a plugin system"

핵심 기능

• Cold-start execution: 모든 단계에 독립형 컨텍스트 브리프 포함
• Adversarial review gate: 강한 모델 서브에이전트의 계획 검토
• Branch/PR/CI workflow: 단계마다 반영, git/gh가 없으면 direct mode로 전환
• Parallel step detection: 파일 충돌과 출력 의존이 없는 단계 식별
• Plan mutation protocol: 단계 분할, 삽입, 건너뛰기, 재정렬, 중단을 정식 절차로 관리
• Zero runtime risk: 순수 Markdown 스킬. 실행 코드 없이 문서만 존재

설치

이 스킬은 Everything Claude Code에 포함되어 별도 설치가 필요 없습니다.

ECC 저장소 체크아웃에서 존재 여부를 확인하려면:

test -f skills/blueprint/SKILL.md

업데이트 시에는 먼저 diff를 검토한 후 특정 커밋에 고정합니다.

cd /path/to/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main
git checkout <reviewed-full-sha>

요구사항

• Claude Code (/blueprint 슬래시 명령용)
• Git + GitHub CLI 선택 사항

출처

antbotlab/blueprint에서 영감을 받았습니다.