Go Project Implementation Guide

/pma

/pma

Scope

Loading Order

1. Always load

   references/baseline.md

   first.
2. Load

   references/config-and-data.md

   for config layering, validation, sqlc, pgx, GORM, and migrations.
3. Load

   references/http-and-runtime.md

   for handlers, middleware, logging, observability, and shutdown.
4. Load

   references/delivery.md

   for lint, tests, task runners, security review, CI, and Git workflow.

Quick Routing

• New service or CLI setup:

  references/baseline.md

• koanf config, env mapping, DB access, migrations, repository boundaries:

  references/config-and-data.md

• HTTP server, response envelopes, auth middleware, slog, tracing, shutdown:

  references/http-and-runtime.md

• quality gates, lint, tests, Taskfile, security checklist, CI, PR readiness:

  references/delivery.md

Reference Packs

• references/baseline.md

  Stack defaults, quality gates, layout, conventions, error model, and code quality standards.

• references/config-and-data.md

  Config layering with koanf, validation, sqlc plus pgx, GORM alternative, and migration rules.

• references/http-and-runtime.md

  Router structure, handler patterns, middleware, logging, observability, and graceful shutdown.

• references/delivery.md

  Lint config, testing, task runner expectations, security checks, CI, and Git conventions.