diff --git a/Justfile b/Justfile
index 61abd17..c09cf78 100644
--- a/Justfile
+++ b/Justfile
@@ -1,10 +1,12 @@
-
+# run pre-commit linters
 lint:
     uv run pre-commit run --all-files
 
+# run pytest
 test *ARGS:
     uv run pytest {{ARGS}}
 
+# reset database and ephemeral files
 reset:
     rm -rf _logs/*
     rm -rf _staticfiles
@@ -12,6 +14,7 @@ reset:
     uv run python manage.py migrate
     uv run python manage.py createsuperuser
 
+# run development server
 runserver *ARGS:
     uv run python manage.py runserver {{ARGS}}