diff --git a/.gitignore b/.gitignore
index e721e0b..9afdb0f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -55,10 +55,13 @@ Thumbs.db
 *.swo
 
 # Agent runtime (not project config)
-.claude/projects/
 .cursor/projects/
 .cursor/plans/
 
 # Companion repo with subproject code lives separately
 # Pushed as subkoks/SolanaIdeasLab-projects
 projects/
+
+# Claude Code (commit shared settings; ignore machine-local perms + transcripts)
+.claude/*
+!.claude/settings.json
diff --git a/CLAUDE.md b/CLAUDE.md
index f30a431..3ed8234 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -9,6 +9,8 @@ agent rules live in `AGENTS.md` — load them:
 Key documents: `MASTER-PLAN.md`, `ARCHITECTURE.md`, `MARKET-MAP.md`,
 `GAP-ANALYSIS.md`, `tech-stack.md`, and the `ideas/` backlog.
 
+**Pre-ship (any Solana code):** run `solana-reviewer` subagent before shipping code that signs or submits transactions.
+
 ## Cloud sessions (Claude Code on the web)
 
 This repo is cloud-ready. A `SessionStart` hook (`.claude/settings.json` ->