BlackBoxApproach: Construindo Aplicativos Quando AI Continua quebrando Coisas

Pesquisa de prova de conceito. github.com/amiune/theblackboxapproach*

A IA é excelente em gerar código. Ela também é excelente em reescrever todo seu projeto quando você pede que ela ajuste um botão. BlackBoxApproach é nosso experimento para corrigir isso.

O que tenta resolver

Decisões humanas vs IA. Cada caixa e campo de dados rastiona proveniência: human_defined, ai_defined ou mixed. Uma vez que você confirme algo, a IA não pode rebaixá-lo de volta a uma suposição.

Pseudocódigo como camada intermediária. As caixas usam pseudocódigo híbrido (CALL, IF, linguagem natural): o suficiente para decompor um sistema, mas não o suficiente para se perder em detalhes de implementação até que você esteja pronto.

Limites modulares. Refine uma caixa preta de uma vez. Ancestrais são contexto somente de leitura; apenas a subárvore selecionada pode mudar. O visualizador gera prompts que forçam isso, então "corrija o fluxo de pagamento" não reescreve sua camada de autenticação.

Visão legível por humanos. Um visualizador nativo de macOS mostra a árvore de caixas, os selos de proveniência e os contratos. Mais simples que dezenas de arquivos de especificação espalhados.

Como funciona

Cada projeto de aplicativo recebe uma pasta blackboxes/: caixas em YAML, estruturas de dados compartilhadas, um arquivo de habilidade que a LLM segue quando explicitamente chamada, e um log de proveniência. ChatGPT (ou similar) retorna atualizações de arquivo estruturadas; o aplicativo as escreve, rastiona o git diff e bloqueia novas edições da IA enquanto você tiver alterações não commitadas.

Não é low-code. Não é "programação em linguagem natural." Decomposição recursiva de caixas pretas com contratos, intenção e rastreamento de auditoria.

Status

Fase inicial de POC. Aplicativo de macOS + modelo de projeto. O método importa mais que a interface. O objetivo é desenvolvimento assistido por IA disciplinado que permanece compreensível para humanos.

Repositório: github.com/amiune/theblackboxapproach