debug-new-code
Procedure for debugging newly written rgmercs code that misbehaves in game. Use when a recent change produces wrong behavior, errors, or flaky results and the cause isn't obvious. Don't use for one-li
SKILL.md.claude/skills/debug-new-code/SKILL.md
GitHubExamine everything thoroughly before patching — fixing one symptom at a time wastes effort.
- Instrument first, hypothesize second. Add debug output, read the full logs, then form a hypothesis — don't react to individual symptoms.
- Examine the entire flow including async boundaries (actor messages,
mq.delay, callbacks). Trace every state transition; don't stop at the first problem. - Fix root causes comprehensively. Address all identified issues together — one solid fix that handles all edge cases beats a chain of patches.