What problem does it solve? Codebases accumulate unexplained magic constants, untested functions, and fragile high-fan-in symbols that are hard to track. This Skill gives agents a deterministic rule set for inserting @AX:NOTE, @AX:WARN, @AX:ANCHOR, and @AX:TODO tags so code risks and obligations are documented inline and consistently. ## Core Features & Use Cases - Trigger-Based Tagging: Defines concrete detection conditions for each tag type, such as cyclomatic complexity >= 15 for WARN or fan_in >= 3 callers for ANCHOR. - Per-File Limits and Overflow Handling: Enforces a maximum of 3 ANCHOR and 5 WARN tags per file, with downgrade and retention strategies when limits are exceeded. - Lifecycle Tracking: Escalates @AX:TODO tags to WARN after 3 unresolved TDD cycles using @AX:CYCLE counters, and marks all agent-generated tags with an [AUTO] prefix. - Use Case: After finishing a TDD GREEN or REFACTOR phase in a Go project, an agent scans modified files, detects a goroutine launched without context.Context, and inserts // @AX:WARN [AUTO]: ... with a matching @AX:REASON line in the same commit. ## Quick Start Scan the files changed in this task and apply @AX tags according to the trigger rules, respecting per-file limits and the [AUTO] prefix convention.
