gosmith

gosmith

A Claude Code plugin providing specialized agents and skills for Go development, infrastructure, and workflow automation.

Installation

Add the marketplace and install the plugin:

/plugin marketplace add otaviof/gosmith
/plugin # Search and install "gosmith"

As well, non-interactively with the command line:

claude plugin marketplace add otaviof/gosmith
claude plugin install gosmith

Local Development

Test the plugin locally without installing:

claude --plugin-dir ${PWD}

Permissions

Claude Code agents cannot declare their own tool permissions (#10093). Configure permissions in your project's .claude/settings.local.json so agents can run read-only and build commands without repeated approval prompts.

Recommended settings for Go projects:

{
  "permissions": {
    "allow": [
      "Bash(cat:*)",
      "Bash(find:*)",
      "Bash(head:*)",
      "Bash(ls:*)",
      "Bash(make:*)",
      "Bash(pwd)",
      "Bash(tail:*)",
      "Bash(tree:*)",
      "Bash(wc:*)",
      "Bash(which:*)",
      "Bash(go:*)",
      "Bash(golangci-lint:*)",
      "Bash(git branch:*)",
      "Bash(git diff:*)",
      "Bash(git log:*)",
      "Bash(git merge-base:*)",
      "Bash(git rev-parse:*)",
      "Bash(git show:*)",
      "Bash(git status:*)"
    ]
  }
}

Extend with additional patterns as needed (e.g., Bash(kubectl:*), Bash(oc:*), Bash(gh:*)). Any unmatched Bash command will prompt for approval.

Important: A catch-all "ask": ["Bash"] in global settings (~/.claude/settings.json) will intercept all Bash commands before project-level allow rules are evaluated. Remove it if you use project-level allow patterns.

What's Included

Type	Count	Examples
Agents	11	go-architect, go-developer, tekton-expert, gha-expert
Skills	7	/go-check, /go-cover, /ginkgo, /jira, /make

Go Development Workflow

flowchart LR
    go-architect["go-architect<br/>Design"]
    go-developer["go-developer<br/>Implement"]
    go-tester["go-tester<br/>Test"]
    go-reviewer["go-reviewer<br/>Review"]
    go-code["/go-code<br/>Standards"]

    go-architect -->|PLAN.md| go-developer
    go-developer -->|Code| go-tester
    go-tester -->|Tests Pass| go-reviewer
    go-reviewer -->|Approved| Merge([Merge])

    go-developer -.->|invoke| go-code
    go-reviewer -.->|invoke| go-code

Quick Start

After installing the plugin, agents and skills are available in Claude Code.

Using Agents

Invoke agents with @agent-name or the fully qualified @gosmith:agent-name:

# Design a new feature
@gosmith:go-architect Design a caching layer with Redis backend

# Implement the plan
@gosmith:go-developer Implement caching layer per PLAN.md

# Write tests
@gosmith:go-tester Write tests for caching layer, target 80% coverage

# Review before merge
@gosmith:go-reviewer Review caching implementation for security and correctness

Using Skills

Invoke skills with /skill-name or /gosmith:skill-name:

# Run Go verification pipeline
/gosmith:go-check

# Generate coverage report
/gosmith:go-cover ./...

# Fetch Jira ticket as markdown
/gosmith:jira PROJ-1234

# Run Makefile target
/gosmith:make test

List Available Components

# List all agents from this plugin
claude agents | grep gosmith

# List all skills from this plugin
claude skills | grep gosmith

Agents

Go Development

Agent	Purpose
go-architect	Creates PLAN.md blueprints with interfaces, data models, and steps. Invoke first for design decisions.
go-developer	Implements production Go code from plans or handles simple tasks directly.
go-tester	Writes adversarial tests, fuzz tests, and benchmarks. Validates against PLAN.md contracts.
go-reviewer	Reviews PRs for correctness, security, and plan compliance. Invoke before merging.

Infrastructure & CI/CD