From 878633271963d771b76e7fd4849c3b1707484a6c Mon Sep 17 00:00:00 2001
From: Pulse Agent <agent@pulse.ai>
Date: Wed, 20 May 2026 10:36:09 -0300
Subject: [PATCH] feat: estrutura inicial pulse-memory (memory/, context/,
 cache/)

---
 README.md | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

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)