Menu
Go Project Planning Skill
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/curtbushko/nixos-config --skill go-project-planningThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Comprehensive Nix best practices for flakes, NixOS, home-manager, nix-darwin, devshells, package management, and system configuration. Use this skill when working with Nix flakes, NixOS configuration, home-manager dotfiles, nix-darwin macOS setup, development shells (nix develop/nix-shell), package searching, testing, overlays, or any Nix-related tasks including debugging derivations and garbage collection.
Implements phases defined in .phases/ directory. Reads current phase from index.yaml, breaks down into tasks, then executes Builder -> Reviewer for each task.
Implements phases defined in .phases/ directory for Node.js projects. Reads current phase from index.yaml, breaks down into tasks, then executes Builder -> Reviewer for each task.
Based on SOC occupation classification
| name | go-project-planning |
| description | Go Project Planning Skill |
This skill provides architectural patterns and planning guidance for Go projects. Use it when:
NOTE: This skill references the shared Go patterns in ~/.claude/skills/golang/references/. All detailed patterns, code examples, and guidelines are maintained there as the single source of truth.
| Pattern | Reference |
|---|---|
| Hexagonal Architecture | golang/references/architecture.md |
| BDD/Gherkin Specifications | golang/references/bdd-gherkin.md |
| TDD Workflow | golang/references/tdd-workflow.md |
| Protobuf Guidelines | golang/references/protobuf.md |
| Go Code Patterns | golang/references/code-patterns.md |
| Go Cloud SDK | golang/references/go-cloud-sdk.md |
| AI Code Problems | golang/references/ai-code-problems.md |
project/
โโโ cmd/ # Composition root
โ โโโ myapp/
โ โโโ main.go # Entry point
โ โโโ root.go # Cobra root command
โโโ internal/
โ โโโ domain/ # INNER: Pure business logic
โ โโโ ports/ # INNER: Interface contracts
โ โโโ application/ # APPLICATION: Use cases
โ โโโ adapters/ # OUTER: Infrastructure
โโโ api/ # API definitions (proto, OpenAPI)
โโโ .go-arch-lint.yml # Architecture enforcement
โโโ .golangci.yml # Linting rules
โโโ Taskfile.yml # Build targets (required)
โโโ go.mod
Before completing any task:
task build # REQUIRED - must pass
task test # REQUIRED - must pass
task lint # REQUIRED - must pass
go-arch-lint check # if .go-arch-lint.yml exists
IMPORTANT:
.golangci.yml, .go-arch-lint.yml, .go-ai-lint.yml)//nolint: directives - there are no exceptionsFollow Go Cloud SDK patterns for cloud-agnostic components. See go-cloud-sdk.md.
// URL-based construction - provider determined by configuration
bucket, _ := blob.OpenBucket(ctx, os.Getenv("BUCKET_URL"))
// "s3://my-bucket" -> AWS S3
// "gs://my-bucket" -> Google Cloud Storage
// "file:///tmp/bucket" -> Local filesystem