Codex Technomanticus

Audit Report — Trilha Memória de Agentes (Task 25)

Leitura de 6 min

Audit Report — Trilha Memória de Agentes

Auditoria final (Task 25) da trilha “Memória de Agentes” antes da publicação. Cobre wikilinks, frontmatter, dataview do MOC, sequência da trilha e integração com o MOC pai IA/IA.md.

Sumário executivo

Status: DONE_WITH_CONCERNS

A trilha está estruturalmente sólida, com 24 arquivos (1 MOC + 23 notas atômicas), frontmatter consistente, dataview funcional e integração com MOC pai feita. Há 1 wikilink órfão (typo apontando para arquivo inexistente) que deve ser corrigido em commit separado antes do publish.

Verificações

#VerificaçãoStatus
1Wikilinks internos resolvemFAIL — 1 link órfão
2Wikilinks externos à trilha resolvemOK
3Bloco dataview do MOC presente, sintaxe válida e filtro corretoOK
4IA/IA.md atualizado com entrada da nova trilhaOK
5Sequência 01 → 23 consistente (nomes batem)OK
6Frontmatter íntegro em todas as 24 notasOK
7Smoke test: 24 arquivos, todos > 1KBOK

Arquivo: IA/Memória de Agentes/08 - Arquitetura de um sistema de memória.md Linha 28: [[11 - Letta (ex-MemGPT) — memória hierárquica|Letta]] Problema: O arquivo 11 - Letta (ex-MemGPT) — memória hierárquica.md não existe. Realidade: A nota 11 é 11 - graphify — knowledge graph de raw.md. Letta é a nota 13 (13 - Letta (ex-MemGPT).md).

Correção sugerida: trocar o link para [[13 - Letta (ex-MemGPT)|Letta]].

Falsos positivos (não são órfãos)

