v3.0

v3.0 reescreve a arquitetura. O contexto vive em arquivos Markdown versionados; os agentes leem o contrato, executam e depositam sugestões no inbox para revisão humana. Nenhum agente é o núcleo. Governança em dois modos declarados: cooperativo (via contrato) e adversarial (via isolamento por sistema operacional). Captura por hooks do próprio agente. Auditoria proporcional ao risco. MCP e Graphiti passam a ser camadas opcionais, não componentes obrigatórios. Documentação completa em PT/EN: whitepaper (20pg) e guia comunitário (55pg).

v2.4.0 — Pre-action log, review_date e mente de colmeia automatizada

O que há de novo em v2.4.0

Pre-action log (mitigação de rollback)

• scripts/pre-action-log.mjs — hook PreToolUse que detecta ações de alto risco (delete, drop, rm, truncate, push --force, deploy, send, overwrite, format) e registra em template/99-archive/pre-action-log.md antes da execução. Não bloqueia — só audita.
• template/.claude/hooks.json atualizado com PreToolUse + PostToolUse

Validade temporal explícita (review_date)

• Todos os 5 Context Packs agora incluem bloco Review: com review_date, review_by e next_review
• template/70-decisions/README.md atualizado com os mesmos campos no frontmatter de DECISION.md
• template/00-global/AGENT.md documenta a lógica de aviso automático do Hermes

Mente de colmeia automatizada

• scripts/promote-skills.mjs — processa 50-skills/proposed/, aplica regras confidence+risk+TTL e move verified+low para published/ quando TTL venceu
• scripts/update-index.mjs — regenera 50-skills/INDEX.md a partir de published/, agrupado por domínio e agente

Whitepaper v2.1 atualizado

• Seção de limitações expandida para 5 limitações com mitigações documentadas:
  • Lim 1 (rollback): mitigada pelo pre-action logging
  • Lim 2 (temporal validity): mitigada pelo campo review_date + next_review
  • Lim 3 (governança): classificação automática reduz dependência humana ao essencial
  • Lim 4 (escala): progressão documentada (pequena → Graphiti → multi-vault)
  • Lim 5 (mente de colmeia): estrutura e scripts implementados; v3.0 é Graphiti + busca semântica

Arquivos desta release

• whitepaper-ptbr-v2.1.pdf — whitepaper com 5 limitações e mitigações
• guia-implementacao-v2.4.pdf — guia com seções 12c (Harness Engineering), 12d (Mente de Colmeia) e hooks

Instalação

git clone https://github.com/AndreAlmeidaDC/federated-memory
cd federated-memory
bash setup.sh   # ou ./setup.ps1 no Windows

Ver QUICKSTART.md para os próximos passos.

v2.3.0 — Mente de Colmeia

O que há de novo na v2.3.0

Mente de Colmeia — compartilhamento de conhecimento entre agentes

Template

• /50-skills/ com estrutura em três níveis: published/, proposed/, deprecated/
• INDEX.md — índice navegável de skills por domínio e agente
• README.md atualizado com protocolo de publicação, metadados obrigatórios e regras de promoção automática por confidence + risk

AGENT.md

• Protocolo de mente de colmeia: consulta ao INDEX.md antes de criar qualquer skill, playbook ou template
• Regras de publicação via /90-inbox/ com type: skill
• Lista explícita do que pode e do que nunca deve ser publicado na área compartilhada

Guia de implementação (seção 12d)

• Três níveis de memória: privada, publicada, aprovada
• Protocolo de publicação passo a passo com classificação automática
• Regras fundamentais: leitura federada, escrita controlada

Whitepaper

• Parágrafo sobre mente de colmeia como evolução do padrão blackboard (seção 7)
• Limitação 05: mente de colmeia é v3.0, não v2 — estrutura existe como template, automação entra na v3.0
• Nova coluna na tabela de comparação: "Compartilhamento entre agentes"

---

PDFs incluídos nesta release

• whitepaper-ptbr-v2.1.pdf — Whitepaper v2.1 (Princípio 5 reformulado, abstract atualizado)
• guia-implementacao-v2.3.pdf — Guia de implementação v2.3 (seções 06b, 09c, 12c, 12d)

