From 307ca483941b3167e0cbf56c61384046621f53e0 Mon Sep 17 00:00:00 2001
From: Bryan Frimin <bryan@getprobo.com>
Date: Fri, 13 Mar 2026 17:20:24 +0100
Subject: [PATCH] Update LLM dev instructions

Signed-off-by: Bryan Frimin <bryan@getprobo.com>
---
 AGENTS.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 37dc988f3..2f900135b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,5 +1,28 @@
 # AGENTS.md
 
+## Build & Development
+
+| Command | Purpose |
+|---|---|
+| `make build` | Build `bin/probod` (includes frontend apps and codegen) |
+| `SKIP_APPS=1 make build` | Build `bin/probod` without frontend apps (faster for backend-only work) |
+| `make test` | Run tests with race detection and coverage |
+| `make test MODULE=./pkg/foo` | Run tests for a single module |
+| `make test-verbose` | Tests with verbose output |
+| `make lint` | Vet + Go lint + npm lint |
+| `make fmt` | Format Go code |
+| `make dev` | Start dev server (Go + console hot-reload) |
+| `make test-e2e` | Run console end-to-end tests (requires `bin/probod`) |
+| `make deadcode` | Detect dead code — run after removing or renaming exported functions |
+| `make stack-up` / `make stack-down` | Start / stop Docker compose infra |
+| `make psql` | Open psql shell to dev database |
+
+GraphQL and MCP codegen is triggered by `go generate`:
+- `go generate ./pkg/server/api/console/v1`
+- `go generate ./pkg/server/api/connect/v1`
+- `go generate ./pkg/server/api/trust/v1`
+- `go generate ./pkg/server/api/mcp/v1`
+
 ## Project
 
 - Module: `go.probo.inc/probo`