diff --git a/AGENTS.md b/AGENTS.md
index ac848f6..4093a19 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,5 +1,12 @@
 ## Dev environment tips
 
 - use treefmt to format all files
-- make python code ruff compliant
-- use pytest to test python code
+- keep new code consistent with the existing style
+
+### Python
+
+- make code `ruff` compliant
+- use pytest to test python code tests should be put in `tests` directory
+- dont use global state
+- use google style docstrings
+- use typer over argparse