agh-code-guidelines

What problem does it solve?

This Skill prevents Go production changes in AGH from drifting into reviewer-blocking style and concurrency violations by enforcing the project’s canonical error handling, logging, context, configuration, and goroutine ownership rules before you implement them.

Core Features & Use Cases

• Codebase-wide Go standards enforcement: ensures new/edited production Go code follows AGH’s strict rules for error wrapping, error matching, and banning unsafe patterns.
• Concurrency and lifecycle correctness: requires context-driven goroutine shutdown, WaitGroup tracking for owner-spawned goroutines, and no fire-and-forget execution.
• Operational reliability at CLI boundaries: distinguishes “flag not set” vs “flag set to zero value,” trims/filters CLI string-slice inputs, and keeps JSON/JSONL output shapes stable.
• Configuration and type discipline: bans hardcoded operational values, enforces functional options/config lifecycle updates, and requires compile-time interface assertions for exported types.

Quick Start

Activate this skill while editing a production Go file under cmd/ or internal/ (but not *_test.go) to apply its Go style and concurrency rules before you submit the change.