What problem does it solve?
This Skill helps teams diagnose why a Get-Shit-Done (GSD) workflow failed or got stuck by analyzing git history, .planning artifacts, and filesystem state to produce evidence-backed findings and actionable recommendations.
Core Features & Use Cases
- Evidence collection: Automatically gather git logs, diffs, .planning/STATE.md, ROADMAP.md, phase PLAN.md/SUMMARY.md/VERIFICATION.md, and session reports for inspection.
- Anomaly detection: Check for stuck loops, missing artifacts, abandoned work, crashes or interruptions, and inconsistent state transitions with citations to commits and files.
- Structured reporting: Produce a timestamped forensic report saved to .planning/forensics/, present findings inline, and offer interactive follow-up steps with optional issue creation.
- Use case: When a GSD run halts mid-phase, run the Skill to discover whether uncommitted changes, missing verification artifacts, or a recent commit introduced the failure.
Quick Start
Ask the gsd-forensics skill to investigate the most recent failed GSD workflow and write a forensic report to .planning/forensics/.