Go
Go rules for Cursor
Error handling, package layout and testing rules for idiomatic Go.
The rule
Save as .cursor/rules/go.mdc. Cursor picks it up on the next request.
.cursor/rules/go.mdc
---
description: Go conventions
globs: **/*.go
alwaysApply: false
---
- Handle every error; wrap with fmt.Errorf("context: %w", err) when returning it.
- Accept interfaces, return concrete types. Keep interfaces small and defined where they are used.
- Pass context.Context as the first parameter to anything that does I/O.
- Table-driven tests in _test.go files; run go test ./... before finishing.
- Run gofmt and go vet; do not add dependencies without a reason.
How Cursor loads this rule
Read from the frontmatter above, per Cursor's rules documentation.
alwaysApply: falsewithglobs: **/*.go: attached automatically when a matching file is in context.- Keep the
.mdcextension. A plain.mdfile in .cursor/rules is ignored by the rules system. - Prefer to generate your own? Type
/create-rulein Agent and describe what you want; Cursor saves the file to .cursor/rules. - Team Rules come first, then Project Rules like this one, then User Rules. Earlier sources win when guidance conflicts.
Cursor rules setup guideCursor Team RulesLet Cursor run commands without asking
Using another agent too?
The same instructions work as plain Markdown in AGENTS.md, which Codex, Gemini CLI, GitHub Copilot and most other coding agents read.
AGENTS.md (section)
## Go
- Handle every error; wrap with fmt.Errorf("context: %w", err) when returning it.
- Accept interfaces, return concrete types. Keep interfaces small and defined where they are used.
- Pass context.Context as the first parameter to anything that does I/O.
- Table-driven tests in _test.go files; run go test ./... before finishing.
- Run gofmt and go vet; do not add dependencies without a reason.
More templates
Get Cursor rules and settings changes by email
When Cursor changes how rules, run modes or settings work, we update these templates from the docs and send a short note. One email a week at most.
Reviewed Oct 17, 2026. Written by AgentAtlas. Adapt it to your codebase before relying on it.