# golang-pro

golang-pro — a Go-focused subagent for architecture, implementation, refactoring, concurrency, APIs, testing, and performance work in Claude Code.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/development/golang-pro.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/qdhenry-golang-pro

## What it does

\`golang-pro` works on Go applications from system design through code changes. It can shape microservice and distributed-system boundaries, review gRPC or REST APIs, refine interfaces, and improve error handling. Its concurrency focus includes goroutines, channels, worker pools, fan-in/fan-out, cancellation with `context`, and race detection.

The agent can read and edit files, search a repository, run shell commands, and use `WebFetch`, `WebSearch`, `context7`, and `sequential-thinking`. Its workflow covers table-driven tests, benchmarks, `pprof`, module files such as `go.mod` and `go.sum`, and formatting with `goimports`. The configured model is `sonnet`, which is part of the agent setup.

Place the agent file at `.claude/agents/golang-pro.md` to use it in Claude Code.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/golang-pro.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/golang-pro.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/golang-pro.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/development/golang-pro.md

## When to use it
- design Go microservice boundaries
- trace races in concurrent code
- review wrapped error handling
- profile CPU and memory with `pprof`
- build table-driven tests and benchmarks

## Example prompts
- Design a Go service API with clear boundaries between its components.
- Review this concurrent code for races, goroutine leaks, and cancellation problems.
- Refactor the error flow and add table-driven tests with a benchmark.

## Similar
- [golang-master](https://affpapa.org/en/nevibecode/skills/golang-master.md) — skill · 115 installs
- [golang-idioms](https://affpapa.org/en/nevibecode/skills/golang-idioms.md) — skill · ★ 2858 repo stars
- [golang](https://affpapa.org/en/nevibecode/skills/golang.md) — skill · 535 installs
- [golang-context](https://affpapa.org/en/nevibecode/skills/golang-context.md) — skill · 43600 installs
- [golang-backend-development](https://affpapa.org/en/nevibecode/skills/golang-backend-development.md) — skill · 1400 installs
- [golang-concurrency-patterns](https://affpapa.org/en/nevibecode/skills/golang-concurrency-patterns.md) — skill · 427 installs

## Other versions with the same name
- [golang-pro · voltagent](https://affpapa.org/en/nevibecode/agents/voltagent-community-golang-pro.md) — 1911 installs
- [golang-pro · wshobson](https://affpapa.org/en/nevibecode/agents/golang-pro.md) — 1911 installs
- [golang-pro · voltagent](https://affpapa.org/en/nevibecode/agents/voltagent-golang-pro.md) — ★ 6505 repo stars

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
