go-opinions: document CLI config precedence

Amolith created

Change summary

skills/amoliths-go-opinions/references/cli.md | 4 ++++
1 file changed, 4 insertions(+)

Detailed changes

skills/amoliths-go-opinions/references/cli.md 🔗

@@ -83,8 +83,12 @@ keep the same versioning pattern but remove the static-only flags.
 ## Config
 
 - TOML config: `BurntSushi/toml`.
+- Default config file: read from `$XDG_CONFIG_HOME/<app-name>/config.toml`,
+  falling back to `~/.config/<app-name>/config.toml` when `XDG_CONFIG_HOME` is
+  unset.
 - Env vars: read at the boundary, validate early, and store in a typed config
   struct.
+- Config precedence is flag, then environment variable, then config file.
 - Config discovery should be explicit and documented; avoid magical precedence
   unless the project truly needs layering.