Diagnose failed workflow root causes

gsd:forensicsskillsetup L23,035
davepoon/buildwithclaude
What it does

Diagnose failed GSD workflows via git history and artifact analysis

Best for

Understanding why a GSD workflow got stuck or failed, with data-grounded diagnostic findings rather than speculation.

Inputs
  • · Problem description (optional, will ask if not provided)
Outputs
  • · Forensic report saved to .planning/forensics/report-{timestamp}.md
  • · Findings, anomalies, recommendations inline
  • · Optional GitHub issue with redacted sensitive data
Requires
  • · forensics.md workflow
  • · git history, .planning/ artifacts
Preconditions
  • · Project has .planning/ directory with STATE.md and phases/
  • · Git history available for analysis
Failure modes
  • · Insufficient data in artifacts → findings incomplete
  • · Git history too old → relevant commits missing
  • · Sensitive data present → must redact before output
  • · Anomalies found but root cause unclear → mark as insufficient evidence
Trust signals
  • · Evidence-grounded findings (git commits, file state, STATE.md)
  • · No speculation without evidence
  • · Redaction of sensitive data built-in
  • · 4+ anomaly types checked: stuck loop, missing artifacts, abandoned work, crash/interruption