gsd-forensics

Analyze git history and artifacts to document failed GSD workflow root causes.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/onelee85/my-skills --skill gsd-forensics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-forensics
Source: https://github.com/onelee85/my-skills/tree/main/gsd-forensics
Command: npx skills add https://github.com/onelee85/my-skills --skill gsd-forensics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Post-mortem investigation for failed GSD workflows — analyzes git history, artifacts, and state to diagnose what went wrong.

Core Features & Use Cases

  • Forensic analysis of git history, planning artifacts, and workspace state to identify root causes of failed workflows.
  • Structured reports with actionable recommendations to restore workflow health.
  • Interactive investigation workflow with optional issue creation for actionable findings.

Quick Start

Run the forensics workflow to generate a diagnostic report from the current project state.

Frequently Asked Questions about gsd-forensics

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

FAQPage Schema
How do I investigate a failed GSD workflow using git history and artifacts?

To investigate a failed GSD workflow, this Skill analyzes git history, planning artifacts, and workspace state to identify root causes. It gathers evidence and generates a structured forensic report to restore workflow health.

What is the best way to run a post-mortem investigation for stalled GSD runs?

The best way to run a post-mortem for stalled GSD runs is using an interactive investigation workflow that analyzes commits and file-system state. It redacts sensitive data and writes actionable findings to a dedicated forensics directory without modifying source files.

Does the forensic analysis modify my source files during root-cause diagnosis?

No, the forensic analysis does not modify your source files. It safely gathers evidence, redacts sensitive data, and writes the structured diagnostic report exclusively to the .planning/forensics/ directory.

Can I automatically create issues from actionable findings in a GSD forensics report?

Yes, you can create issues from actionable findings. The interactive investigation workflow includes optional issue creation to help restore workflow health based on the structured root-cause analysis of your failed GSD runs.

What data sources do I need for diagnosing failed GSD workflows?

Diagnosing failed GSD workflows requires analyzing git history, planning artifacts, and workspace file-system state. The Skill gathers evidence from these multiple data sources to identify the root causes of failed or stalled runs.