Understand before changing. Prove before remembering. Measure before claiming improvement.
O EvoPro é um protocolo operacional cognitivo, repository-native, para evolução governada de software. Ele compreende o host, recupera o contexto mínimo relevante, governa agentes e ferramentas, preserva memória e só então transforma intenção em evolução mensurável.
Entende o host, preserva contexto e adota memória existente sem criar uma segunda verdade.
Você fornece intenção. O agente escolhe contexto, ferramentas e workflow necessário.
Contratos, riscos, validação adversarial e autoridade humana limitam a autonomia.
Codex, Claude Code, Antigravity e futuros harnesses são motores intercambiáveis.
Uma LLM pode ser excelente numa sessão e ainda não possuir memória institucional do sistema. EvoPro move contexto persistente, ownership e governança para o repositório.
Conhecimento relevante pode ficar espalhado entre prompts, leitura ad-hoc e memória temporária da sessão. Um novo agente precisa reconstruir o cenário e pode escolher evidências diferentes.
O agente consulta estado, memória existente, contratos, riscos, decisões e evidência do host. O Context Router seleciona o que é relevante à intenção antes da execução.
A Cognitive Layer transforma um repositório em um ambiente legível por agentes: evidência vira modelo, modelo validado vira memória, intenção vira contexto e contexto é limitado por governança.
Inspeciona o host e coleta evidência antes de formular conclusões.
Constrói ou adota memória persistente sem sobrescrever a verdade canônica do host.
Seleciona domínios, contratos, riscos, decisões e evidências relevantes para a intenção atual.
Define boundaries, autoridade, epistemologia e quando uma decisão precisa voltar ao humano.
Mantém fragilidades, dívidas e sinais de segurança visíveis em vez de deixá-los morrer no chat.
O agente escolhe terminal, Git, testes e comandos compatíveis quando o harness possui capacidade segura.
Contexto diz ao agente o que ele precisa saber. Governança define o que ele pode fazer com esse conhecimento.
EvoPro is designed to move cognitive work forward instead of restarting it. The initial contact may inspect broadly. Once validated context becomes persistent memory, later tasks should retrieve, route and verify only what matters.
Repository reconnaissance, canonical memory adoption, architecture, risks and current-state validation.
The bars explain the architecture, not measured performance. Real efficiency claims require repeated host measurements of time, tool calls, context read and result quality.
O EvoPro preserva uma fronteira explícita entre estado determinístico, cognição operacional e capacidade do modelo. Nenhuma camada deve silenciosamente impersonar outra.
Mantém estado, schemas, baselines, guardrails, Judge e invariantes verificáveis. Não deve fingir raciocínio cognitivo nem fabricar trabalho.
Percebe o host, recupera memória, roteia contexto, mantém epistemologia, seleciona skills e decide quais ferramentas seguras são necessárias.
Codex, Claude Code, Antigravity ou outro harness executa raciocínio e ferramentas disponíveis. É intercambiável e não possui soberania sobre a memória ou os contratos do host.
Hosts novos podem construir memória cognitiva. Hosts maduros podem possuir documentação canônica própria. EvoPro distingue essas duas camadas em vez de fundi-las silenciosamente.
{
"host_contract": {
"commands": {
"test": "<host test command>",
"build": "<host build command>"
},
"protected_paths": [".git/**"],
"limits": {
"max_revision_cycles": 3,
"max_sprints": 25
}
}
}Comandos podem ser declarados ou inferidos de evidência do host. Inferência continua sendo inferência e deve preservar a fonte que a sustentou.
EvoPro foi desenhado para manter memória, estado e governança fora de um fornecedor específico. Isso significa que diferentes harnesses podem operar o protocolo quando expõem as capacidades necessárias. Não significa que todos estejam automaticamente certificados.
Trocar a LLM não deve apagar contexto persistido, contratos ou decisões.
Terminal, filesystem, Git, browser, subagents e network são usados apenas quando realmente disponíveis.
Integrações específicas devem ficar em adapters, sem transformar o Kernel em uma coleção de ifs por fornecedor.
Um harness só deve receber selo de compatibilidade depois de um teste real do fluxo requerido.
Estado atual: o primeiro gate end-to-end formal é o piloto do AG Menu numa IDE real. Até esse gate passar, a LP não apresenta uma matriz universal de “compatibilidade verificada”.
CONTINUITY.md continua podendo ser um artefato útil, mas já não representa sozinho o cérebro do sistema. EvoPro trabalha com memória cognitiva composta, evidência, riscos, decisões, contratos e contexto recuperável.
Quando o repositório já possui uma memória madura, EvoPro pode adotá-la read-only em vez de reconstruir ou sobrescrever conhecimento canônico.
Observações, inferências, contexto, riscos e estado operacional do protocolo vivem em .evolution/ sem depender de uma conversa específica.
A próxima sessão não precisa ler tudo. O Context Router recupera apenas o conhecimento relevante à intenção atual.
Memória orienta continuidade, mas afirmações materiais continuam ligadas a evidência primária e ao seu status epistemológico.
Versão do protocolo, identidade AG47.pt / EvoPro e capacidades disponíveis.
Arquitetura, stack, domínios, boundaries e fontes primárias do repositório.
Memória cognitiva construída pelo EvoPro ou memória canônica existente adotada read-only.
Decisões, riscos, histórico semântico, sprints, ciclos e evidências persistidas.
CURRENT separado de TARGET, saúde, gates e limitações conhecidas.
Context Router seleciona domínios, contratos, riscos, decisões e evidências para a intenção atual.
Guardrails, riscos, capacidade ausente e decisões que exigem autoridade humana.
Uma ação recomendada com razão, impacto esperado e forma de validação.
Nenhum agente de IA pode simplesmente declarar que o objetivo foi atingido. A conclusão baseia-se unicamente em critérios de sucesso verificáveis pelo ambiente.
O objetivo final que o projeto deve alcançar. Pode necessitar de dezenas de sprints e ciclos de mutação.
.evolution/goal/global-goal.jsonCada Sprint Goal representa um avanço delimitado que fecha num único ciclo de execução.
Executa um comando real declarado no host (ex: pytest, npm run build) e valida o código de saída zero.
Verifica fisicamente no disco a existência e integridade de um arquivo ou esquema exigido.
Garante que a contagem de findings do Gauntlet em determinada severidade (ex: critical) seja zero.
Exige uma confirmação explícita gravada no registo por um operador humano (evolution goal confirm).
Cada estágio do ciclo é um módulo autónomo com contrato formal e responsabilidades isoladas. Nenhum ator valida o seu próprio código e nenhuma mutação avança sem evidências comprovadas.
src/evolution_kernel/core/global_goal.pyObjetivo macro mensurável e critérios de sucesso estritamente verificáveis.
.evolution/goal/global-goal.jsonProduzir código não significa melhorar software. O EvoPro mede o estado exato antes da mutação (STATE A) e após a mutação (STATE B).
Judge & 12 Gauntlet Critics: Novos testes executados com sucesso, hash HMAC validado e zero regressões detectadas.
Métrica comportamental piorou, testes quebraram ou o crescimento estrutural excedeu o teto seguro.
Critérios de sucesso adicionais foram satisfeitos e nenhum teste existente regrediu.
A dimensão foi medida em ambos os lados e permaneceu estável dentro das tolerâncias do contrato.
Uma dimensão que não pôde ser medida em ambos os estados. Nunca é uma aprovação silenciosa.
is_improvement é estritamente tri-valorada:No EvoPro, a ausência de evidência não é lida como sucesso. Se não for possível provar melhoria ou se houver regressão, o protocolo não finge evolução para agradar ao utilizador.
True — Melhoria comprovada sem regressãoFalse — Regressões foram detetadasNone — Evidência insuficiente para conclusãoNenhum autor valida o seu próprio trabalho. O Gauntlet submete a mutação a um conjunto de críticos especializados e independentes que procuram falhas com base em evidências verificáveis, não em opiniões.
Verifica scope e ficheiros protegidos.
Analisa Baseline A/B por regressões.
Valida evidência de testes.
Varredura estática de padrões perigosos.
Valida boundaries arquiteturais.
Detecta mutações órfãs e desvio do objetivo.
Reavalia integridade independentemente.
Usa Code Graph para blast radius.
Usa histórico para abordagens rejeitadas.
Requer benchmark do host.
Requer browser/visual harness.
Requer lint configurado.
O Gauntlet seleciona a sua estratégia de acordo com as capacidades descobertas no ambiente:
Pedidos de revisão são gerados para execução em instâncias/subagentes totalmente isolados com contexto limpo e fresco, prevenindo contaminação de contexto.
Os mesmos críticos determinísticos executam em processo sequencialmente, restritos estritamente ao seu slice específico de evidências.
Enquanto o Validador pergunta “o executor disse a verdade?”, o Judge responde “esta mutação deve sobreviver?”. As regras são ordenadas e determinísticas: as mesmas evidências geram o mesmo veredito em qualquer harness.
Integridade ALLOW, zero regressões e zero findings bloqueantes.
Aprende evidências, persiste estado e reavalia o Goal.
Findings corrigíveis e orçamento disponível.
Retorna ao planeamento com findings.
Violação de scope, segurança ou regressão.
Reverte/abandona mutação isolada e preserva evidência.
Decisão humana ou evidência indispensável pendente.
Interrompe autonomia com segurança.
BLOCKED imediato. O Judge nunca concede aprovações por omissão.evolution judgeCode Graph e Evolution Graph adicionam evidência estrutural para dependências, blast radius e histórico. O grafo melhora recuperação e validação quando disponível, mas não se torna uma fonte mágica ou obrigatória de verdade.
A análise pode usar relações observadas e inferidas para priorizar arquivos e testes. Se o provider não estiver disponível, o protocolo degrada para evidência do filesystem e outras fontes do host.
AST observado, heurística ou inferência não recebem a mesma confiança. Proveniência e nível de evidência devem permanecer visíveis para o agente.
ast.NodeVisitor • line 12| Métrica | Sem grafo | Com grafo |
|---|---|---|
| Affected tests discovered | 1 | 14 |
| Dependent components discovered | 20 | 30 |
| Files ranked by import distance | 0 | 31 |
| Context tokens | 1497 | 1576 |
Benchmark deve ser tratado como evidência histórica do repositório medido; métricas não reexecutadas não devem ser apresentadas como atuais. Full index: < 1s; incremental update: ~0.10s; storage: < 1 MB.
Escolha o nível de autonomia adequado à sua necessidade através da flag --mode da CLI.
--mode safeMáxima supervisão e gates.
Escala cedo e exige evidência forte.
Hosts críticos e adoção inicial.
evolution run --mode safe--mode balancedAutonomia governada.
Executa trabalho seguro e escala ambiguidade material.
Desenvolvimento normal.
evolution run --mode balanced--mode goal-drivenLoop orientado ao Global Goal.
Planeia sprints sucessivos sob guardrails.
Evolução contínua governada.
evolution run --mode goal-drivenA CLI continua disponível para operadores avançados. A experiência padrão é outra: o humano expressa intenção e o agente traduz intenção em operação do protocolo.
Instale o EvoPro no ambiente. Este é o único passo que precisa começar como comando explícito.
Use um harness com acesso ao projeto. O agente passa a trabalhar sobre o estado real do host.
Não memorize paths, estados internos ou sequências de CLI. Diga o que você precisa saber ou alcançar.
EvoPro avalia estado, recupera memória, roteia contexto, escolhe ferramentas e propõe a próxima ação governada.
Autonomia não significa ausência de limites. O agente opera somente dentro das capacidades do harness, dos contratos do host e das regras de governança. Decisões críticas continuam escaláveis ao humano.
Você não deveria precisar saber que arquivo contém o estado ativo, qual comando avança um ciclo ou onde mora um relatório. Isso é contexto operacional do agente, não carga cognitiva do usuário.
“Analise este repositório e me diga onde estamos, quais são os riscos relevantes e qual é a próxima prioridade.”
“Continue o trabalho do EvoPro a partir do estado atual, respeitando memória, contratos e decisões existentes.”
“Quero implementar esta mudança. Avalie impacto, contexto necessário e riscos antes de propor execução.”
O agente resolve quais artefatos .evolution precisa consultar.
Bash, PowerShell, Git, testes e CLI são escolhidos conforme ambiente e capacidade.
Ambiguidade material, decisões críticas ou limites de permissão são escalados.
A interface Agent-first não remove a CLI. Ela remove a obrigação de o usuário conhecer a CLI para operar o EvoPro. A referência completa permanece na seção Advanced CLI.
Esta seção é uma demonstração ilustrativa da interface de operador. Não é um terminal conectado ao seu repositório e não substitui execução real do CLI.
$ evolution second-brain assess# AG47.pt 🧠 EvoPro • Repository Assessment **Health:** BUILDING **Phase:** CONTEXT_ROUTER ## 🧭 Próxima ação recomendada Construir contexto limitado para a intenção atual.
Outputs acima mostram formato e intenção operacional. Estado, paths, riscos e resultados reais dependem do host e devem ser obtidos pela execução real do EvoPro.
A experiência normal é Agent-first. Esta referência existe para debugging, CI, automação e controlo explícito por operadores. Versão canônica carregada: v0.3.1.
Diferentes ambientes e agentes possuem diferentes capacidades. O EvoPro adapta a sua estratégia às capacidades comprovadas e trata UNKNOWN estritamente como indisponível.
filesystemAcesso a ficheiros do projeto e diretório .evolution/
terminalCapacidade de rodar processos e comandos do sistema
gitCriação de branches de isolamento e tracking de histórico
test_runnerSuites de teste detetadas no host
build_systemComandos de compilação/build detetados
schedulerCapacidade de agendamento de ticks periódicos
subagentsExecução de críticos em contextos limpos e independentes
browserInspeção visual e navegação para UX critic
mcpConectores de ferramentas Model Context Protocol
background_executionProcessos assíncronos e jobs em background
screenshotsCaptura de ecrã para auditoria de frontend
networkAcesso externo a APIs ou registos remotos
evolution capabilities“Autonomy without stop conditions is just an expensive infinite loop.”
O EvoPro monitoriza continuamente o progresso real e interrompe a autonomia de forma segura perante qualquer indício de oscilação, estagnação ou crescimento descontrolado.
Operador solicita interrupção.
Teto de sprints atingido.
Limite de tempo ultrapassado.
Falhas sucessivas.
Goal não avança.
Alternância entre mutações antagónicas.
Abordagem rejeitada reaparece.
Blast radius cresce fora do orçamento.
As hipóteses de mutação são identificadas pela assinatura da sua intenção e caminhos tocados, e não apenas pelo ID gerado. Se um agente tentar repropor a mesma solução falhada sob um novo ID, o EvoPro deteta a repetição e rejeita imediatamente.
evolution guardrails showEvoPro preserva trilhas estruturadas para explicar o que foi observado, decidido, executado e validado. O histórico serve à reconstrução e à auditoria; não transforma automaticamente um evento persistido em verdade absoluta.
Eventos, decisões e learnings mantêm proveniência suficiente para reconstruir por que o sistema chegou ao estado atual.
Judge, baselines e critics devem apontar para evidências produzidas pelo host, não apenas para declarações do agente.
Memória, riscos, contratos e estado podem ser auditados entre si para revelar inconsistências e drift.
event: CHANGE_VALIDATED status: VALIDATED evidence: - host test command: exit 0 - baseline comparison: no regression - risk findings: reviewed next_action: persist approved learning
Paths e formatos concretos podem variar por subsistema e versão. A LP demonstra o princípio de auditabilidade; o repositório matriz e seus schemas são a autoridade técnica.
Cenários de aplicação, não garantias automáticas de compatibilidade. A estratégia real depende do host, das evidências encontradas e das capacidades disponíveis no harness.
Adota memória existente, reconcilia documentação com código e orienta evolução sem recomeçar o contexto do zero.
Mantém continuidade, riscos, contratos e decisões disponíveis entre LLMs e sessões.
Roteia contexto, estima impacto, preserva boundaries e exige validação proporcional ao blast radius.
Transforma objetivos verificáveis em sprints, baseline A/B, Gauntlet, Judge e aprendizagem persistente.
Permite substituir Codex, Claude, Gemini ou outras LLMs sem perder a memória operacional do projeto.
Mantém fragilidades, dívida técnica, vulnerabilidades e gaps visíveis em vez de enterrados em chats.
Implementado, observado, validado em campo e universalmente comprovado são estados diferentes. A landing lê o estado público canônico do próprio EvoPro.
Agent-first interaction is not universally production-proven across hosts and harnesses.
Harness-dependent capabilities remain UNKNOWN until exposed or declared.
Cognitive memory guides retrieval but does not replace primary evidence.
Contrato de atualização: versão, capabilities, limitações e gate atual vêm de metadata/public-manifest.json no repositório EvoPro. A LP revalida essa fonte periodicamente e prefere a última tag quando disponível.
A Agência 47 desenvolve software de alta performance, plataformas e inteligência autónoma. Dentro do setor ECO, o EvoPro atua como o protocolo estruturante de governança que pode ser instalado em qualquer produto para garantir evolução contínua, continuidade entre agentes e integridade arquitetural.
Instale o Evolution Protocol hoje mesmo e garanta que a evolução do seu software pertence ao seu repositório.