Diagnose failed workflow root causes
gsd:forensicsskillsetup L2★3,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