blueprint

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 puede ejecutar en frío.

Cuándo Usarlo

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

No lo uses para tareas que se puedan completar en un solo PR, con menos de 3 llamadas a herramientas, o cuando el usuario diga "simplemente 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 — Divide el objetivo en pasos del tamaño de un PR (típicamente 3–12). Asigna aristas de dependencia, orden serial/paralelo, nivel de modelo (el 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, una 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 fuerte (p. ej., 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 resumen del número de pasos y el paralelismo.

Blueprint detecta la disponibilidad de git/gh automáticamente. Con git y GitHub CLI, genera planes de flujo de trabajo completos con ramas, PRs y CI. Sin ellos, cambia al modo directo (edición 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 el driver 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 usar el nuevo driver
• Paso 4: Agregar pruebas de integración contra PostgreSQL
• Paso 5: Eliminar el código y la configuración antiguos de la base de datos

Proyecto multiagente

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

Produce un plan con pasos paralelos cuando sea posible (p. ej., "implementar plugin de Anthropic" e "implementar plugin de OpenAI" se ejecutan en paralelo después del paso de la interfaz de plugin), asignaciones de nivel de modelo (el más fuerte para el paso de diseño de interfaz, predeterminado para la implementación), e invariantes verificadas después de cada paso (p. ej., "todas las pruebas existentes pasan", "sin imports de proveedor 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 fuerte contra una lista de verificación que cubre completitud, corrección de dependencias y detección de antipatrones.
• Flujo de trabajo de rama/PR/CI — Integrado en cada paso. Degrada elegantemente 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 del plan — Los pasos se pueden dividir, insertar, saltar, reordenar o abandonar 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 en la instalación o invocación más allá del cargador nativo de habilidades Markdown de Claude Code.

Instalación

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

Instalación completa de ECC

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

test -f skills/blueprint/SKILL.md

Para actualizar más tarde, 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 (vendored)

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

Requisitos

• Claude Code (para el comando de barra /blueprint)
• Git + GitHub CLI (opcional — permite el flujo de trabajo completo de 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.