diff --git a/CLAUDE.md b/CLAUDE.md
index 642df0dc6..77d8132f4 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,6 +1,6 @@
 # Commonwealth Game Project
 
-A top-down immersive sim set in Peter F. Hamilton's Commonwealth universe. Single-character, first-person perspective, asymmetric information as core mechanic, Rimworld-style storyteller.
+A top-down immersive sim — occlusion-based detective game with combat elements, set in an original science fiction universe (Commonwealth-inspired). Single-character perspective, asymmetric information as core mechanic, Rimworld-style storyteller. Godot 4 client + Rust/bevy_ecs simulation server via subprocess/IPC (D-020).
 
 ## Project Structure
 
@@ -35,17 +35,18 @@ db/
 ### SQLite access
 **Never use the `sqlite3` CLI** - it crashes in Claude Code due to a known std::bad_alloc bug.
 
-Use the connector script instead:
+Use the whitelistable wrapper scripts:
 ```bash
-python3 db/connectors/sqlite_connector.py query "SELECT * FROM tickets WHERE status='in_progress'"
-python3 db/connectors/sqlite_connector.py execute "UPDATE tickets SET status='done' WHERE id=1"
+db/connectors/sqlite-query "SELECT * FROM tickets WHERE status='in_progress'"
+db/connectors/sqlite-exec "UPDATE tickets SET status='done' WHERE id=1"
 ```
 
 ### Qdrant / document search
 ```bash
-python3 db/connectors/qdrant_connector.py search "asymmetric information design"
-python3 db/connectors/qdrant_connector.py index-file docs/briefings/tyre.md
-python3 db/connectors/qdrant_connector.py health
+db/connectors/qdrant-search "asymmetric information design"
+db/connectors/qdrant-index docs/briefings/tyre.md
+db/connectors/qdrant-health
+db/connectors/qdrant-count
 ```
 
 ### File conventions