---

Histórico de releases

Release	Conteúdo principal
v2.3.0	Mente de Colmeia
v2.2.0	SESSION.lock + Harness Engineering
v2.1.0	Classificação automática confidence+risk+TTL, hooks, Princípio 5
v2.0.1	Limitações conhecidas, Graphiti, Paperclip/Pi
v2.0.0	Hermes como núcleo ativo
v1.0.0	Lançamento inicial

v2.1.0 — Classificação automática, multimodal e bug tracking

O que há de novo

Captura automática de memória

• Hermes hooks (sync_turn, prefetch, shutdown) alimentam o inbox sem intervenção manual
• Classificação obrigatória por confidence (verified/hypothesis/preference/deprecated) e risk (low/medium/high)
• Promoção automática com TTL 7 dias para verified + low risk
• Aprovação humana apenas para hypothesis e high risk

Suporte multimodal

• Estrutura /assets/ por domínio e projeto
• Suporte depende do LLM configurado — não do agente
• Assets grandes referenciados por URL externa

Bug tracking

• Novo Context Pack: exemplo-bug-tracking.md
• Estrutura de tentativas (failed/success) com continuidade entre agentes e sessões

Scripts atualizados

• review-inbox agora processa TTL automaticamente
• Filtra por risco: só apresenta hypothesis e high risk para revisão humana

Whitepaper atualizado

• Princípio 5 reescrito: humano como auditor de última instância, não gargalo
• Limitações atualizadas com mitigação via hooks
• Tabela comparativa atualizada

v2.0.1 — Limitações conhecidas e progressão Graphiti

Adiciona seção 08 · Limitações Conhecidas ao whitepaper, com progressão arquitetural vault único → Graphiti → múltiplos vaults. PDF atualizado nos assets.

v2.0.0 — Hermes núcleo ativo

Reescrita Hermes-core: Hermes deixa de ser orquestrador leve para ser núcleo ativo com quatro papéis (roteador, gerenciador de memória com feedback, controlador de escopo, policy engine).

Mudanças principais

• Whitepaper PT-BR v2.0 com três gaps fechados (Validation, regra approved/superseded, política de escrita em qualquer modo) e diferencial novo: validade temporal automática por inspeção de mtime.
• Guia v2.0 reescrito com seção "Os quatro papéis do Hermes" e callout "Vault único, separação lógica por pastas".
• Template reestruturado de 6 para 11 pastas: 00-global, 10-projects, 20-domains, 30-clients, 40-workflows, 50-skills, 60-context-packs, 70-decisions, 80-agent-adapters, 90-inbox, 99-archive.
• Context Packs ganham campo Validation: (loop de feedback automático).
• Adapters (Claude, Cursor, Codex, Windsurf) com política de escrita unificada — escrita permanente proibida fora de /90-inbox/ em qualquer modo de execução.
• AGENT.md com regra explícita de resolução de conflito.

Compatibilidade

Estrutura de pastas mudou. Vaults criados com v1.0.0 precisam de renomeação manual ou de novo setup.sh em pasta nova.

PDFs

Ambos os artefatos disponíveis como assets desta release.

Lançamento inicial

v1.0 — Lançamento inicial

Primeira versão pública da arquitetura de Memória Federada para Agentes de IA.

O que tem nessa versão

• Whitepaper em português com o argumento arquitetural completo
• Guia de implementação v2 com passo a passo executável, diagramas SVG e seção de deployment remoto
• Template de vault clonável com estrutura de pastas, AGENT.md e exemplo de Context Pack
• Adaptadores prontos para Claude Code, Cursor, Windsurf e Codex
• Scripts de setup para PowerShell e Bash
• Licença CC BY 4.0 — uso livre com atribuição

Como começar

1. Clone o repositório
2. Leia o whitepaper para entender a tese
3. Siga o guia de implementação
4. Use o /template/ como ponto de partida

Documentação

• Whitepaper: /whitepaper/whitepaper-ptbr.html
• Guia: /guia/guia-implementacao-v2.html
• Contribuições: ver CONTRIBUTING.md