FLUXOS

Padrões de Operação para Agentes

Uma biblioteca de padrões reutilizáveis. Cada padrão define o problema, o encaminhamento do trabalho entre humano e agentes, como o resultado é validado e, igualmente importante, quando não deve ser usado.

PADRÃO 01 · DESENVOLVIDO EM PROFUNDIDADE

Pesquisa → Plano → Desafio → Implementação → Revisão

PESQUISA→PLANO→DESAFIO→IMPLEMENTAÇÃO→REVISÃO

Os agentes produzem código plausível de imediato, o que torna tentador saltar o raciocínio. Planos sem desafio incorporam pressupostos errados que surgem mais tarde como retrabalho dispendioso.

Um agente de pesquisa explora o território. Uma passagem de planeamento produz um plano faseado. Um agente separado, ou o mesmo agente com instruções adversariais, ataca o plano. Só um plano sobrevivente chega à implementação. Um revisor a frio lê o diff final.

Enquadrar o problema, julgar a ronda de desafio, arbitrar desacordos, aprovar o plano e assumir a integração. O humano é a constante em todas as fases.

Amplitude de pesquisa, redacção do plano, crítica adversarial, implementação dentro do âmbito e revisão independente sem contexto prévio.

A ronda de desafio valida o plano; os testes e a revisão independente validam o código. Nada é integrado apenas com a palavra do implementador.

Cerimónia em tarefas triviais; rondas de desafio que se transformam em concordância quando o crítico partilha o contexto do planeador; humanos que aprovam planos sobreviventes de forma automática.

Alterações pequenas, reversíveis e bem compreendidas. Uma correcção de uma linha não precisa de um pipeline de cinco fases. É para isso que servem os padrões de manutenção.

Separação Arquitecto / Construtor

Um agente que desenha e implementa defende o seu próprio desenho. Separar os papéis mantém a estrutura honesta.

NÃO USAR QUANDO · A estrutura já está fixada e o trabalho apenas preenche uma forma conhecida.

Agente independente de revisão de código

Um revisor sem memória da implementação lê o diff a frio e apresenta conclusões antes de qualquer revisão humana.

NÃO USAR QUANDO · Código descartável gerado que nunca chegará à produção.

Ciclo de agente orientado por testes

Testes escritos e aprovados antes da implementação dão ao agente um alvo objectivo e ao humano uma âncora de verificação.

NÃO USAR QUANDO · Trabalho exploratório onde o comportamento desejado ainda está a ser descoberto.

Reprodução do erro antes da reparação

Nenhuma correcção é aceite até a falha ser demonstrada e depois demonstrada como corrigida. Elimina o "agora deve funcionar".

NÃO USAR QUANDO · Falhas verdadeiramente não determinísticas. Nesse caso, o padrão muda primeiro para instrumentação.

Documentação como contexto executável

Documentação escrita para uma sessão nova de agente poder agir: material de integração testado, não presumido.

NÃO USAR QUANDO · Protótipos em rápida mudança onde a documentação ficaria imediatamente desactualizada.

Integração no repositório

Uma primeira sessão estruturada que mapeia a base de código, convenções e acoplamentos antes de qualquer agente poder alterá-la.

NÃO USAR QUANDO · Repositórios suficientemente pequenos para caberem numa única janela de contexto.

Compressão de contexto e passagem

Tarefas longas são divididas entre sessões com documentos de passagem deliberados, porque a perda de contexto é silenciosa e cumulativa.

NÃO USAR QUANDO · Tarefas que terminam confortavelmente numa única sessão focada.