Go Architecture Review

Good architecture makes the next change easy. Bad architecture makes every change scary.

Operating Modes

Pick the mode that matches the request before starting:

• Layout review (default) — assess an existing codebase against the sections below and report violations with severity.
• Refactor plan — same assessment, but the deliverable is an ordered migration plan (smallest safe steps first), not just findings.
• New service consultation — asked "how should I structure X": apply sections 1-3 as prescriptive guidance instead of review checks.

Auditing Large Codebases

For repositories with many packages, build the dependency picture before judging it: