Blueprint

¿Qué es Blueprint?

Blueprint es un planning copilot para agentes de código. Ayuda al agente a hacer las preguntas correctas antes de escribir código y luego genera un plan en Markdown que el agente puede ejecutar en una sola pasada.

La herramienta está diseñada para ser agnóstica a agentes y usa planificación basada en Q&A: explora un codebase y hace preguntas de opción múltiple fáciles de responder. La salida destaca problemas y decisiones que podrías no haber considerado, estructurada como una spec/plan reutilizable.

Características clave

• Planificación Q&A antes de código: Blueprint ralentiza la ejecución lo justo para aclarar requisitos y luego genera un plan estructurado.
• Exploración del codebase: Lee tu workspace/codebase y usa ese contexto para guiar las preguntas que hace.
• Preguntas de opción múltiple: Las preguntas están formateadas para responder rápidamente, cubriendo ambigüedades importantes.
• Salida de plan en Markdown: El resultado es un archivo Markdown destinado a pasárselo directamente a agentes de código.
• Habilidades agnósticas a agentes (compatible con skills.sh): Blueprint se empaqueta como skills compatibles con múltiples harnesses de agentes de código.
• Plantillas integradas con secciones de preguntas abiertas: Incluye plantillas de planificación predeterminadas que definen secciones como overview, comportamiento esperado, fases de implementación, estrategia de testing y preguntas abiertas.

Cómo usar Blueprint

1. Instala la skill con el comando npx del repositorio: npx skills add imbue-ai/blueprint.
2. Inicia una sesión de planificación invocando la skill en tu agente de código con una descripción corta de la tarea (ej., /blueprint Add a caching layer to reduce API calls).
3. Elige una plantilla cuando se te pida. Blueprint explora tu codebase y empieza a hacer preguntas.
4. Responde las preguntas hasta que Blueprint determine que se ha cubierto lo suficiente.
5. Genera el plan con /blueprint-generate. El plan se escribe en una ruta como blueprint/<slug>/plan-<slug>.md.
6. Refina en chat si es necesario y pregunta por issues abiertas (ej., “what are the open questions?”) antes de pasar el plan a tu agente de código.

Casos de uso

• Proyectos greenfield / nuevas features: Planifica una gran nueva feature asegurando que requisitos, comportamiento esperado y estrategia de testing estén explícitamente cubiertos antes de la implementación.
• Cambios incrementales que necesitan coordinación: Cuando un cambio es lo bastante grande para requerir una spec cuidadosa (no solo una edición rápida), Blueprint ayuda a estructurar decisiones y fases.
• Investigación y experimentos: Para nuevos modelos, sistemas o subsistemas, el flujo Q&A de Blueprint captura suposiciones e incógnitas como un plan con preguntas abiertas.
• Trabajando en un codebase desconocido: Blueprint explora el workspace y hace preguntas aclaratorias basadas en lo que encuentra, reduciendo la chance de pasar por alto restricciones clave.
• Reducir errores de ejecución en workflows de agentes: Si un agente tendería a “lanzarse a codificar”, Blueprint proporciona un archivo de plan explícito que el agente puede ejecutar tras la fase de planificación.

Preguntas frecuentes

• ¿Qué harnesses de agentes de código están soportados? El repositorio indica compatibilidad con harnesses como Claude Code, Codex CLI, Gemini CLI, Pi agent y otros harnesses compatibles.

• ¿Dónde se guarda el plan generado? El plan se escribe en blueprint/<slug>/plan-<slug>.md tras ejecutar /blueprint-generate.

• ¿Qué plantillas incluye Blueprint? Incluye dos plantillas integradas por defecto: Default (secciones como overview, comportamiento esperado, plan/fases de implementación, estrategia de testing y preguntas abiertas) y Concise (secciones como overview, comportamiento esperado y cambios).

• ¿Puedo personalizar la estructura del plan? Sí. El repositorio indica que puedes describir una plantilla personalizada inline cuando se te pida, y también agregar/editar plantillas persistentemente vía templates.json para que las dos skills de Blueprint estén sincronizadas.

• ¿Está Blueprint limitado a trabajo front-end? La guía del README sugiere que es menos ideal para frontends donde la mayoría de decisiones son visuales, y más adecuado para proyectos greenfield, grandes nuevas features, y planificación de investigación o subsistemas.

Alternativas

• Generadores de especificaciones o documentos (estilo revisión manual): Herramientas que producen especificaciones largas después de que el agente tome sus propias decisiones difieren de Blueprint al invertir el flujo de trabajo—Blueprint busca tu input primero mediante Q&A.
• Flujos de trabajo de “modo plan” en herramientas de agentes de código: Algunas plataformas de agentes incluyen sus propios modos de planificación; Blueprint se posiciona específicamente como un copilot de planificación que genera un plan en Markdown ejecutable por el agente y hace preguntas cortas enfocadas en requisitos.
• Asistentes genéricos de revisión de codebases: Las alternativas pueden resumir o analizar repositorios, pero la salida distintiva de Blueprint es un plan en Markdown estructurado con secciones definidas y preguntas abiertas destinadas a la ejecución.
• Flujo de trabajo en barra lateral de VS Code con extensión de planificación: Si prefieres herramientas integradas en el editor, Blueprint también está disponible como una extensión de VS Code que funciona en VS Code, Cursor y Windsurf, lo que puede diferir de configuraciones de agentes puramente basadas en chat.