Módulo 2.4 - Memory-Driven Development

🔍 Search-first pattern

Antes de codar qualquer coisa não-trivial, busque o que já existe. Memória semântica responde em ms graças ao HNSW. Você economiza tokens, evita reinvenção e aproveita decisões boas anteriores.

🎯O que buscar antes

•Padrões de implementação semelhantes
•Decisões de design já tomadas
•Bugs anteriores na mesma área
•Convenções do projeto/time

💻Comando de busca

npx claude-flow@v3alpha memory search \
  -q "JWT token validation patterns"

HNSW retorna top-K por similaridade em milissegundos.

💾 Store-after pattern

Após task concluída, grave a trajetória. Hooks post-task automatizam: capturam estado, ação, resultado e classificam sucesso/falha. Próxima tarefa similar reaproveita.

🎣Hook automatizado

npx claude-flow@v3alpha hooks post-task \
  --task-id "auth-jwt-001" \
  --success true \
  --train-neural true

📦O que é gravado

Estado inicial — contexto antes da ação
Ação executada — código produzido / decisão tomada
Resultado — sucesso, falha, métricas
Reward — sinal para SONA aprender

💡Dica prática

Configure post-task como hook automático no settings.json. Você esquece, mas ele continua coletando — em 2 semanas tem corpus rico de trajetórias.

🗃️ Namespace strategy

Não jogue tudo no mesmo balde. Separe por tipo de conteúdo: padrões, tarefas, soluções, feedback. Cada namespace fica especializado e a busca fica precisa.

patterns

Padrões reutilizáveis cross-task

Idioms, recipes, abordagens validadas — alimenta search-first.

tasks

Histórico operacional

Cada task com estado completo — útil para auditoria e debug.

solutions

Implementações concretas que funcionaram

Snippets, configs, fixes — copy-paste com contexto.

feedback

Aprendizados, falhas, postmortems

"Não fizemos X porque Y" — evita repetir erros antigos.

🧠 ReasoningBank trajectories

Trajetórias seguem o esquema clássico de RL: state → action → reward → outcome. SONA usa esses tuples para identificar padrões que funcionam e descartar os que não.

📐Estrutura de trajectory

{
  state: "API has no auth, request needs OAuth",
  action: "Implemented PassportJS with JWT strategy",
  reward: 0.92,  // tests passed, code reviewed
  outcome: "success",
  timestamp: 1709123456
}

⚡Como SONA aprende

RETRIEVE — busca trajectories similares
JUDGE — avalia veredicto (sucesso/falha)
DISTILL — extrai insights via LoRA
CONSOLIDATE — EWC++ evita esquecer

🌉 Memory bridge Claude Code

O Claude Code tem memória própria em ~/.claude/projects/*/memory/*.md. O bridge importa para AgentDB com embeddings ONNX 384-dim — você consulta tudo unificadamente, com search semântica real.

🔗Tools MCP do bridge

memory_import_claude — importa memórias para AgentDB
memory_bridge_status — saúde do bridge (Claude files, AgentDB, SONA)
memory_search_unified — busca semântica em todos namespaces

🎯Auto-import on session start

O hook SessionStart importa automaticamente o projeto atual. Para todos:

node .claude/helpers/auto-memory-hook.mjs import-all

♻️ Reuse patterns entre projetos

O verdadeiro ganho vem quando memória atravessa projetos. Um pattern descoberto no projeto A vira solução pronta no projeto B. Use namespace global ou export/import explícito.

✓ Vale compartilhar

✓Padrões de erro handling
✓Decisões de arquitetura genéricas
✓Snippets de configuração
✓Postmortems técnicos

✗ Mantenha local

✗Credenciais ou secrets
✗Schemas proprietários
✗Decisões muito específicas de domínio
✗Histórico de tasks operacionais

📤Transfer entre namespaces

npx claude-flow@v3alpha hooks transfer store \
  --pattern "auth-jwt-success"

📋Resumo do Módulo

✓

Search-first — busque padrões existentes antes de codar

✓

Store-after — grave trajetórias via hooks post-task

✓

Namespaces — patterns / tasks / solutions / feedback

✓

Trajectories — state, action, reward, outcome para SONA

✓

Bridge — Claude Code memories + AgentDB unified search

✓

Reuse — compartilhe padrões genéricos entre projetos

Próximo Módulo:

2.5 - Plugin Ecosystem: 33 plugins via IPFS

← Voltar para Trilha Próximo Módulo →