What problem does it solve? When the git-cg commit generator produces a message that misses the gold standard, teams need a rigorous, repeatable way to reconstruct why the failure happened, classify it, and prevent recurrence. This Skill operationalizes the docs/quality failure-analysis package so every gold miss becomes a durable, indexed forensic case instead of a lost chat note. ## Core Features & Use Cases - Forensic Reconstruction: Walks the 14-stage commit pipeline (extract, rank, contract lock, render, accept) to identify the first stage that left the gold path, with Opik trace binding or explicit Opik-unbound labeling. - Regime & Taxonomy Classification: Assigns Regime A (controls fire but recovery worsens output) or Regime B (controls never fire and a wrong envelope is accepted), attaching F*/P* IDs only from the official FAILURE_TAXONOMY and PREVENTION_BACKLOG registries. - Case Promotion & Indexing: Lands durable cases under docs/quality/cases/, updates indexes and source maps, and supersedes GitHub issue comments as intake-only evidence. - Use Case: After a generated commit message passes Hybrid parsing but uses the wrong type and scope, use this Skill to file a full Regime B case with raw-to-gold SHAs, tree-preservation proof, and prevention control pointers. ## Quick Start Ask the agent to run a gold-miss failure analysis on the latest git-cg commit and file a case under docs/quality/cases following the METHOD protocol.
