O método

Como a EnterDone é construída

A EnterDone é construída por agentes, dentro de regras em código, com recibo de cada passo — do mesmo jeito que ela trabalha na sua empresa. O jeito tem nome e está escrito: o Método Suleiman, um modelo de engenharia para sistemas reais construídos com agentes, por alguém que não lê código e valida pelo que aparece na tela. Esta página é o resumo; o documento completo está no fim, para quem quiser usar no próprio projeto.

A frase central

Observe o real, encontre a diferença, corrija o mínimo, prove proporcionalmente ao risco e transforme erros valiosos em propriedades permanentes do sistema.

Ou, operacionalmente:

IA propõe. Engenharia restringe. Sistema executa. Evidência demonstra. Humano percebe e governa o risco. Erro ensina. Código aprende.

Um sistema não está correto porque o agente disse que terminou, porque o código compilou ou porque os testes ficaram verdes. Está correto dentro do que foi demonstrado por evidência. A autoridade vem da prova, não da confiança no agente.

O loop central

MedirEstabeleça o estado real.
ContrastarCompare o observado com o que se acreditava. O achado mais valioso costuma ser o que contradiz a hipótese.
ExplicarEncontre a causa, sem confundir correlação com causalidade.
CorrigirFaça a menor mudança que restaure o invariante.
ProvarEvidência proporcional ao risco — inclusive tentar refutar o próprio trabalho e, quando há qualidade perceptiva, a observação humana.
GeneralizarPergunte: que classe de erro é esta?
EmparedarQuando justificar, transforme a lição em proteção permanente.
RegistrarPreserve a descoberta para que ninguém tenha que reaprendê-la.

O humano é sensor, não só governante

O agente lê o código — a intenção. O humano vê a tela — o comportamento. Há erros que só aparecem no tempo, no movimento e na percepção: o frame que pula, o layout quase certo, a resposta tecnicamente correta que soa errada. Para essas qualidades o agente não pode declarar nada provado; ele diz onde olhar e o que observar, e a verificação humana é evidência legítima. Um olho treinado é um instrumento de medição, e o método o trata como tal.

As 16 invariantes

Meça antes de explicar.
Toda afirmação operacional importante precisa de evidência reproduzível.
Ausência, erro e indisponibilidade são estados diferentes.
Teste demonstra apenas aquilo que efetivamente perguntou.
Quanto maior o impacto, mais forte deve ser a prova.
Prefira restrições mecânicas a instruções comportamentais.
Autonomia deve ser proporcional à reversibilidade e ao risco.
Informação importante carrega proveniência.
Operações de escala possuem limites e mecanismos de recuperação.
Erros recorrentes devem virar proteção permanente.
Evidência local não vira lei universal sem generalização.
O agente não é a autoridade sobre o próprio sucesso; o sistema observado é.
Quem fez não é quem verifica, na proporção do risco.
O risco é definido pelo que a mudança toca, não pela confiança de quem a faz.
Antes de declarar pronto, tente provar que está errado.
O que só o olho humano percebe, só o olho humano prova.

Como isso aparece no produto

O método não é um texto sobre a EnterDone; é o que a EnterDone impõe dentro da sua empresa. Cada regra abaixo tem uma parede correspondente no produto, e a parede está descrita na página de governança.

A regra do método	A parede no produto
Guardrail antes de instrução: se algo não pode acontecer, torne impossível.	A senha vai para o cofre cifrado e quem preenche o campo é o código — o modelo não tem como vê-la.
Quem fez não é quem verifica, na proporção do risco.	Toda ação sem volta para e espera a aprovação de quem tem a alçada, assinada (HMAC-SHA256).
Informação importante carrega proveniência.	Cada fato do agente diz quem disse, quando e onde — e toda resposta aceita o «por quê?».
Operações de escala possuem limites e mecanismos de recuperação.	Um freio congela toda ação autônoma; o teto mensal de gasto bloqueia sozinho; a trilha é encadeada e não se reescreve.
O placar não se digita: números vêm de fonte reproduzível.	O gasto com cada modelo aparece numa fatura real, por modelo, no Console.
Autonomia proporcional à reversibilidade e ao risco.	Permissão por cargo; conector por conector a gestão decide: só ler, pedir aprovação ou agir.
O agente não é a autoridade sobre o próprio sucesso.	O agente se declara na web e assina cada navegação; quem verifica é o site visitado, com a chave pública.
Linguagem não é evidência.	A seção «Em produção» da home só lista o que o agente fez de verdade, com o recibo de cada passo lá dentro.

O documento completo

O método inteiro — 44 seções, com a origem, as convergências com a engenharia consagrada e o que é contribuição própria — e o contrato operacional que os agentes seguem em cada projeto estão publicados em repositório aberto, como foram escritos, em português:

github.com/suleiman-ribeiro/metodo-suleiman — o repositório público: a fonte, com histórico, issues e a licença.
ENGINEERING_METHOD.md — o método: por quê. (cópia neste site)
AGENTS.md — o contrato de engenharia dos agentes: como trabalhar. A seção 10 é um molde, para cada projeto preencher. (cópia neste site)

Autor: Suleiman Ribeiro. Licença Creative Commons Atribuição 4.0: use, adapte e redistribua, citando a origem. O método nasceu da prática, não de pesquisa; onde converge com ideias consagradas, a tabela de referências no fim do documento diz com quais.