What problem does it solve? Contributors to the CG-agent-harness repository repeatedly hit the same non-obvious traps: tests that look green for the wrong reason, cleanup PRs that break architectural invariants, and CI flakes that get misattributed to unrelated diffs. This Skill captures 19 session-tested failure patterns with their symptoms, wrong fixes, and correct fixes so you avoid repeating them. ## Core Features & Use Cases - Symptom-to-fix mapping: Each gotcha lists the observable symptom, the tempting wrong fix, the correct fix, and evidence pointers to files like INVARIANTS.md, AGENTS.md, and tests/invariant_guard.rs. - Invariant protection: Covers architectural boundaries such as the server/agentic separation (I6), intentional boundary duplication, verbatim CSRF placeholders, and write-gate contracts that must never be loosened. - CI and tooling traps: Documents clippy toolchain skew on Macs, Chrome acceptance flakes (issue #43), ephemeral port races, github.paginate result shape changes, and release dispatch collisions. - Use Case: Before debugging a hanging test or a red CI job on this repo, load this Skill to check whether the failure matches a known trap — for example, serve exiting 0 on port-in-use, or a push not re-triggering the Codex review. ## Quick Start Load the cgagentharness-gotchas skill before running install, verify, packaging, or debugging tasks on the CG-agent-harness repository.
