gsd-forensics

Diagnose failed GSD workflows and generate forensic reports from git history.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/TruCol270/salty-pickle --skill gsd-forensics-trucol270
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-forensics
Source: https://github.com/TruCol270/salty-pickle/tree/main/.claude-skills/gsd-forensics
Command: npx skills add https://github.com/TruCol270/salty-pickle --skill gsd-forensics-trucol270

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 and provide a structured forensic report.

Core Features & Use Cases

  • Analyze git history and repository state to identify root causes of failures.
  • Inspect artifacts under .planning/ to track session history, ROADMAP, and PLANs.
  • Generate and save a structured forensic report to .planning/forensics/ and offer issue creation for actionable findings.

Quick Start

Run the forensics workflow to generate and save a diagnostic report in .planning/forensics/.

Frequently Asked Questions about gsd-forensics

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

FAQPage Schema
How do I diagnose root causes for failing git workflows in my repository?▼

To diagnose root causes for failing git workflows, you can run a forensics analysis that inspects git history, repository state, and .planning artifacts to generate a structured post-mortem report.

What is the best way to perform incident forensics on stuck GSD planning sessions?▼

Incident forensics for stuck GSD planning sessions is performed by analyzing session history, ROADMAP, and PLAN artifacts under the .planning directory to identify structural failures and generate a diagnostic report.

How do I generate a post-mortem report for failed git repository incidents?▼

You generate a post-mortem report by running a forensics workflow that verifies data sources and redacts sensitive data, saving the structured diagnostic findings to .planning/forensics/report-{timestamp}.md.

Can I automatically create GitHub issues from git history forensics findings?▼

Yes, after analyzing git history and repository state to identify root causes, the forensics workflow offers optional GitHub issue creation to track actionable findings for post-mortem remediation.

Does the forensics analysis require any external dependencies to inspect git repositories?▼

No external dependencies are required to inspect git repositories and .planning artifacts; the forensics workflow runs standalone to verify data sources, redact sensitive information, and output the forensic report.

What limitations exist when analyzing .planning artifacts for workflow diagnostic reports?▼

The workflow diagnostic analysis is limited to inspecting git history and artifacts under the .planning directory, meaning it only reports on state and data available within the local repository structure.