diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..d542499
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,9 @@
+# Development Guidelines
+
+## Python Environment
+- Always use `python3` directly, never `python`
+- Run `black` code formatter after creating or modifying Python files
+
+## Git Workflow
+- Avoid committing unrelated untracked files (e.g., `node_modules/`, build artifacts)
+- Only commit relevant project files
\ No newline at end of file