go-architecture-review

What problem does it solve?

This Skill identifies and remediates architecture issues that make Go codebases hard to understand, change, and scale, such as tangled package dependencies, leaky abstractions, hidden initialization side effects, and poor module boundaries.

Core Features & Use Cases

• Package layout guidance: recommends a standard cmd/internal/pkg layout and helps assign responsibilities to cohesive packages.
• Dependency direction enforcement: detects inward-dependency violations, circular imports, and advises how to define consumer-side interfaces.
• Wiring and initialization checks: verifies that main is the composition root, discourages init side effects, and suggests explicit constructors and DI patterns.
• Use Case: evaluate a monolith for modularization, review PRs for architectural regressions, or prepare a codebase for safe refactoring into modules.

Quick Start

Ask the agent to review the repository architecture focusing on package layout, dependency direction, domain isolation, and provide a prioritized remediation plan.