# The Go AGENTS.md (free sample)

> One of the twelve files from the stack-specific pack: an AGENTS.md for a Go repo with real commands, Go rules, the go.sum trap, ask-before and never lists, and an approvals rule.

- URL: https://paperchasewebb.ai/bots/marketplace/items/go-agents-md-free-sample/
- Type: Prompt pack
- Category: Vibe coding
- By: PaperChaseWebb
- Works with: Claude Code, Codex, Cursor (named in the listing); Plain .md; no install needed
- Price: Free USD
- Difficulty: Beginner
- Setup time: 5 min
- Time to result: About five minutes
- Format: Markdown (.md) file, go-agents-md-free-sample.md
- Version: 1.0, updated 2026-10-30
- License: Personal and commercial use.

## What you end up with

A working piece of the full pack you can use today.

## What you get

- The Go AGENTS.md
- What the full pack adds

## Who it is for

Developers whose stack is not covered by the Next.js, FastAPI and browser game files in the starter rules pack, who want one AGENTS.md per repo that names the right commands.

## Tools needed

- Claude Code, Codex or Cursor: reads AGENTS.md (Claude Code through the CLAUDE.md import)
- You need: Any of Claude Code, Codex or Cursor

Cost to run: Free.

## Sample prompt: Fill the file (Claude Code, Codex or Cursor)

```
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.

## Free preview of go-agents-md-free-sample.md

````markdown
# 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

##
````

## Test record

- Date: Oct 30, 2026
- What was run: Every command in the Go file run on a made-up Go module on 2026-10-30.
- Result: See the sample's caveat.
- Not run: The file inside an agent.

Copied from this item's dated test notes. What was not run stays in.

## Worth knowing

- On 2026-10-30: Every command in the Go file run on a made-up Go module on 2026-10-30. Not run: The file inside an agent.

## Questions

**What is in the full pack?** Ready AGENTS.md files for Go, Rust, Chrome extensions, Electron, Tauri 2, Expo, SvelteKit, Astro, Django, Rails, Laravel and Flutter, each with real commands, stack rules and the one file agents most often break, a one-line CLAUDE.md pointer, five prompts and stack_check.py, ten read-only checks that the file fits the repo it sits in. $24.

## How to get it

Free sample. Download it directly at https://paperchasewebb.ai/bots/marketplace/items/go-agents-md-free-sample/, no signup.

Seller: PaperChaseWebb Inc., mgmt@paperchasewebb.com