diff --git a/CLAUDE.md b/CLAUDE.md
index 6efbbdf..1efe110 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -8,6 +8,17 @@ browse and download games from each other. Ships as a Tauri desktop app.
 
 Always commit changes without asking me.
 
+## Code Quality
+
+Treat every change with a production-quality mindset:
+
+- Best practices, idiomatic Rust
+- Think about architecture before doing a change
+- Modular code, well-capsulated components
+  - each component must be easy to reason through
+- review every change critically
+- test every change and make sure test coverage is high
+
 ## Workspace layout
 
 Cargo workspace under `crates/`: