forensics
Installation
SKILL.md
activity/{seq}-{unitType}-{unitId}.jsonl— full tool-call and message stream per unitjournal/YYYY-MM-DD.jsonl— iteration-level events. Orchestrator path emitsorchestrator-*events (orchestrator-dispatch-match,orchestrator-guard-block,orchestrator-terminal, etc.); legacy loop events (dispatch-match,stuck-detected,guard-block,unit-start/end,terminal) can still appear on non-orchestrator paths.metrics.json— token/cost ledger; duplicatetype/identries indicate a stuck loopauto.lock— JSON snapshot of the currently-owning PID; stale lock = crash mid-unitforensics/— saved prior reportsdebug/— debug logs if enabledruntime/paused-session.json— serialized session when auto-mode pauseddoctor-history.jsonl— doctor check history
The /gsd forensics command pre-computes a forensic report with anomalies flagged. This skill is the manual investigation that goes deeper, or runs when the automated report isn't enough.