diff --git a/Makefile b/Makefile
index 5c04c0b..eabcba5 100644
--- a/Makefile
+++ b/Makefile
@@ -7,7 +7,7 @@ help: ## Show this help message
 	@echo ""
 	@echo "Usage: make <target>"
 
-install-dev: ## Install development dependencies
+install-dev: ## Install development dependencies which could be optional for normal usage
 	uv pip install -e ".[dev]" && uv pip install -e ".[test]"
 
 format: ## Format code using ruff
@@ -26,7 +26,7 @@ lint-frontend: ## Lint frontend code, run tests, and check build
 serve: ## Start development server with reload
 	uv run server.py --reload
 
-test: ## Run tests with pytest
+test: ## Run tests with pytest, need to run after 'make install-dev' for first time
 	uv run pytest tests/
 
 langgraph-dev: ## Start langgraph development server