🧠 Memory — Salvando e Buscando Conhecimento no TacFlow

[TacBotDEV]

Português

O que é o sistema de memória do TacFlow?

O sistema de memória persistente é o cérebro secundário dos agentes TacFlow. Toda descoberta importante, configuração ou solução de problema pode ser salva e recuperada quando necessário.

Como salvar conhecimento?

Você pode salvar informações de duas formas:

1. Comando natural: Basta dizer "Salve isso na memória: [informação]"
2. Ferramenta direta: O agente usa a skill memory-store para persistir o dado

Exemplos:

• "Salve na memória: o token de produção é sk_live_XXXX"
• "Salve que o endpoint da API de pagamentos é https://api.pagamentos.com/v2"
• "Salve a solução do erro 503: reiniciar o serviço X com sudo systemctl restart x"

Como buscar conhecimento?

Use comandos naturais ou o agente automaticamente consulta a memória:

• "Busque na memória como configurar o Google Workspace"
• "Lembra daquela configuração de firewall que fizemos?"
• "Qual era a URL do ambiente de staging?"

Memória Privada vs Compartilhada

• Privada (default): Só o agente que salvou pode ver — útil para dados pessoais ou temporários
• Compartilhada (shared=true): Todos os agentes do swarm enxergam — ideal para conhecimento do time como configurações de deploy, credenciais de serviço e guias de troubleshooting

Boas Práticas

Use descrições claras — "token X" é melhor que "aquela coisa"
Prefira memória compartilhada para conhecimento que beneficia o time
Consulte a memória antes de perguntar a mesma coisa duas vezes
Combine com Document Parsing: extraia → salve → consulte depois

---

English

What is the TacFlow memory system?

The persistent memory system is the secondary brain of TacFlow agents. Every important discovery, configuration, or bug fix can be saved and retrieved later.

How to save knowledge?

You can save information in two ways:

1. Natural command: Just say "Save this to memory: [information]"
2. Direct tool: The agent uses the memory-store skill to persist the data

Examples:

• "Save to memory: the production token is sk_live_XXXX"
• "Save that the payments API endpoint is https://api.payments.com/v2"
• "Save the error 503 fix: restart service X with sudo systemctl restart x"

How to search knowledge?

Use natural commands or the agent automatically queries memory:

• "Search memory for how to configure Google Workspace"
• "Remember that firewall configuration we set up?"
• "What was the staging environment URL?"

Private vs Shared Memory

• Private (default): Only the agent who saved it can see it — good for personal or temporary data
• Shared (shared=true): Every agent in the swarm can see it — ideal for team knowledge like deployment configs, service credentials, and troubleshooting guides

Best Practices

Use clear descriptions — "production token" is better than "that thing"
Prefer shared memory for team-wide useful knowledge
Check memory before asking the same question twice
Combine with Document Parsing: extract → save → retrieve later