golang-design-guide

Core Golang library design patterns include Functional Options, Builder, Interface Segregation, and Fluent API. These patterns enforce maintainable, scalable packages by standardizing architecture, error handling, and two-phase construction across Go modules.

Document Go library architecture using DESIGN.md and CLAUDE.md templates to standardize design philosophy, API patterns, and testing strategies. This guide provides structured templates for documenting Go modules with consistent architectural conventions.

Functional Options and Builder patterns in Go serve distinct API design needs. This guide differentiates applying both patterns alongside Interface Segregation and Fluent API to structure scalable Go libraries, ensuring flexible and maintainable module construction.

This Go design guide supports Go 1.20 through 1.26 features for infrastructural packages, framework-agnostic modules, and core Go libraries. It applies standardized design patterns, error handling, and testing strategies across these specific Go versions.

Implement two-phase construction and error handling strategies for Go modules by following structured design patterns. This guide enforces these practices alongside KISS, DRY, and YAGNI principles to ensure scalable, maintainable Go library architecture.