Is a Makefile required for this structure?

Yes, this skill enforces a mandatory Makefile for build automation, testing, and dependency management to ensure a consistent developer experience across all Go projects.

Is this suitable for small CLI tools?

Absolutely. While it supports complex layouts, the skill also provides a 'Flat Structure' option specifically designed for simple utilities, CLIs, and small-scale tools.

Does this skill support Hexagonal Architecture?

Yes, it includes specific directory patterns and implementation guidance for Hexagonal/Clean Architecture, focusing on the separation of domain logic, ports, and adapters.

How does this skill handle build outputs?

It requires all binaries to be built into a dedicated /bin/ directory which is automatically gitignored, keeping the project root clean and preventing accidental commits of compiled code.

Where should I put private application code in Go?

Private code should be placed in the /internal directory. This is a Go-specific convention that prevents external projects from importing those packages, ensuring better encapsulation.

Go Project Structure & Layout

Name: Go Project Structure & Layout
Author: IvanTorresEdge

byIvanTorresEdge

開発者ツール

Standardizes Go project architectures and build workflows using community-accepted patterns and automated tooling.

概要

This skill provides a comprehensive framework for organizing Go codebases, ensuring consistency across projects through standardized directory layouts, mandatory Makefile build systems, and strict architectural boundaries. It supports multiple patterns—including the standard golang-standards layout, Hexagonal/Clean architecture, and simplified flat structures—while enforcing best practices for dependency management, binary distribution, and environment configuration to streamline development and maintenance.

主な機能

Automates internal/ and pkg/ directory scoping for better modularity
0 GitHub stars
Supports Standard, Hexagonal, and Flat architecture patterns
Implements golang-standards/project-layout conventions
Provides pre-configured .gitignore and README templates
Enforces mandatory Makefile-based build automation

ユースケース

Bootstrapping a new Go microservice with a production-ready structure
Refactoring a monolithic Go codebase into a maintainable modular architecture
Standardizing build processes and binary management across a development team

概要

主な機能

Automates internal/ and pkg/ directory scoping for better modularity
0 GitHub stars
Supports Standard, Hexagonal, and Flat architecture patterns
Implements golang-standards/project-layout conventions
Provides pre-configured .gitignore and README templates
Enforces mandatory Makefile-based build automation

ユースケース

Bootstrapping a new Go microservice with a production-ready structure
Refactoring a monolithic Go codebase into a maintainable modular architecture
Standardizing build processes and binary management across a development team