diff --git a/CLAUDE.md b/CLAUDE.md
index 4e3da9b..1c1caec 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -14,6 +14,13 @@
 - Designed to be "truly aligned to you" rather than corporations or higher authorities
 - Emphasizes user alignment, creative expression, and adaptive interaction patterns
 
+## Development Workflow
+- ALWAYS run `npx biome format --write .` before committing to format all files
+- ALWAYS run `npx biome check .` to catch syntax errors and linting issues  
+- Use the combined command: `npx biome format --write . && npx biome check .`
+- If biome check fails, fix the issues before proceeding with commit/push
+- This prevents breaking production with syntax errors like missing parentheses
+
 ## Commit Message Guidelines
 - Use single line commit messages only
 - Never include Claude Code attribution or "Generated with Claude Code"