Go API Structure

The runnable example/ module — in this skill's repo, not the installed skill — declares go 1.27.0. Advice that only holds from a particular release carries an inline version gate at the point it is given; everything without one applies to any supported toolchain.

The rule everything else follows

Directories are navigation. The import graph is the architecture.

Moving a file into internal/core/ does not decouple it from Postgres; deleting its import "database/sql" does. Decide which way imports point first, then decide where files go. Get the first wrong and no layout rescues it.

The words this skill uses