diff --git a/.gitignore b/.gitignore
index 003af4f4f..afca18310 100644
--- a/.gitignore
+++ b/.gitignore
@@ -83,4 +83,9 @@ wiki/economics/corporations/generated_corporations.toml
 
 # Local agent tooling caches (per-machine, not shared)
 .clide/
-.pql/
+
+# pql: ignore the rebuildable local databases (index + planning DB + WAL/SHM
+# sidecars), but TRACK .pql/config.yaml and .pql/changelog/ — the changelog is
+# pql's durable, git-versioned planning state (LWW, idempotent replay).
+.pql/*.db
+.pql/*.db-*