The Go AGENTS.md (free sample)

Read this repo and AGENTS.md. Fill every [placeholder] from the lockfile and folders you can see. Do not change the Commands table unless a command fails; if it does, show me the output.
Run python3 stack_check.py . and fix every finding.

From the pack.

# Stack-specific AGENTS.md: the Go file (free sample)

Version 1.0, 2026-10-30. By PaperChaseWebb. One of the twelve files from the Stack-specific AGENTS.md and CLAUDE.md pack. Copy it to AGENTS.md at the root of a Go repo and fill the [placeholders]. On 2026-10-30 every command in it was run on a made-up Go module (Go toolchain on Linux); it was not loaded into any agent.

````markdown
# AGENTS.md

## Stack
Go project: [one line on what it does]. Versions: [fill from your lockfile or toolchain file].

## Commands
| Task | Command |
|---|---|
| Build | `go build ./...` |
| Test all | `go test ./...` |
| Test one package | `go test ./internal/[pkg]/ -run [TestName]` |
| Vet | `go vet ./...` |
| Format | `gofmt -l .` |
| Tidy modules (ask first) | `go mod tidy` |

## Layout
- [main source folder]: [what lives there]
- [tests folder]: [what lives there]
- Do not touch: [generated or vendored folders]

## Rules for Go
- Never hand-edit go.sum. It changes only through go get or go mod tidy, and both need my yes.
- Return errors with context (fmt.Errorf with %w); do not panic in request handlers.
- Every new exported function gets a doc comment and a table test.
- Pass context.Context as the first argument to anything that does I/O.
- Run gofmt -l . and go vet ./... before saying done; both must print nothing.

## Ask before
- Adding, removing or upgrading any dependency
- Changing build, signing, release or deploy config
- Anything that touches production data or real accounts

##