Bug Investigation

Use this skill when a change or failure affects runtime behavior, contract alignment, config projection, or service health.

Primary workflow

1. Reproduce the issue with the smallest command that proves it.
2. Decide whether the issue is:
   • static structure/topology drift,
   • contract mismatch,
   • runtime cluster failure,
   • raccoon-cli tooling behavior.
3. Fix the narrowest layer that owns the bug.
4. Re-run the smallest verification set that proves the fix.

Preferred commands

• make check
• make verify
• make check-deep
• make scenario-smoke SCENARIO=<name>
• make trace-pack
• make results-inspect
• make logs SERVICE=<name>
• make ps

Repository-specific bug patterns