Add help on available Makefile targets

Author: mengdaming

Makefile

@@ -8,33 +8,39 @@ CONFIG_PKG="github.com/murex/gamekit-coffeemachine/settings"
 export CGO_ENABLED=0
 
 .PHONY: default
-default: build ;
+default: help ## Shows this help message (default target)
+
+.PHONY: help
+help: ## Show this help message
+	@echo "Available targets:"
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-15s\033[0m %s\n", $$1, $$2}'
 
 # Convenience target for automating release preparation
 .PHONY: prepare
-prepare: deps tidy lint modernize build test
+prepare: deps tidy lint modernize build test ## Prepare for commit or release - runs deps, tidy, lint, modernize, build, test
 
 .PHONY: deps
-deps:
+deps: ## Update all dependencies
 	@go get -u -t tool ./...
 
 .PHONY: lint
-lint:
+lint: ## Run linter (golangci-lint)
 	@golangci-lint run -v
 
 .PHONY: modernize
-modernize:
+modernize: ## Run go modernize utility
 	@go run golang.org/x/tools/gopls/internal/analysis/modernize/cmd/modernize@latest -test ./...
 
 .PHONY: vet
-vet:
+vet: ## Run go vet
 	@go vet ./...
 
 .PHONY: tidy
-tidy:
+tidy: ## Tidy go modules
 	@go mod tidy
 
 .PHONY: build
+build: ## Build all binaries (cli, progress-runner, gotestsum, test2json)
 
 cli_bin := bin/cli$(EXT)
 build: $(cli_bin)
@@ -76,24 +82,23 @@ $(test2json_bin):
 	@go build -o $@ -ldflags="-s -w" cmd/test2json
 
 .PHONY: test
-test:
+test: ## Run all tests
 	@go tool gotestsum ./... -test.count=1
 
 .PHONY: clean
-clean:
+clean: ## Clean build artifacts and test results
 	@rm -rf bin
 	@rm -rf dist
 	@rm -rf _test_results
 
-
 .PHONY: download
-download:
+download: ## Download go modules
 	@go mod download
 
 .PHONY: release
-release:
+release: ## Create a release using goreleaser
 	@go tool goreleaser $(GORELEASER_ARGS)
 
 .PHONY: snapshot
-snapshot: GORELEASER_ARGS= --clean --snapshot
+snapshot: GORELEASER_ARGS= --clean --snapshot ## Create a snapshot release using goreleaser
 snapshot: release