Go Web Architecture

Core Principles

• Standard layout — Follow cmd/internal/pkg convention
• Explicit dependencies — Wire dependencies in main.go, no globals
• Interface-driven — Define interfaces where you use them, not where you implement
• Error wrapping — Wrap errors with context, use error codes
• No backwards compatibility — Delete, don't deprecate. Change directly
• LiteLLM for LLM APIs — Use LiteLLM proxy for all LLM integrations

No Backwards Compatibility

Delete unused code. Change directly. No compatibility layers.

// ❌ BAD: Deprecated function kept around
// Deprecated: Use NewUserService instead