diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index d9886dbc..ea792b1c 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -58,6 +58,14 @@ Tipos algebraicos: `product` (struct, todos los campos presentes) o `sum` (union
 - **Diseño del schema:** carpeta docs/
 - **registry.db:** solo indice, regenerable con `fn index`
 
+## Build
+
+```bash
+# Requiere CGO y tag fts5 para SQLite FTS5
+CGO_ENABLED=1 go build -tags fts5 ./...
+CGO_ENABLED=1 go test -tags fts5 ./...
+```
+
 ## CLI (cmd/fn)
 
 ```bash