Go Template

A minimal, batteries-included Go template for new projects. Skip the boilerplate — start from a clean, idiomatic scaffold with linting, CI/CD, releases, and agent tooling already wired up.

✨ What's included

• Idiomatic scaffold — a no-op main.go plus the conventional cmd/, internal/, and pkg/ layout, ready for your first package. A minimal pkg/example package with a table-driven test shows the house testing pattern — replace it with your own.
• Linting & formatting — golangci-lint v2 (formatters + default: all linters) in CI, with MegaLinter covering everything else. A pre-commit hook runs golangci-lint formatting (and mockery mock generation) locally on commit.
• CI/CD — a required-checks workflow on pull requests and the merge queue, plus a GoReleaser release pipeline (cd.yaml) triggered on v* tags.
• Coverage — go test coverage reported via GitHub Code Quality.
• Dependency management — Dependabot keeps Go modules and pinned GitHub Actions current (daily).
• Agent-ready — AGENTS.md conventions and a .claude/skills/maintain card so the autonomous Daily AI Assistant (and any agentic tool) can maintain the repo.

The minimum Go version is declared in go.mod — the single source of truth.

🚀 Use this template

Create a new repository from the template with the GitHub CLI:

gh repo create my-project --template devantler-tech/go-template --public --clone
cd my-project

Or click Use this template on the repository page.

Then personalise the scaffold — repoint the module path (in go.mod, the Go imports, and the README badges) in one shot:

scripts/rename-placeholders.sh github.com/<you>/my-project

Run with no argument to derive the path from your origin GitHub remote. The script leaves the upstream Use this template links above untouched, runs go mod tidy, and you can review the result with git diff. (Prefer to do it by hand? go mod edit -module github.com/<you>/my-project && go mod tidy.)

📝 Usage

Add a dependency

go get example.com/awesome-lib@latest

Build your project

go build ./...

Run your project

go run .

Test your project

go test ./...

🤖 Maintenance

This template is maintained by an autonomous AI assistant. The conventions, validation commands, and contribution workflow live in AGENTS.md.