golang-architect

Design Go project architectures with module boundaries and dependency direction.

2|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/Tomlord1122/tomtom-skill --skill golang-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: golang-architect
Source: https://github.com/Tomlord1122/tomtom-skill/tree/main/skills/golang-architect
Command: npx skills add https://github.com/Tomlord1122/tomtom-skill --skill golang-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires sqlc, and includes scripts (resource) components.

What problem does it solve?

Golang-Architect provides a structured framework to design Go project architectures, helping teams reason about trade-offs and select appropriate patterns before coding.

Core Features & Use Cases

  • Architecture guidance and trade-off analysis for Go projects across domains (backend services, CLIs, libraries, and infrastructure tooling).
  • Clear guidance on module design, package boundaries, internal boundaries, and public APIs to improve maintainability and testability.
  • Scenarios coverage including small prototypes, production services, and distributed systems, with guidance on evolution over time.

Quick Start

Provide an architecture blueprint for a new Go service.

Frequently Asked Questions about golang-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a scalable Go project architecture for a backend service?

Design Go project architecture by selecting appropriate patterns and establishing clear module boundaries. This framework guides dependency direction and testability through dependency injection, helping teams reason about trade-offs and structure scalable backend services before coding.

What is the best way to structure module boundaries and public APIs in Go projects?

Structure module boundaries and public APIs in Go projects by defining internal boundaries and package limits. This approach improves maintainability and testability, ensuring clear separation of concerns across backend services, CLI tools, and libraries.

Does this Go architecture guidance work for CLI tools and infrastructure tooling?

Yes, this Go architecture guidance applies to CLI tools and infrastructure tooling. It covers diverse scenarios from small prototypes to production services, providing module design and trade-off analysis tailored to your specific application type.

How do I use dependency injection to improve testability in my Go architecture?

Use dependency injection in your Go architecture to establish clear dependency direction and improve testability. This framework provides structural guidance for implementing DI patterns, ensuring that module boundaries remain clean and mockable for testing.

Can I get an architecture blueprint for a new Go service from this framework?

Yes, you can generate an architecture blueprint for a new Go service. The framework analyzes requirements like error handling and scalable structure, then outputs a tailored architectural design to guide your implementation.

When should I not use complex architectural patterns in my Go projects?

Avoid complex architectural patterns in Go projects when building small prototypes. This framework provides trade-off analysis to help you recognize when simpler module designs are more appropriate than heavily structured dependency injection or rigid internal boundaries.