diff --git a/README.md b/README.md
index 1b78df7..df45967 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,8 @@
 # lumbunglib
 
 > Python lib which powers `lumbung[dot]space` automation
+
+## hacking
+
+- run `poetry run poetry2setup > setup.py` if updating the poetry dependencies
+- if adding a new cli command, extend `pyproject.toml` with a new `[tool.poetry.scripts]` entry