Blueprint — Generador de Planes de Construcción

¿Qué hace Blueprint — Generador de Planes de Construcción?

Convierte un objetivo de una línea en un plan de construcción paso a paso que cualquier agente de código pueda ejecutar en frío.

Cuándo Usarlo

• Dividir una función grande en varios PRs con un orden de dependencias claro
• Planificar una refactorización o migración que abarque múltiples sesiones
• Coordinar flujos de trabajo paralelos entre subagentes
• Cualquier tarea donde la pérdida de contexto entre sesiones cause retrabajo

No usar para tareas completables en un solo PR, menos de 3 llamadas a herramientas, o cuando el usuario diga «solo hazlo».

Cómo Funciona

Blueprint ejecuta un pipeline de 5 fases:

1. Investigación — Verificaciones previas (git, gh auth, remoto, rama por defecto), luego lee la estructura del proyecto, planes existentes y archivos de memoria para recopilar contexto.
2. Diseño — Descompone el objetivo en pasos del tamaño de un PR (normalmente 3–12). Asigna bordes de dependencia, orden serial/paralelo, nivel de modelo (más fuerte vs predeterminado) y estrategia de reversión por paso.
3. Borrador — Escribe un archivo de plan Markdown autónomo en plans/. Cada paso incluye un resumen de contexto, lista de tareas, comandos de verificación y criterios de salida, para que un agente nuevo pueda ejecutar cualquier paso sin leer los anteriores.
4. Revisión — Delega la revisión adversarial a un subagente de modelo más fuerte (por ejemplo, Opus) contra una lista de verificació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/gh. Con git + GitHub CLI, genera planes completos con flujo de trabajo de rama/PR/CI. Sin ellos, cambia al modo directo (editar en el lugar, sin ramas).

Ejemplos

Uso básico

/blueprint miapp "migrar base de datos a PostgreSQL"

Produce plans/miapp-migrar-base-de-datos-a-postgresql.md con pasos como:

• Paso 1: Agregar driver PostgreSQL y configuración de conexión
• Paso 2: Crear scripts de migración para cada tabla
• Paso 3: Actualizar la capa de repositorio para usar el nuevo driver
• Paso 4: Agregar pruebas de integración contra PostgreSQL
• Paso 5: Eliminar código y configuración antiguos de base de datos

Proyecto multiagente

/blueprint chatbot "extraer proveedores LLM en un sistema de plugins"

Produce un plan con pasos paralelos cuando sea posible (por ejemplo, «implementar plugin de Anthropic» e «implementar plugin de OpenAI» se ejecutan en paralelo después del paso de interfaz de plugin), asignaciones de nivel de modelo (fuerte para el paso de diseño de interfaz, predeterminado para implementación) e invariantes verificadas después de cada paso (por ejemplo, «todas las pruebas existentes pasan», «sin importaciones de proveedores en el núcleo»).

Características Clave

• Ejecución en frío — Cada paso incluye un resumen de contexto autónomo. No se necesita contexto previo.
• Puerta de revisión adversarial — Cada plan es revisado por un subagente de modelo más fuerte contra una lista de verificación que cubre integridad, corrección de dependencias y detección de antipatrones.
• Flujo de trabajo rama/PR/CI — Integrado en cada paso. Degrada correctamente al modo directo cuando git/gh está ausente.
• Detección de pasos paralelos — El grafo de dependencias identifica pasos sin archivos compartidos ni dependencias de salida.
• Protocolo de mutación de plan — Los pasos pueden dividirse, insertarse, saltarse, reordenarse o abandonarse con protocolos formales y registro de auditoría.
• Sin riesgo en tiempo de ejecución — Habilidad puramente Markdown. Todo el repositorio contiene solo archivos .md — sin hooks, sin scripts de shell, sin código ejecutable, sin package.json, sin paso de compilación. Nada se ejecuta al instalar o invocar más allá del cargador nativo de habilidades Markdown de Claude Code.

Instalación

Esta habilidad se distribuye con Everything Claude Code. No se necesita instalación por separado cuando ECC está instalado.

Instalación completa de ECC

Si trabajas desde el checkout del repositorio ECC, verifica que la habilidad esté presente con:

test -f skills/blueprint/SKILL.md

Para actualizar después, revisa el diff de ECC antes de actualizar:

cd /ruta/a/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main       # revisa nuevos commits antes de actualizar
git checkout <sha-completo-revisado>      # fija un commit específico revisado

Instalación independiente vendida

Si estás vendiendo solo esta habilidad fuera de la instalación completa de ECC, copia el archivo revisado del repositorio ECC en ~/.claude/skills/blueprint/SKILL.md. Las copias vendidas no tienen un remoto git, así que actualízalas volviendo a copiar el archivo de un commit revisado de ECC en lugar de ejecutar git pull.

Requisitos

• Claude Code (para el comando /blueprint)
• Git + GitHub CLI (opcional — habilita el flujo de trabajo completo rama/PR/CI; Blueprint detecta la ausencia y cambia automáticamente al modo directo)

Fuente

Inspirado en antbotlab/blueprint — proyecto upstream y diseño de referencia.