Claude's training data has a cutoff (currently May 2025). That means it doesn't know about Go 1.25 (Aug 2025) or Go 1.26 (Feb 2026) at all, and its knowledge of Go 1.24 (Feb 2025) can be fuzzy. Without corrections, Claude will:

• Suggest outdated patterns when modern replacements exist (errors.As instead of errors.AsType[T], manual WaitGroup instead of wg.Go)
• Miss important language changes (new(expr), self-referential generics)
• Use insecure defaults it learned from older code (weak crypto, math/rand for tokens, string-interpolated SQL)
• Not know about the new Green Tea GC, container-aware GOMAXPROCS, post-quantum TLS, or dozens of other stdlib improvements

These documents fix that. Drop them into your Go project and point Claude Code at them so every session starts with accurate, up-to-date knowledge.

# From your Go project root:
mkdir -p docs/go

# Option A: Clone and copy
git clone https://github.com/stuctf/GoDocs.git /tmp/GoDocs
cp /tmp/GoDocs/*.md docs/go/
rm docs/go/README.md  # you don't need this file in your project

# Option B: Download individual files with curl
curl -LO https://raw.githubusercontent.com/stuctf/GoDocs/main/claude-knowledge-corrections.md --output-dir docs/go/
curl -LO https://raw.githubusercontent.com/stuctf/GoDocs/main/GO_BEST_PRACTICES.md --output-dir docs/go/
# ... etc

Add this to your project's CLAUDE.md (create one if you don't have it):

## Go Version Notes
This project uses Go 1.26+.
Read docs/go/claude-knowledge-corrections.md for post-training Go changes
that Claude's base knowledge gets wrong.

## Go Reference Docs
- Read docs/go/GO_BEST_PRACTICES.md for coding standards
- Read docs/go/go1.26-changes.md for latest Go features

Adjust the Go version to match your project.

See GO_IMPROVEMENTS.md for how to set up:

• A gofmt hook that auto-formats after every Claude Code edit
• A /go-check slash command that runs the full pre-commit checklist (vet, build, test, mod tidy)
• CLAUDE.md templates with security and style rules baked in

Claude learned from a massive corpus of Go code, and a lot of that code uses insecure patterns that were common (or at least tolerated) for years. These docs push Claude toward safer defaults:

• crypto/rand over math/rand for tokens, keys, and secrets
• os.Root (Go 1.24+) for filesystem access with user-provided paths — prevents path traversal and symlink escape
• Parameterized SQL queries instead of string interpolation
• omitzero over omitempty where omitempty silently does the wrong thing (e.g., time.Time)
• Post-quantum TLS awareness (enabled by default in Go 1.26)
• crypto/rand.Text (Go 1.24+) for generating random strings — no more hand-rolled token generators
• NewGCMWithRandomNonce (Go 1.24+) — eliminates nonce-reuse bugs in AES-GCM

These docs cover Go 1.24 through Go 1.26. When Go 1.27 ships, new docs will be needed. Contributions welcome.

These documents are provided as-is for use with Claude Code and other AI coding assistants. Use them however you like.