Blueprint

Blueprint란 무엇인가요?

Blueprint는 코딩 에이전트를 위한 계획 copilot입니다. 코드 작성 전에 에이전트가 적절한 질문을 하도록 돕고, 에이전트가 한 번에 실행할 수 있는 마크다운 계획을 생성합니다.

이 도구는 에이전트에 구애받지 않도록 설계되었으며 Q&A 기반 계획을 사용합니다: 코드베이스를 탐색하고 쉽게 답할 수 있는 다중 선택 질문을 합니다. 출력은 고려하지 않았을 수 있는 문제와 결정 사항을 드러내도록 하며, 재사용 가능한 명세/계획으로 구조화됩니다.

코드 전 Q&A 계획: Blueprint는 요구사항을 명확히 하기 위해 실행을 적절히 늦추고 구조화된 계획을 생성합니다.
코드베이스 탐색: 작업 공간/코드베이스를 읽고 그 맥락을 바탕으로 질문을 유도합니다.
다중 선택 질문: 질문을 빠르게 답할 수 있도록 형식화하면서도 중요한 모호함을 다룹니다.
마크다운 계획 출력: 코딩 에이전트에 직접 넘길 수 있는 마크다운 파일을 결과로 생성합니다.
에이전트에 구애받지 않는 스킬 (skills.sh 호환): Blueprint는 여러 코딩 에이전트 하네스와 호환되는 스킬로 패키징됩니다.
내장 템플릿 (오픈 질문 섹션 포함): 개요, 예상 동작, 구현 단계, 테스트 전략, 오픈 질문 등의 섹션을 정의하는 기본 계획 템플릿을 포함합니다.

스킬 설치: 저장소에 표시된 npx 명령어로 설치: npx skills add imbue-ai/blueprint.
계획 세션 시작: 코딩 에이전트에서 짧은 작업 설명으로 스킬 호출 (예: /blueprint Add a caching layer to reduce API calls).
템플릿 선택: 프롬프트 시 템플릿 선택. Blueprint가 코드베이스를 탐색하고 질문을 시작합니다.
질문 답변: Blueprint가 충분히 다루어졌다고 판단할 때까지 질문에 답합니다.
계획 생성: /blueprint-generate로 계획 생성. blueprint/<slug>/plan-<slug>.md 경로에 저장됩니다.
필요 시 채팅에서 수정하고 오픈 질문을 요청 (예: “what are the open questions?”)한 후 코딩 에이전트에 계획 넘김.

신규 프로젝트 / 신규 기능: 구현 전에 요구사항, 예상 동작, 테스트 전략을 명확히 다루며 대규모 신규 기능을 계획.
조정이 필요한 점진적 변경: 빠른 수정이 아닌 세심한 명세가 필요한 변경 시, Blueprint가 결정과 단계를 구조화합니다.
연구 및 실험: 신규 모델, 시스템, 하위 시스템에 대해 Blueprint의 Q&A 흐름이 가정과 미지 사항을 오픈 질문이 포함된 계획으로 포착.
낯선 코드베이스 작업: 작업 공간을 탐색하고 발견된 내용 기반으로 명확화 질문을 하여 주요 제약 사항 누락 위험 감소.
에이전트 워크플로 실행 오류 감소: 에이전트가 “서둘러 코드 작성”할 경우, Blueprint가 계획 단계 후 실행할 명시적 계획 파일 제공.

어떤 코딩 에이전트 하네스가 지원되나요? 저장소에 따르면 Claude Code, Codex CLI, Gemini CLI, Pi agent 등 호환 하네스와 지원됩니다.
생성된 계획은 어디에 저장되나요? /blueprint-generate 실행 후 blueprint/<slug>/plan-<slug>.md에 저장됩니다.
Blueprint에 어떤 템플릿이 포함되나요? 기본으로 두 개의 내장 템플릿: Default (개요, 예상 동작, 구현 계획/단계, 테스트 전략, 오픈 질문 섹션 포함)와 Concise (개요, 예상 동작, 변경 사항 섹션 포함).
계획 구조를 커스터마이징할 수 있나요? 네. 저장소에 따르면 프롬프트 시 인라인으로 커스텀 템플릿 설명 가능하며, templates.json으로 지속적으로 추가/편집하여 두 Blueprint 스킬 동기화 가능.
Blueprint는 프론트엔드 작업에만 한정되나요? README 지침에 따르면 대부분 시각적 결정인 프론트엔드에는 덜 적합하며, 신규 프로젝트, 대규모 신규 기능, 연구나 하위 시스템 계획에 더 적합합니다.

명세서 또는 문서 생성기 (수동 검토 방식): 에이전트가 자체 선택 후 긴 명세서를 생성하는 도구들은 워크플로를 역전시켜 Blueprint와 다릅니다—Blueprint는 Q&A를 통해 먼저 사용자 입력을 요청합니다.
코딩 에이전트 도구의 에이전트 “계획 모드” 워크플로: 일부 에이전트 플랫폼은 자체 계획 모드를 포함합니다; Blueprint는 에이전트 실행 가능한 마크다운 계획을 생성하고 요구사항 중심의 짧은 질문을 하는 계획 Copilot으로 위치합니다.
일반 코드베이스 검토 도우미: 대안들은 리포지토리를 요약하거나 분석할 수 있지만, Blueprint의 차별화된 출력은 정의된 섹션과 실행을 위한 열린 질문을 가진 구조화된 마크다운 계획입니다.
계획 확장 프로그램을 사용한 VS Code 사이드바 워크플로: 에디터 통합 도구를 선호한다면, Blueprint는 VS Code 확장 프로그램으로도 제공되며 VS Code, Cursor, Windsurf에서 작동하여 순수 채팅 기반 에이전트 설정과 다를 수 있습니다.