gsd-forensics

Diagnose failed GSD workflow runs by tracing root causes in git history and artifacts.

Updated May 22, 2026
One-click install
npx skills add https://github.com/yusaduymaz/loexai --skill gsd-forensics-yusaduymaz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-forensics
Source: https://github.com/yusaduymaz/loexai/tree/main/.codex/skills/gsd-forensics
Command: npx skills add https://github.com/yusaduymaz/loexai --skill gsd-forensics-yusaduymaz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you investigate why a Get Shit Done workflow failed, stalled, or drifted off course by turning commits, planning artifacts, and session state into a clear root-cause analysis.

Core Features & Use Cases

  • Failure Triage: Identifies stuck loops, missing artifacts, abandoned work, and crash or interruption patterns.
  • Evidence-Based Diagnosis: Correlates git history, planning files, and filesystem state to explain what changed and when.
  • Actionable Reporting: Produces a structured forensic report with findings, anomalies, and next-step recommendations for recovery or escalation.

Quick Start

Ask the skill to investigate the failed workflow and summarize the most likely root cause with evidence-backed recommendations.

Frequently Asked Questions about gsd-forensics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose why a stalled workflow crashed or stopped producing artifacts?

To diagnose a stalled workflow crash or missing artifacts, you trace root causes by correlating git history, planning files, and filesystem state. This forensic analysis identifies stuck loops, abandoned work, and interruption patterns to explain what changed and when.

What is the best way to investigate abandoned progress in get-shit-done project workflows?

The best way to investigate abandoned progress in get-shit-done workflows is through evidence-backed anomaly detection. This process examines session reports and planning artifacts to identify exactly where and why the workflow drifted off course.

How do I trace the root cause of missing planning artifacts using git history?

You trace the root cause of missing planning artifacts by performing a forensic review of git history and filesystem state. This method correlates commit changes with session state to pinpoint when artifacts were lost or abandoned.

Can I use forensic analysis to recover corrupted workflow state without altering source files?

Yes, forensic analysis preserves read-only source files while producing a structured diagnosis. It examines existing filesystem state and session reports to generate actionable recovery recommendations without modifying the original evidence.

Does workflow forensics work for triaging interrupted GSD session reports?

Yes, workflow forensics works for triaging interrupted GSD sessions by examining session reports for crash patterns. It correlates this evidence with git history to produce a redacted report detailing anomalies and next-step recommendations for escalation.

What should a structured forensic diagnosis include for a failed GSD workflow run?

A structured forensic diagnosis for a failed GSD workflow run should include identified anomalies, evidence-backed findings, and next-step recommendations. It correlates git history and filesystem state to summarize the most likely root cause for recovery.