Skill: Memória do Usuário

Esta skill gerencia a memória persistente por usuário, permitindo que Claude lembre informações entre sessões diferentes.

---

USO PROATIVO (IMPORTANTE!)

Quando CONSULTAR memórias automaticamente:

1. Início de sessão/conversa nova

   • Sempre verifique se há memórias salvas para o usuário
   • Adapte seu comportamento baseado nas preferências encontradas

2. Antes de fazer perguntas

   • Verifique se a resposta já está nas memórias
   • Exemplo: Se usuário já disse que é dono da empresa, não pergunte novamente

3. Ao receber contexto sobre o usuário

   • Verifique se já sabe algo relacionado
   • Conecte informações novas com as existentes

Quando SALVAR memórias automaticamente:

1. Preferências de comunicação

   • "Prefiro respostas curtas" → SALVAR
   • "Pode ser mais detalhado" → SALVAR
   • "Não gosto de emojis" → SALVAR

2. Fatos sobre o usuário

   • Nome, cargo, responsabilidades → SALVAR
   • Clientes que gerencia → SALVAR
   • Produtos com que trabalha mais → SALVAR

3. Padrões de comportamento observados

   • Sempre pergunta sobre Atacadão primeiro → SALVAR
   • Prefere ver estoque antes de criar separação → SALVAR
   • Costuma verificar palmito frequentemente → SALVAR

4. Correções e esclarecimentos

   • "Não é assim que funciona aqui" → SALVAR a regra correta
   • "Esse campo se chama X, não Y" → SALVAR correção
   • "Aqui usamos o termo Z" → SALVAR terminologia

5. Decisões tomadas

   • "Atacadão 183 sempre fica por último" → SALVAR regra
   • "FOB sempre manda completo" → SALVAR (se não estiver no CLAUDE.md)

Quando ATUALIZAR memórias:

1. Informação mudou

   • "Agora sou gerente" (antes era analista) → ATUALIZAR
   • "Mudamos o processo" → ATUALIZAR

2. Preferência mudou

   • "Agora pode usar emojis" → ATUALIZAR

---

USO REATIVO (Quando usuário pede)

• Usuário pede para lembrar algo: "Lembre que prefiro respostas diretas"
• Usuário pergunta o que Claude sabe: "O que você sabe sobre mim?"
• Usuário quer apagar memórias: "Esqueça minhas preferências"

---

Scripts Disponíveis

Ver Memórias

source .venv/bin/activate && python .claude/skills/memoria-usuario/scripts/memoria.py view --user-id USER_ID
source .venv/bin/activate && python .claude/skills/memoria-usuario/scripts/memoria.py view --user-id USER_ID --path /memories/preferences.xml

Salvar Memória

source .venv/bin/activate && python .claude/skills/memoria-usuario/scripts/memoria.py save --user-id USER_ID --path /memories/preferences.xml --content "<preferences>...</preferences>"

Atualizar Memória (substituir texto)

source .venv/bin/activate && python .claude/skills/memoria-usuario/scripts/memoria.py update --user-id USER_ID --path /memories/preferences.xml --old "texto antigo" --new "texto novo"

Deletar Memória

source .venv/bin/activate && python .claude/skills/memoria-usuario/scripts/memoria.py delete --user-id USER_ID --path /memories/preferences.xml

Limpar Todas as Memórias

source .venv/bin/activate && python .claude/skills/memoria-usuario/scripts/memoria.py clear --user-id USER_ID

---

Estrutura de Paths Recomendada

/memories/
├── user.xml              # Informações básicas do usuário
├── preferences.xml       # Preferências de comunicação
├── context/
│   ├── company.xml       # Informações da empresa
│   ├── role.xml          # Cargo/responsabilidades
│   └── clients.xml       # Clientes que gerencia
├── learned/
│   ├── terms.xml         # Termos específicos aprendidos
│   ├── rules.xml         # Regras de negócio aprendidas
│   └── patterns.xml      # Padrões observados
└── corrections/
    └── mistakes.xml      # Correções de erros comuns

