Blueprint — Generador de planes de construcción

Convierte un objetivo de una sola línea en un plan de construcción paso a paso que cualquier programador pueda ejecutar sin problemas.

Cuándo utilizarlo

• Para dividir una funcionalidad grande en varias solicitudes de incorporación de cambios (PR) con un orden de dependencias claro
• Planificar una refactorización o migración que abarque varias sesiones
• Coordinar flujos de trabajo paralelos entre subagentes
• Cualquier tarea en la que la pérdida de contexto entre sesiones provoque la necesidad de volver a trabajar en ella

No lo utilices para tareas que se puedan completar en una sola solicitud de incorporación de cambios, que requieran menos de tres llamadas a herramientas o cuando el usuario diga «simplemente hazlo».

Cómo funciona

Blueprint ejecuta un proceso de 5 fases:

1. Investigación: realiza comprobaciones previas (git, autenticación en GitHub, conexión remota, rama predeterminada) y, a continuación, lee la estructura del proyecto, los planes existentes y los archivos de memoria para recopilar el contexto.
2. Diseño: divide el objetivo en pasos del tamaño de una solicitud de incorporación de cambios (normalmente entre 3 y 12). Asigna relaciones de dependencia, ordenación en paralelo o en serie, nivel de modelo (más estricto frente a predeterminado) y estrategia de reversión para cada paso.
3. Borrador: escribe un archivo de plan en Markdown autónomo en plans/. Cada paso incluye un resumen del contexto, una lista de tareas, comandos de verificación y criterios de salida, de modo que un agente nuevo pueda ejecutar cualquier paso sin necesidad de leer los pasos anteriores.
4. Revisión: delega la revisión crítica a un subagente del modelo más sólido (p. ej., Opus) basándose en una lista de comprobación y un catálogo de antipatrones. Corrige todos los hallazgos críticos antes de finalizar.
5. Registro: guarda el plan, actualiza el índice de memoria y presenta al usuario el recuento de pasos y el resumen de paralelismo.

Blueprint Detecta automáticamente la disponibilidad de Git/GitHub. Con Git + GitHub CLI, genera planes completos de flujo de trabajo de ramas/PR/CI. Sin ellos, cambia al modo directo (edición in situ, sin ramas).

Ejemplos

Uso básico

/blueprint myapp "migrate database to PostgreSQL"

Genera plans/myapp-migrate-database-to-postgresql.md con pasos como:

• Paso 1: Añadir el controlador de PostgreSQL y la configuración de conexión
• Paso 2: Crear scripts de migración para cada tabla
• Paso 3: Actualizar la capa de repositorio para utilizar el nuevo controlador
• Paso 4: Añadir pruebas de integración con PostgreSQL
• Paso 5: Eliminar el código y la configuración antiguos de la base de datos

Proyecto multiagente

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

Genera un plan con pasos paralelos siempre que sea posible (por ejemplo, «implementar el complemento de Anthropic» e «implementar el complemento de OpenAI» se ejecutan en paralelo una vez finalizado el paso de la interfaz de complementos), asignaciones de capas de modelo (más relevantes para el paso de diseño de la interfaz, predeterminadas para la implementación) e invariantes verificadas tras cada paso (por ejemplo, «todas las pruebas existentes se superan», «no hay importaciones de proveedores en el núcleo»).

Características principales

• Ejecución de arranque en frío: cada paso incluye un resumen de contexto autónomo. No se necesita contexto previo.
• Control de revisión adversaria: cada plan es revisado por un subagente del modelo más potente según una lista de comprobación que abarca la exhaustividad, la corrección de las dependencias y la detección de antipatrones.
• Flujo de trabajo de ramas/PR/CI: integrado en cada paso. Se adapta de forma fluida al modo directo cuando no hay git/gh.
• Detección de pasos paralelos: el grafo de dependencias identifica los pasos sin archivos compartidos ni dependencias de salida.
• Protocolo de modificación de planes: los pasos se pueden dividir, insertar, omitir, reordenar o descartar mediante protocolos formales y un registro de auditoría.
• Riesgo de ejecución nulo — Habilidad de Markdown puro. Todo el repositorio contiene únicamente .md archivos: sin hooks, sin scripts de shell, sin código ejecutable, sin package.json, ni pasos de compilación. Nada se ejecuta durante la instalación o la invocación más allá del cargador nativo de habilidades Markdown de Claude Code.

Instalación

Esta skill viene incluida en Everything Claude Code. No se necesita ninguna instalación por separado cuando se instala ECC.

Instalación completa de ECC

Si estás trabajando a partir del repositorio de ECC, comprueba que la habilidad esté presente con:

test -f skills/blueprint/SKILL.md

Para actualizar más adelante, revisa el diff de ECC antes de actualizar:

cd /path/to/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main       # review new commits before updating
git checkout           # pin to a specific reviewed commit

Instalación independiente como componente de un proveedor

Si solo vas a utilizar esta función fuera de la instalación completa de ECC, copia el archivo revisado del repositorio de ECC en ~/.claude/skills/blueprint/SKILL.md. Las copias en «vendored» no tienen un git remote, por lo que debes actualizarlas volviendo a copiar el archivo desde una confirmación revisada de ECC en lugar de ejecutar git pull.

Requisitos

• Claude Code (para /blueprint comando de barra)
• Git + GitHub CLI (opcional — permite un flujo de trabajo completo de ramas/PR/CI; Blueprint detecta su ausencia y cambia automáticamente al modo directo)

Fuente

Inspirado en antbotlab/blueprint: proyecto original y diseño de referencia.