agh-code-guidelines

name	agh-code-guidelines
description	Go production discipline for AGH. Use when writing or editing non-test Go files under cmd or internal, including config, logging, CLI, concurrency, and process-lifecycle paths. Do not use for Go tests; pair it with the narrower schema, contract, cleanup, or network skill when those domains apply.
trigger	implicit

AGH Code Guidelines

Apply the canonical AGH rules before changing production Go. This file owns the application order; its references own the rules.

Procedures

Step 1: Route the Change

1. Confirm the target is a production Go file (cmd/** or internal/**, not *_test.go).
2. Activate golang-pro. Also activate the matching narrow skill for tests, cleanup paths, schema migrations, API contracts, or internal/network work.
3. Read .agents/skills/agh/agh-code-guidelines/references/coding-style.md in full. Also read .agents/skills/agh/agh-code-guidelines/references/concurrency-patterns.md in full when the change touches goroutines, shared state, detached lifetime, subprocesses, shutdown, timers, mutexes, or channels.

Done when: the edit surface and every matching companion domain are named, and every applicable canonical reference is loaded.

Step 2: Apply the Canonical Rules

1. Apply every matching rule from the loaded references; do not copy a subset into task notes or local conventions.
2. Trace the change through error identity, cleanup, context, logging, types, configuration lifecycle, CLI boundaries, comments, package boundaries, goroutine ownership, detached execution, and subprocess supervision.