Official AI agent coding guidelines and tooling templates for Go projects under github.com/gosuda.
| File | Purpose |
|---|---|
AGENTS.md |
AI agent coding guidelines (Go 1.25+) |
CLAUDE.md |
Symlink → AGENTS.md (Claude Code compatibility) |
.golangci.yml |
golangci-lint v2 config — 41 linters across 4 tiers |
Makefile |
Build, lint, test, vuln scan targets |
.github/workflows/ci.yml |
GitHub Actions: test → lint → security → build |
-
Copy config files into your Go project root:
# From a clone of this repo cp .golangci.yml Makefile /path/to/your/project/ cp -r .github /path/to/your/project/ -
Copy agent guidelines (for AI-assisted development):
cp AGENTS.md /path/to/your/project/ ln -s AGENTS.md /path/to/your/project/CLAUDE.md
-
Verify setup:
cd /path/to/your/project make all
This repo is designed as a template repository. Click "Use this template" on GitHub to create a new project with all configs pre-applied.
| Tool | Install |
|---|---|
| Go 1.25+ | go.dev/dl |
| golangci-lint v2 | go install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@latest |
| govulncheck | go install golang.org/x/vuln/cmd/govulncheck@latest |
| goimports | go install golang.org/x/tools/cmd/goimports@latest |
test (race + coverage) ─┐
lint (golangci-lint v2) ─┼─→ build
security (govulncheck) ─┘
All three jobs run in parallel; build depends on all passing.
- Tier 1 — Correctness (14): govet, errcheck, staticcheck, unused, gosec, errorlint, nilerr, copyloopvar, bodyclose, sqlclosecheck, rowserrcheck, durationcheck, makezero, noctx
- Tier 2 — Quality (16): gocritic (all tags), revive, unconvert, unparam, wastedassign, misspell, whitespace, godot, goconst, dupword, usestdlibvars, testifylint, testableexamples, tparallel, usetesting
- Tier 3 — Concurrency (3): gochecknoglobals, gochecknoinits, containedctx
- Tier 4 — Performance (9): prealloc, intrange, modernize, fatcontext, perfsprint, reassign, spancheck, mirror, recvcheck
Internal tooling for gosuda projects.