Un Pipeline de Prompt Demuestra Propiedades de Meta-Programación

Un desarrollador ha documentado una canalización de prompts utilizada para construir una aplicación Electron (Claude Code CLI, React, TypeScript, SQLite) que demuestra las propiedades estructurales de un lenguaje de meta-programación, incluyendo entradas/salidas tipadas, flujo de control, bucles, máquinas de estado e interfaces de módulos.

Arquitectura de la Canalización

El sistema opera en cuatro etapas distintas con contratos tipados entre ellas.

Etapa 1: Análisis Estático

El prompt repo-eval.md realiza un escaneo completo del código base. Lee cada archivo fuente, traza gráficos de dependencias, mapea flujos IPC de extremo a extremo y emite un informe estructurado de hallazgos en issues.md. Cada hallazgo incluye:

• ID de sección
• Título
• Severidad (Crítico/Alto/Medio/Bajo)
• Categoría
• Rutas de archivo con rangos de líneas
• Evidencia
• Evaluación de impacto
• Corrección recomendada

Etapa 2: Compilación

El prompt address-issues.md analiza la salida de la Etapa 1. Agrupa hallazgos por afinidad de archivo, asigna números de prompt (FIX-01, FIX-02, ...), determina dependencias entre prompts y ordena por severidad. La salida es un directorio (prompts/arch/r{NNN}/) que contiene:

• FIX-NN.md — Prompts de corrección autocontenidos que especifican objetivo, hallazgos abordados, archivos a modificar, pasos de implementación y criterios de verificación.
• STATE.md — Seguidor de estado de ejecución con estado por prompt (pendiente/en progreso/completado/bloqueado), gráfico de dependencias, fechas de finalización y notas de transferencia.
• MASTER.md — Especificación del bucle de ejecución.

Etapa 3: Ejecución

MASTER.md sirve como el bucle de ejecución. En cada iteración:

1. Lee STATE.md
2. Selecciona el siguiente prompt pendiente cuyas dependencias están satisfechas
3. Lee el prompt
4. Lee todos los archivos fuente afectados
5. Ejecuta los pasos de implementación
6. Ejecuta verificación (tsc --noEmit, grep para patrones eliminados, verificaciones de conteo de líneas)
7. Actualiza STATE.md
8. Añade entrada al registro de cambios, actualiza documentación de arquitectura
9. Vuelve al paso 1

Etapa 4: Empaquetado

El prompt release-notes.md lee el registro de cambios, ejecuta git log y git diff --stat contra la última etiqueta, categoriza los cambios y emite notas de lanzamiento formateadas con recomendación de incremento de versión.

Propiedades Clave

Contratos Tipados: El esquema de salida de repo-eval es el contrato de entrada para address-issues. El esquema de salida de address-issues es el contrato de entrada para MASTER. Los prompts FIX consumen el formato exacto que produce address-issues. STATE.md tiene un esquema definido que MASTER lee y escribe.

Documentación Automática: Un prompt del sistema (agents.md) adjunto a cada ventana de contexto de Claude Code incluye un protocolo posterior a la ejecución: añadir una entrada al registro de cambios, actualizar documentación de arquitectura afectada, actualizar seguimiento de estado. La documentación se emite como efecto secundario de la ejecución del prompt, eliminando la degradación del contexto.

Prompts como ADRs: Cada FIX-NN.md funciona como documento de diseño, orden de trabajo y registro de decisión arquitectónica, capturando problema, justificación, plan de implementación y criterios de verificación antes de la ejecución.

Resultados

Un día de ejecución de esta canalización produjo:

• 2 evaluaciones completas del repositorio
• 17 correcciones de errores en 2 rondas de revisión (condiciones de carrera, arquitectura de flujos, gestión de estado concurrente)
• Descomposición de servicios: 1,218 líneas → 403 líneas + 5 servicios extraídos
• 3 correcciones adicionales de fallos
• Reescritura de README verificada contra el código fuente
• Sitio web de GitHub Pages de 6 páginas
• 21 entradas en el registro de cambios