# go-skills

> A Go knowledge base — architectural patterns and a service-building methodology — packaged as Claude Code skills, exposed via a static site, and (soon) an MCP server. Source: methodology + 52 pattern skills (theory + runnable examples in some cases).

Author: Yevgeniy Achin <amazopic@gmail.com>
License: MIT
Version: 1.1.0
Languages: 23 (en, ru, fr, de, uk, sl, it, es, zh, ja, ko, ar, pt-BR, tr, id, vi, hi, zh-TW, pl, th, he, bn, ur)

## Documentation

- [README](README.md): overview, install, link to site.
- [CHANGELOG](CHANGELOG.md): release history + versioning policy (SemVer).
- [PATTERNS.md](PATTERNS.md): full catalog of 52 patterns across 10 categories.
- [METHODOLOGY.md](METHODOLOGY.md): index of 13 chapter-skills + canonical full doc.
- [LICENSE](LICENSE): MIT.

## Skills (Claude Code)

- [skills/README.md](skills/README.md): how to install as Claude Code skills.
- [skills/workflow/project-assessment.md](skills/workflow/project-assessment.md): START HERE on an existing project — read-only team assessment (5 roles) → maturity report → reverse analysis → prioritized roadmap where every item cites the go-skill to apply → hand off to the build/security flows.
- [skills/workflow/feature-development.md](skills/workflow/feature-development.md): team-based feature/task flow — three roles analyze independently → senior consolidates → reverse review → user approval gate → same trio implements.
- [skills/workflow/security-review.md](skills/workflow/security-review.md): team-based security code review — four roles (senior Go, strong-middle Go, DB architect, senior SecOps) audit independently → senior Go consolidates → reverse analysis (cull false positives, find attack chains) → approval gate → same team remediates.
- [skills/methodology/00-canonical-full.md](skills/methodology/00-canonical-full.md): full Go service architecture doc.
- [skills/methodology/01..13-*.md](skills/methodology/): 13 chapter-grouped methodology skills.
- [skills/<category>/*.md](skills/): per-pattern skills across creational, structural, behavioral, concurrency, synchronization, messaging, stability, profiling, idiom, anti-patterns.

## Workflows

- [workflows/project-assessment.mjs](workflows/project-assessment.mjs): runnable orchestration of the Project Assessment skill. `mode: "assess"` produces a maturity report + prioritized roadmap for approval (read-only); `mode: "amend"` re-vets an edited roadmap. Execution is handed off to the other two flows.
- [workflows/feature-development.mjs](workflows/feature-development.mjs): runnable orchestration of the Feature Development Flow skill. `mode: "plan"` produces a vetted plan for approval; `mode: "implement"` builds the approved plan with the same trio.
- [workflows/security-review.mjs](workflows/security-review.mjs): runnable orchestration of the Security Code Review skill. `mode: "review"` produces a prioritized remediation plan for approval; `mode: "remediate"` fixes the approved findings with the same team.

## Examples

- [examples/](examples/): 52 runnable Go pattern packages with race-safe `_test.go`. One shared module: `github.com/amazopic/go-skills/examples` (Go 1.22+). Run: `cd examples && go test -race ./...`.

## Site

- [docs/index.html](docs/index.html): GitHub Pages site (Linear design system).
- [docs/llms-full.txt](docs/llms-full.txt): full corpus mirror.

## Future

- [mcp/README.md](mcp/README.md): roadmap for the MCP server (no implementation in v1).
- [commands/README.md](commands/README.md): roadmap for slash-command integration.