feat: estrutura inicial pulse-memory (memory/, context/, cache/)

README.md

@@ -1,3 +1,18 @@
-# pulse-memory
+# Pulse Memory 🧠
 
-Pulse Agent — pulse-memory
+Repositório de memórias do agente Pulse — curto prazo, longo prazo e contexto.
+
+## Estrutura
+
+```
+memory/           — Memórias curadas (MEMORY.md + daily YYYY-MM-DD.md)
+context/          — Contexto de sessão, SESSION-STATE.md
+cache/            — Cache temporário, extractos de web, JSONs de API
+```
+
+## Política
+
+- **memory/** → commit sempre que houver aprendizado relevante (best_practice, correction, knowledge_gap)
+- **context/** → commit ao fim de cada sessão com SESSION-STATE atualizado
+- Arquivos antigos (30+ dias) são arquivados em `context/archive/`
+- Nunca commitar segredos (usar env vars ou secrets)