Os seguintes targets aparecem no grep mas NÃO são wikilinks reais a resolver — são literais dentro de prosa explicativa ou exemplos de sintaxe sobre como wikilinks funcionam:

  • [[Nota X]] — em 07 - Por que Obsidian e markdown como substrato.md (texto explicativo: “Wikilinks [[Nota X]] formam um grafo…“)
  • [[outra-nota]], [[Outra Nota]], [[link]], [[wikilinks]] — em 12 - basic-memory — MCP nativo Obsidian.md (exemplos de convenção do basic-memory)
  • [[X]] — em 22 - Guia de implementação do zero.md (“Wikilinks [[X]] para tudo”)
  • [[#referências|Referências]] — em 09 - Panorama de implementações (abril 2026).md (link de heading interno, válido)

Wikilinks que apontam para fora da pasta Memória de Agentes/ — todos resolvem para arquivos existentes em IA/:

LinkResolve paraUsos
[[RAG e Vector Databases]]IA/RAG e Vector Databases.mdMOC + notas 04, 05, 10
[[MCP]]IA/MCP.mdnota 12 (2 ocorrências)

3. Dataview do MOC

Arquivo: IA/Memória de Agentes/Memória de Agentes.md

LIST file.frontmatter.title
FROM "IA/Memória de Agentes"
WHERE type != "moc"
SORT file.name ASC
  • Bloco presente: OK
  • Sintaxe válida: OK
  • Filtro WHERE type != "moc" exclui o próprio MOC: OK
  • Vai listar exatamente as 23 notas atômicas (todas com type: concept ou type: review): OK

4. Integração com IA/IA.md

Inserida nova seção entre “Construção” e “Ferramentas”:

## Memória de Agentes
 
- [[Memória de Agentes]] — trilha completa: do conceito ao guia de implementação, com fundamentação acadêmica e análise crítica

Restante do IA.md preservado intacto. O bloco dataview no final do IA.md usa FROM "IA" (recursivo), então também listará automaticamente a pasta da trilha — sem duplicação porque o filtro WHERE type != "moc" exclui o MOC novo.

5. Sequência 01 → 23

Todos os números sequenciais batem com arquivo correspondente. Sem buracos, sem duplicações:

01 - O que é memória em IA
02 - O problema das janelas de contexto
03 - Taxonomia da memória (episódica, semântica, procedural)
04 - RAG vs memória de longo prazo
05 - Beyond RAG - quando RAG não basta
06 - O LLM Wiki Pattern (gist do Karpathy)
07 - Por que Obsidian e markdown como substrato
08 - Arquitetura de um sistema de memória
09 - Panorama de implementações (abril 2026)
10 - LLM-knowledge-base (Wendel) — direto do gist
11 - graphify — knowledge graph de raw
12 - basic-memory — MCP nativo Obsidian
13 - Letta (ex-MemGPT)
14 - Mem0 — vetorial + grafo
15 - Zep e Graphiti — knowledge graph temporal
16 - MemPalace (Milla Jovovich)
17 - Generative Agents (Park, Stanford 2023)
18 - A-MEM — Zettelkasten dinâmico
19 - Surveys e estado da arte 2026
20 - Comparativo crítico (LongMemEval)
21 - Críticas, limitações e armadilhas
22 - Guia de implementação do zero
23 - Aplicações comerciais e modelo de negócio

A sequência segue arco lógico: conceito → problema → taxonomia → RAG/post-RAG → padrão Karpathy → substrato → arquitetura → panorama → ferramentas (10–16) → fundação acadêmica (17–19) → comparativo crítico (20–21) → guia prático → produto.

6. Frontmatter

Todas as 24 notas têm title, type, publish: true e tags. Distribuição de type:

  • moc: 1 (Memória de Agentes.md)
  • concept: 20 (notas 01–16, 20–23)
  • review: 3 (notas 17, 18, 19 — papers/surveys)

Todas as 23 notas atômicas têm status: seedling (correto para primeira publicação). O MOC não tem status — comportamento padrão para MOCs no Codex.

7. Smoke test

  • Total de arquivos: 24 (1 MOC + 23 notas) ✓
  • Nenhum arquivo vazio ou stub ✓
  • Tamanhos (em bytes):
    • Menor: Memória de Agentes.md (6.079 bytes — MOC, esperado)
    • Menor nota: 18 - A-MEM — Zettelkasten dinâmico.md (9.797 bytes)
    • Maior: 21 - Críticas, limitações e armadilhas.md (18.798 bytes)
    • Todos os arquivos > 1KB ✓

Sumário de palavras

  • Total da trilha: ~48.251 palavras
  • MOC: 950 palavras
  • Notas atômicas: 1.401–2.776 palavras (média ~2.058)
  • Mais densas: nota 21 (críticas, 2.776), nota 13 (Letta, 2.568), nota 16 (MemPalace, 2.519), nota 08 (arquitetura, 2.449)
  • Mais leves: nota 18 (A-MEM, 1.401), nota 01 (introdução, 1.610), nota 04 (RAG vs memória, 1.619), nota 07 (Obsidian/markdown, 1.655)

Recomendações finais

Antes do publish (bloqueante)

  1. Corrigir wikilink órfão em 08 - Arquitetura de um sistema de memória.md, linha 28:

    • De: [[11 - Letta (ex-MemGPT) — memória hierárquica|Letta]]
    • Para: [[13 - Letta (ex-MemGPT)|Letta]]

    Comando sugerido (commit separado, pós-review):

    cd "/home/josenaldo/repos/personal/codex-technomanticus"
# Edição manual ou sed
git add "IA/Memória de Agentes/08 - Arquitetura de um sistema de memória.md"
git commit -m "fix(memoria-agentes): corrigir wikilink órfão em nota 08 (Letta é nota 13)"

Pós-publish (não bloqueante)

  • Considerar promover algumas notas de seedling para budding quando houver revisão de leitor externo (p.ex. notas 06 e 22 são as mais densas em conteúdo prático e candidatas naturais).
  • A nota 09 (“Panorama de implementações abril 2026”) tem teor temporal explícito; vale anotar revisão programada para ~outubro/2026 se algum framework deprecate ou novo entrar.

Conclusão

Trilha pronta para publish após o fix do wikilink órfão. Estrutura, densidade e integração com o vault estão todas no padrão esperado para o Codex Technomanticus.

Visão de gráfico