From 296d2ec047832315b102e7996c3846d011c3f51a Mon Sep 17 00:00:00 2001
From: Michael Czechowski <mail@dailysh.it>
Date: Sat, 16 Aug 2025 18:28:04 +0200
Subject: [PATCH] feat: improve VM command naming and add commit guidelines

---
 AGENTS.md |  1 +
 Makefile  | 13 ++++++++-----
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 7e7be4b..066a6c9 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -23,6 +23,7 @@ This file provides guidelines for AI coding agents operating within this reposit
 - **Domain**: Use `codecrispi.es` consistently across all environments
 - **Password Policy**: Minimize password usage; prefer key-based authentication
 - **Error Handling**: Handle errors explicitly. Use Nix's error reporting mechanisms.
+- **Commit Messages**: Use conventional commit style (`type: subject`). Avoid scopes like `(makefile)`. The subject should be in lowercase.
 
 ## Container Architecture
 
diff --git a/Makefile b/Makefile
index 70c3f69..093c60d 100644
--- a/Makefile
+++ b/Makefile
@@ -1,7 +1,7 @@
 -include .env
 export
 
-.PHONY: help deploy-cloud build-usb flash-usb local-vm test-vm clean status destroy-cloud opencode lint
+.PHONY: help deploy-cloud build-usb flash-usb vm-run vm-build clean status destroy-cloud opencode lint
 
 DOMAIN := $(or $(WORKSHOP_DOMAIN),codecrispi.es)
 USB_DEVICE := $(or $(USB_DEVICE),/dev/sdX)
@@ -20,8 +20,9 @@ help:
 	@echo "  make test-usb        - Test USB environment in QEMU"
 	@echo ""
 	@echo "🖥️ Local Development:"
-	@echo "  make local-vm        - Start local VM (simulates USB environment)"
-	@echo "  make test-vm         - Test VM without GUI"
+	@echo "  make vm-run          - Start local VM (simulates USB environment)"
+	@echo "  make vm              - Alias for vm-run"
+	@echo "  make vm-build        - Test VM without GUI"
 	@echo "  make clean           - Clean build artifacts"
 	@echo ""
 	@echo "⚙️ Development:"
@@ -67,11 +68,13 @@ test-usb: build-usb
 		-device virtio-net,netdev=net0 \
 		-display gtk
 
-local-vm:
+vm-run:
 	@echo "🖥️ Starting workshop VM..."
 	nix run .#local-vm
 
-test-vm:
+vm: vm-run
+
+vm-build:
 	@echo "🧪 Testing VM build..."
 	nix build .#local-vm
 	@echo "✅ VM builds successfully"