Um Pipeline de Prompt Demonstra Propriedades de Meta-Programação

Um desenvolvedor documentou um pipeline de prompts usado para construir um aplicativo Electron (Claude Code CLI, React, TypeScript, SQLite) que demonstra as propriedades estruturais de uma linguagem de meta-programação, incluindo entradas/saídas tipadas, fluxo de controle, loops, máquinas de estado e interfaces de módulo.

Arquitetura do Pipeline

O sistema opera em quatro estágios distintos com contratos tipados entre eles.

Estágio 1: Análise Estática

O prompt repo-eval.md realiza uma varredura completa da base de código. Ele lê todos os arquivos-fonte, rastreia grafos de dependência, mapeia fluxos IPC de ponta a ponta e emite um relatório estruturado de descobertas para issues.md. Cada descoberta inclui:

• ID da Seção
• Título
• Gravidade (Crítico/Alto/Médio/Baixo)
• Categoria
• Caminhos dos arquivos com intervalos de linha
• Evidência
• Avaliação de impacto
• Correção recomendada

Estágio 2: Compilação

O prompt address-issues.md analisa a saída do Estágio 1. Ele agrupa as descobertas por afinidade de arquivo, atribui números de prompt (FIX-01, FIX-02, ...), determina dependências entre prompts e ordena por gravidade. A saída é um diretório (prompts/arch/r{NNN}/) contendo:

• FIX-NN.md — Prompts de correção autocontidos especificando objetivo, descobertas abordadas, arquivos a modificar, etapas de implementação e critérios de verificação.
• STATE.md — Rastreador de estado de execução com status por prompt (pendente/em andamento/concluído/bloqueado), grafo de dependências, datas de conclusão e notas de transferência.
• MASTER.md — Especificação do loop de execução.

Estágio 3: Execução

MASTER.md serve como o loop de execução. Em cada iteração:

1. Lê STATE.md
2. Seleciona o próximo prompt pendente cujas dependências estão satisfeitas
3. Lê o prompt
4. Lê todos os arquivos-fonte afetados
5. Executa as etapas de implementação
6. Executa verificação (tsc --noEmit, grep para padrões removidos, verificações de contagem de linhas)
7. Atualiza STATE.md
8. Acrescenta entrada no changelog, atualiza documentação de arquitetura
9. Volta para a etapa 1

Estágio 4: Empacotamento

O prompt release-notes.md lê o changelog, executa git log e git diff --stat contra a última tag, categoriza as alterações e emite notas de lançamento formatadas com recomendação de incremento de versão.

Propriedades Principais

Contratos Tipados: O esquema de saída de repo-eval é o contrato de entrada para address-issues. O esquema de saída de address-issues é o contrato de entrada para MASTER. Os prompts FIX consomem o formato exato que address-issues produz. STATE.md tem um esquema definido que MASTER lê e escreve.

Documentação Automática: Um prompt do sistema (agents.md) anexado a cada janela de contexto do Claude Code inclui um protocolo pós-execução: acrescentar uma entrada no changelog, atualizar documentação de arquitetura afetada, atualizar rastreamento de estado. A documentação é emitida como um efeito colateral da execução do prompt, eliminando a deterioração do contexto.

Prompts como ADRs: Cada FIX-NN.md funciona como um documento de design, ordem de serviço e registro de decisão arquitetural, capturando problema, justificativa, plano de implementação e critérios de verificação antes da execução.

Resultado

Um dia de execução deste pipeline produziu:

• 2 avaliações completas do repositório
• 17 correções de bugs em 2 rodadas de revisão (condições de corrida, arquitetura de fluxo, gerenciamento de estado concorrente)
• Decomposição de serviço: 1.218 linhas → 403 linhas + 5 serviços extraídos
• 3 correções adicionais de falhas
• Reescrita do README verificada contra o código-fonte
• Site de 6 páginas no GitHub Pages
• 21 entradas no changelog