---

Formato XML Recomendado

<!-- /memories/user.xml -->
<user>
    <name>Rafael</name>
    <role>Dono da empresa</role>
    <updated_at>2024-12-09</updated_at>
</user>

<!-- /memories/preferences.xml -->
<preferences>
    <communication>direto e objetivo</communication>
    <detail_level>alto quando pedido</detail_level>
    <language>portugues brasileiro</language>
    <emojis>permitido</emojis>
    <updated_at>2024-12-09</updated_at>
</preferences>

<!-- /memories/context/clients.xml -->
<clients>
    <managed>
        <client name="Atacadao" priority="P4" gestor="Junior"/>
        <client name="Assai" priority="P5" gestor="Junior/Miler"/>
    </managed>
    <frequent_queries>palmito, azeitona verde</frequent_queries>
</clients>

<!-- /memories/learned/patterns.xml -->
<patterns>
    <pattern type="workflow">
        <description>Usuario sempre verifica estoque antes de criar separacao</description>
        <learned_at>2024-12-09</learned_at>
    </pattern>
    <pattern type="preference">
        <description>Prefere ver disponibilidade por grupo antes de pedido individual</description>
        <learned_at>2024-12-09</learned_at>
    </pattern>
</patterns>

<!-- /memories/corrections/mistakes.xml -->
<corrections>
    <correction>
        <wrong>data_agendamento_pedido</wrong>
        <right>agendamento (campo da Separacao, nao da Carteira)</right>
        <learned_at>2024-12-09</learned_at>
    </correction>
</corrections>

---

Fluxo de Uso Proativo

INÍCIO DA SESSÃO
      │
      ▼
┌─────────────────────────────┐
│ Verificar memórias do user  │
│ view --user-id X            │
└─────────────────────────────┘
      │
      ▼
┌─────────────────────────────┐
│ Há memórias?                │
│ SIM → Carregar e adaptar    │
│ NAO → Comportamento padrão  │
└─────────────────────────────┘
      │
      ▼
DURANTE A CONVERSA
      │
      ▼
┌─────────────────────────────┐
│ Usuário disse algo novo?    │
│ - Preferência → SALVAR      │
│ - Fato pessoal → SALVAR     │
│ - Correção → SALVAR         │
│ - Padrão observado → SALVAR │
└─────────────────────────────┘
      │
      ▼
┌─────────────────────────────┐
│ Informação mudou?           │
│ SIM → ATUALIZAR memória     │
└─────────────────────────────┘

---

Importante

• Memórias são isoladas por usuário (user_id)
• Persistem entre sessões diferentes
• NÃO armazene histórico de conversas (já é feito automaticamente)
• Use para FATOS, PREFERÊNCIAS e PADRÕES
• Sempre inclua

  updated_at

  ou

  learned_at

  para rastreabilidade
• Pergunte ao usuário se não tiver user_id definido

---

Exemplos de Uso Proativo

Cenário 1: Início de sessão

Usuário: "Olá, preciso analisar a carteira"

Claude (internamente):
1. Verificar memórias do usuário
2. Encontra: preferência por respostas diretas
3. Encontra: costuma focar em Atacadão primeiro
4. Adapta resposta para ser direta e começar por Atacadão

Cenário 2: Aprendendo preferência

Usuário: "Pode ser mais resumido? Não precisa de tanto detalhe"

Claude:
1. Entende preferência
2. SALVA em /memories/preferences.xml
3. Adapta resposta atual
4. Lembra nas próximas sessões

Cenário 3: Aprendendo padrão

(Claude observa que usuário SEMPRE pergunta sobre palmito primeiro)

Claude (internamente):
1. Detecta padrão após 3+ ocorrências
2. SALVA em /memories/learned/patterns.xml
3. Nas próximas sessões, pode sugerir proativamente