diff --git a/README.md b/README.md
index 6bc31d4..d7916d3 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,18 @@
-# pulse-memory
+# Pulse Memory 🧠
 
-Pulse Agent — pulse-memory
\ No newline at end of file
+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)