Add make agent-finished task for pre-completion verification (#48)

Author: Copilot

AGENTS.md

@@ -11,6 +11,7 @@ Quick reference for AI agents working with MCP Gateway (Go-based MCP proxy serve
 **Coverage**: `make coverage` (tests with coverage report)  
 **Format**: `make format` (auto-format code with gofmt)  
 **Clean**: `make clean` (remove build artifacts)  
+**Agent-Finished**: `make agent-finished` (run format, build, lint, test - ALWAYS run before completion)  
 **Run**: `./awmg --config config.toml`
 
 ## Project Structure
@@ -63,6 +64,34 @@ args = ["run", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "-i", "ghcr.io/gith
 **Add Guard**: Implement in `internal/guard/` and register  
 **Add Test**: Create `*_test.go` with Go testing package
 
+## Agent Completion Checklist
+
+**CRITICAL: Before returning to the user, ALWAYS run `make agent-finished`**
+
+This command runs the complete verification pipeline:
+1. **Format** - Auto-formats all Go code with gofmt
+2. **Build** - Ensures the project compiles successfully
+3. **Lint** - Runs go vet and gofmt checks
+4. **Test** - Executes the full test suite
+
+**Requirements:**
+- **ALL failures must be fixed** before completion
+- If `make agent-finished` fails at any stage, debug and fix the issue
+- Re-run `make agent-finished` after fixes to verify success
+- Only report completion to the user after seeing "✓ All agent-finished checks passed!"
+
+**Example workflow:**
+```bash
+# Make your code changes
+# ...
+
+# Run verification before completion
+make agent-finished
+
+# If any step fails, fix the issues and run again
+# Only complete the task after all checks pass
+```
+
 ## Debug Logging
 
 **ALWAYS use the logger package for debug logging:**

Makefile

@@ -1,4 +1,4 @@
-.PHONY: build lint test coverage test-ci format clean install release help
+.PHONY: build lint test coverage test-ci format clean install release help agent-finished
 
 # Default target
 .DEFAULT_GOAL := help
@@ -29,6 +29,20 @@ test:
 	@echo "Running tests..."
 	@go test -v ./...
 
+# Run format, build, lint, and test (for agents before completion)
+agent-finished:
+	@echo "Running agent-finished checks..."
+	@echo ""
+	@$(MAKE) format
+	@echo ""
+	@$(MAKE) build
+	@echo ""
+	@$(MAKE) lint
+	@echo ""
+	@$(MAKE) test
+	@echo ""
+	@echo "✓ All agent-finished checks passed!"
+
 # Run tests with coverage
 coverage:
 	@echo "Running tests with coverage..."
@@ -168,13 +182,14 @@ install:
 # Display help information
 help:
 	@echo "Available targets:"
-	@echo "  build      - Build the CLI binary"
-	@echo "  lint       - Run all linters (go vet, gofmt check)"
-	@echo "  test       - Run all tests"
-	@echo "  coverage   - Run tests with coverage report"
-	@echo "  test-ci    - Run tests with coverage and JSON output for CI"
-	@echo "  format     - Format Go code using gofmt"
-	@echo "  clean      - Clean build artifacts"
-	@echo "  install    - Install required toolchains and dependencies"
-	@echo "  release    - Create and push a release tag (usage: make release patch|minor|major)"
-	@echo "  help       - Display this help message"
+	@echo "  build           - Build the CLI binary"
+	@echo "  lint            - Run all linters (go vet, gofmt check)"
+	@echo "  test            - Run all tests"
+	@echo "  coverage        - Run tests with coverage report"
+	@echo "  test-ci         - Run tests with coverage and JSON output for CI"
+	@echo "  format          - Format Go code using gofmt"
+	@echo "  clean           - Clean build artifacts"
+	@echo "  install         - Install required toolchains and dependencies"
+	@echo "  release         - Create and push a release tag (usage: make release patch|minor|major)"
+	@echo "  agent-finished  - Run format, build, lint, and test (for agents before completion)"
+	@echo "  help            - Display this help message"