diff --git a/AGENTS.md b/AGENTS.md
index 1d29848..e69d25d 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -240,6 +240,7 @@ Use the following `flake.nix` for Strudel development:
 
 #### Usage
 
+**Option 1: Direct Nix commands**
 1. **Enter development shell**:
    ```bash
    nix develop
@@ -255,6 +256,37 @@ Use the following `flake.nix` for Strudel development:
    pnpm dev
    ```
 
+**Option 2: Using Makefile (recommended)**
+The Makefile provides convenient shortcuts for common development tasks:
+
+```bash
+# Install dependencies
+make install
+
+# Start development server
+make dev
+
+# Run tests
+make test
+
+# Run linter
+make lint
+
+# Format code
+make format
+
+# Run all checks
+make check
+
+# Enter Nix shell directly
+make shell
+
+# Show help
+make help
+```
+
+All Makefile commands automatically run within the Nix development environment.
+
 ### Live Performance Considerations
 
 When creating beats for live performance: