diff --git a/AGENTS.md b/AGENTS.md
index 1a79307..951a842 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -4,9 +4,9 @@
 
 ## 🧠 Contexto do Projeto & Memória no Obsidian
 - **Cofre Principal:** `$OBSIDIAN_VAULT_PATH/`
-- **Ficha do Projeto:** `$OBSIDIAN_VAULT_PATH/03_Dev_Projetos/PDF_Toolkit/00_Index.md`
-- **Padrões de Arquitetura:** `$OBSIDIAN_VAULT_PATH/03_Dev_Projetos/PDF_Toolkit/padroes-arquitetura.md`
-- **Registro de Gotchas & Lições:** `$OBSIDIAN_VAULT_PATH/03_Dev_Projetos/PDF_Toolkit/gotchas-e-bugs.md`
+- **Ficha do Projeto:** `$OBSIDIAN_VAULT_PATH/Projects/pdf-toolkit/Index.md`
+- **Padrões de Arquitetura:** `$OBSIDIAN_VAULT_PATH/Projects/pdf-toolkit/padroes-arquitetura.md`
+- **Registro de Gotchas & Lições:** `$OBSIDIAN_VAULT_PATH/Projects/pdf-toolkit/gotchas-e-bugs.md`
 - **Especificação de Escopo:** [docs/escopo.md](docs/escopo.md)
 - **Roadmap & Fases:** [docs/fases.md](docs/fases.md)
 - **Documentação de Arquitetura Local:** [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..ab961a6
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,13 @@
+# CLAUDE.md — Diretrizes de Desenvolvimento (PDF Toolkit)
+
+@~/AGENTS.md
+
+## 📌 Contexto Rápido
+- **Cliente:** CM Consultor (Interno)
+- **Memória no Vault:** `$OBSIDIAN_VAULT_PATH/Projects/pdf-toolkit/Index.md`
+- **Escopo e Fases:** `docs/escopo.md` e `docs/fases.md`
+- **Repositório Gitea:** `https://gitea.cmconsultor.com.br/cmconsultor/pdf-toolkit`
+
+## 🧪 Padrões de Testes & Execução
+- Use `pytest` para testes unitários.
+- Sempre processar PDFs em memória via `io.BytesIO`.