📥 Instalando a skill
A skill vive em ~/.claude/skills/memory-architect/. Copie a pasta e pronto.
📐 Instalacao
# Opcao 1: a partir dos materiais do curso cp -r skills/memory-architect ~/.claude/skills/ # Opcao 2: download direto mkdir -p ~/.claude/skills/memory-architect # copie memorydesigner.md para la como SKILL.md # Verificar ls ~/.claude/skills/memory-architect/ # Deve ter: SKILL.md, references/, scripts/ # Usar # Em qualquer sessao Claude Code: /memory-architect
💡 Skill ja e interativa
Usa AskUserQuestion. Voce responde multiple choice; ela constroi.
🎤 A entrevista guiada
11 perguntas que transformam suas preferencias em especificacao tecnica.
📋 Perguntas da skill
Sequencia padrao:
- •Quem voce e? (role)
- •Nivel tecnico? (terminal / CLI / GUI)
- •Quais camadas precisa? (multi-select das 7)
- •Como capturar? (auto / manual / filter)
- •Formato? (Obsidian / markdown / DB)
- •Estrutura? (flat / taxonomia / grafo)
- •Retrieval? (keyword / semantic / hybrid)
- •Injection? (bulk / progressive / per-project)
- •Lifecycle? (keep / decay / promote)
- •Infraestrutura? (plain / SQLite / cloud)
- •Em que projeto esta trabalhando agora?
💡 Modo full ou fast
Full walkthrough ensina cada conceito antes de perguntar (~10min). Fast track pergunta direto (~3min).
📄 MEMORY_BUILD_PLAN.md
O documento que sai: sua especificacao executavel. Compartilhavel com time.
📐 Exemplo de output
# MEMORY_BUILD_PLAN.md
## Perfil
Role: Backend engineer
Nivel: Terminal comfortable
Projeto atual: payments-v2
## Camadas escolhidas
- Identidade (sempre)
- Contexto critico (sempre)
- Long-term knowledge (pesquisado)
- Promotion (3-strike)
## Infraestrutura
- Format: markdown + SQLite com FTS5
- Local: ~/.memory/
- Backup: git privado
## Hooks
- SessionStart: injeta prime.md + context.md
- PreCompact: re-injeta context.md
- UserPromptSubmit: router por keyword
- SessionEnd: roda Gemini Flash para resumo
## Scripts
- ~/.memory/hooks/session_start.sh (pronto)
- ~/.memory/hooks/pre_compact.sh (pronto)
- ~/.memory/scripts/promote.py (a fazer)
- ~/.memory/scripts/decay.py (opcional)
## Setup inicial
1. mkdir ~/.memory/{knowledge,hooks,scripts,archive}
2. Popular prime.md e context.md com dados reais
3. Copiar hooks/ do lab
4. Configurar .claude/settings.json💡 Arquivo vivo
Nao e one-shot. Revise trimestralmente. Quando algo muda na sua rotina, atualize o plan.
⚙️ Advisor mode
Skill detecta se voce ja tem sistema e entra em modo consultor.
🩺 Opcoes em advisor mode
Quando skill detecta ~/.memory/ existente:
- •Review: diagnostico completo (estagios, decay, promotion pendente)
- •Add layer: incorporar camada nova sem quebrar existente
- •Change backend: migrar markdown → SQLite, local → cloud
- •Tune decay: mudar agressividade, ajustar salience
- •Explain concept: educar sobre padrao especifico
- •Start fresh: ignorar existente, recomecar
🎯 Rode agora: skill em acao
Exercicio ativo. Pause aqui, abra Claude Code, rode /memory-architect.
Preparacao (5 min)
Instale a skill (copie a pasta). Abra Claude Code em um diretorio neutro.
Entrevista (10 min)
Rode /memory-architect. Escolha Full walkthrough na primeira vez.
Revisar output (5 min)
Leia o MEMORY_BUILD_PLAN.md gerado. Marque o que parece estranho.
Iterar (opcional)
Rode de novo com outros responses para ver como muda o plano.
💡 Aprende fazendo
Ler sobre a skill nao substitui rodar. Em 20 minutos voce tem documento personalizado em maos.
🔍 Revisando o plano gerado
Checklist de 10 pontos antes de executar o plano.
📐 Review checklist
1. Paths absolutos, nao relativos? 2. Camadas alinhadas com fingerprint (modulo 1.5)? 3. Backend adequado ao volume estimado? 4. Hooks escolhidos sao os criticos? 5. Ha plano de backup (git, cron tar)? 6. Scripts de decay/promote incluidos? 7. Skill instalada no user-level (nao project)? 8. Ha metricas (log, counter) planejadas? 9. Migration path previsto para crescer? 10. Cap de tokens por camada definido? Marque cada um antes de rodar comandos de setup.
💡 Plan ≠ Execute
Skill gera plan. Voce decide quando executar. Nunca rode setup sem revisar — custo de reverter e maior.
📝 Resumo do Modulo
Proximo:
6.2 — Construindo ~/.memory/