From 9c922caf53567302971a12461f2c6b1b52a10d7a Mon Sep 17 00:00:00 2001
From: Michael Czechowski <mail@dailysh.it>
Date: Sat, 27 Sep 2025 14:34:18 +0200
Subject: [PATCH] update agents.md with makefile usage instructions

---
 AGENTS.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

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: