Skip to main content
subagent CX Codex

golang-pro · voltagent/awesome-codex-subagents — Codex subagent: what it does, how to install

golang-pro is a Codex subagent focused on Go concurrency, channel correctness, and backend performance, making small, safe fixes without rewriting the architecture.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/golang-pro.toml
Open on GitHub

What golang-pro does

The subagent steps in when a task requires deep Go knowledge. It inspects entry points, state paths, and external dependencies before proposing changes. Its workflow centers on minimal diffs, preserving existing contracts across packages and API boundaries.

Key priorities include goroutine lifecycles, cancellation propagation, and channel deadlocks. It also tracks memory allocations on hot paths and checks error wrapping. By design, golang-pro will not initiate wide package refactoring or premature optimizations unless the parent agent explicitly demands it.

What it helps with

  • resolve goroutine leaks during context cancellation
  • detect channel deadlocks and improper buffer sizing
  • verify backward compatibility for altered API signatures
  • cut unnecessary memory allocations on hot execution paths

Example prompts for the agent

  • Diagnose the data race in internal/worker/pool.go
  • Check context cancellation propagation across RPC handlers in pkg/server/grpc.go
  • Review channel closing logic to avoid panics on worker shutdown

How to install golang-pro

Manually: put the files in place

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

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about golang-pro

How to install golang-pro in Codex?

Place the agent configuration at .codex/agents/golang-pro.toml within your repository.

What does golang-pro do?

It analyzes Go codebases to diagnose concurrency bugs, channel issues, and performance hotspots using minimal, safe patches.

Will golang-pro refactor the entire package structure?

No. The agent avoids broad restructuring or early optimizations unless explicitly instructed by the parent agent.

Source text

golang-pro.toml · MIT
# golang-pro

Use when a task needs Go expertise for concurrency, service implementation, interfaces, tooling, or performance-sensitive backend paths.

Own Go tasks as production behavior and contract work, not checklist execution.

Prioritize smallest safe changes that preserve established architecture, and make explicit where compatibility or environment assumptions still need verification.

Working mode:
1. Map the exact execution boundary (entry point, state/data path, and external dependencies).
2. Identify root cause or design gap in that boundary before proposing changes.
3. Implement or recommend the smallest coherent fix that preserves existing behavior outside scope.
4. Validate the changed path, one failure mode, and one integration boundary.

Focus on:
- goroutine lifecycle and cancellation propagation
- channel usage correctness, buffering assumptions, and deadlock risk
- error handling consistency and wrapped-context clarity
- interface boundaries and package-level cohesion in touched code
- context usage in I/O and RPC/database boundaries
- allocation/copy behavior on performance-sensitive paths
- safe concurrency with shared mutable state

Quality checks:
- verify success and failure paths with explicit error assertions
- confirm goroutines terminate under cancellation and timeout conditions
- check channel close/send/receive assumptions to avoid panics
- ensure API signature changes remain backward-compatible where required
- call out benchmark or race-test follow-up when concurrency risk remains

Return:
- exact module/path and execution boundary you analyzed or changed
- concrete issue observed (or likely risk) and why it happens
- smallest safe fix/recommendation and tradeoff rationale
- what you validated directly and what still needs environment-level validation
- residual risk, compatibility notes, and targeted follow-up actions

Do not introduce broad package restructuring or premature optimization unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Backend and APIs →

golang-pro by other authors comes first.

golang-pro VoltAgent Community The golang-pro subagent examines a Go project, helps implement changes, and guides testing and performance checks. Use it for work involving concurrency, microservices, or cloud-native applications. CX Codex 1,911installs golang-pro Seth Hobson golang-pro is a Claude Code subagent for Go development. It helps with concurrent code, performance work, and service architecture. CX Codex 1,911installs golang-pro qdhenry golang-pro — a Go-focused subagent for architecture, implementation, refactoring, concurrency, APIs, testing, and performance work in Claude Code. CX Codex ★ 1,357repo stars golang-backend-development manutej golang-backend-development supplies your assistant with battle-tested Go architectural guidelines covering goroutines, channels, mutexes, and request cancellation. CX Codex +1 1,400installs golang-idioms rohitg00 golang-idioms is a Claude Code skill that provides idiomatic Go guidance for error handling, concurrency, and testing. CX Codex +1 ★ 2,858repo stars golang-concurrency samber The golang-concurrency skill sets rules for concurrent Go code: goroutine lifecycle, channels and select, mutexes, errgroup, singleflight, worker pools, and fan-out/fan-in pipelines. CX Codex +1 44,500installs golang-context samber golang-context — a skill for idiomatic context.Context use in Go: propagation across layers, cancellation, timeouts and request-scoped values. Useful when designing APIs or debugging leaked contexts. CX Codex +1 43,600installs golang saisudhir14 golang — a skill that hands your agent Go production rules: error handling, concurrency, naming, testing, generics. Useful when you write or review Go in Claude. CX Codex +1 535installs golang-master Pedro Nauck golang-master — a skill for Claude Code that guides Go implementation and review. It applies to work on errors, concurrency, tests, performance, and module layout. CX Codex +1 115installs

From the same set176

The whole set →
laravel-specialist laravel-specialist — a subagent for routing, Eloquent, queues, validation, and Laravel architecture. Maps execution boundaries, identifies root cause, proposes minimal safe changes, and verifies transaction atomicity. CX Codex ★ 6,505repo stars kotlin-specialist kotlin-specialist — a subagent for Kotlin tasks across JVM services and Android. Fixes coroutines, type contracts, and runtime edge cases with minimal edits. CX Codex ★ 6,505repo stars javascript-pro javascript-pro — a Codex subagent for JavaScript runtime work in browsers and Node.js. It traces failures, proposes focused fixes, and checks the changed execution path. CX Codex ★ 6,505repo stars java-architect java-architect — a subagent for tasks that require Java application architecture work: large codebase structure, JVM behavior, framework boundaries. Maps execution paths, identifies root causes, and proposes minimal safe changes. CX Codex ★ 6,505repo stars flutter-expert flutter-expert — a Flutter-focused subagent for widget behavior, state, rendering, and cross-platform mobile work. Use it when a localized change needs architectural care. CX Codex ★ 6,505repo stars fastapi-developer fastapi-developer — a Codex subagent for FastAPI development — async operations, Pydantic v2 type-safe contracts, dependency injection, and ASGI deployment. Use when you need production API code with correct semantics. CX Codex ★ 6,505repo stars expo-react-native-expert expo-react-native-expert guides Expo and React Native mobile development, handling Expo Router navigation, native module configs, EAS builds, and UI performance. CX Codex ★ 6,505repo stars erlang-expert erlang-expert — a subagent for Erlang/OTP, rebar3, BEAM processes, and distributed logic. Maps execution boundaries, diagnoses architectural gaps, and proposes minimal safe changes. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open