Code Conventions

Opinionated coding conventions for Go, TypeScript/Vue, and Astro projects. Every rule exists because it prevented a real bug or eliminated real friction.

Priority: Clarity > Simplicity > Concision > Maintainability > DRY.

Part 1: Go Conventions

1.1 CLI Framework

Preferred: urfave/cli/v3.

• Use Destination: &var + Sources: cli.EnvVars("ENV_NAME") for every flag.
• One subcommand per package under cmd/<name>/.
• Entry point in main.go calls app.Run().