gsd-forensics

Diagnose failed GSD workflow executions and generate evidence-backed forensic reports.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/MINT-IA/MINT --skill gsd-forensics-mint-ia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-forensics
Source: https://github.com/MINT-IA/MINT/tree/main/.claude/skills/gsd-forensics
Command: npx skills add https://github.com/MINT-IA/MINT --skill gsd-forensics-mint-ia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams diagnose why a Get-Shit-Done (GSD) workflow failed or got stuck by analyzing git history, .planning artifacts, and filesystem state to produce evidence-backed findings and actionable recommendations.

Core Features & Use Cases

  • Evidence collection: Automatically gather git logs, diffs, .planning/STATE.md, ROADMAP.md, phase PLAN.md/SUMMARY.md/VERIFICATION.md, and session reports for inspection.
  • Anomaly detection: Check for stuck loops, missing artifacts, abandoned work, crashes or interruptions, and inconsistent state transitions with citations to commits and files.
  • Structured reporting: Produce a timestamped forensic report saved to .planning/forensics/, present findings inline, and offer interactive follow-up steps with optional issue creation.
  • Use case: When a GSD run halts mid-phase, run the Skill to discover whether uncommitted changes, missing verification artifacts, or a recent commit introduced the failure.

Quick Start

Ask the gsd-forensics skill to investigate the most recent failed GSD workflow and write a forensic report to .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 a failed git workflow that halted mid-phase?

To diagnose a failed git workflow halted mid-phase, analyze git history and planning artifacts to detect stuck loops, missing artifacts, or uncommitted changes. The tool collects logs and diffs to produce an evidence-backed forensic report identifying the failure cause.

What is the best way to investigate abandoned work and inconsistent state transitions in a repository?

Investigating abandoned work and inconsistent state transitions requires inspecting git history and planning state files. This skill cross-references commits with phase artifacts to detect anomalies, citing specific commits and files for every finding in a structured report.

Can I run incident response forensics on a repository without modifying source files?

Yes, you can run incident response forensics with read-only access to git data and the .planning directory. The process gathers evidence and writes a timestamped forensic report to .planning/forensics/ without modifying any source files.

Why does my automated workflow get stuck in loops and how do I find the cause?

Automated workflows get stuck in loops due to inconsistent state transitions, missing verification artifacts, or recent commits introducing failures. Analyzing git diffs and planning state files identifies the exact commit or uncommitted change causing the loop.

Do I need a .planning directory with specific artifacts to generate a forensic postmortem report?

Yes, generating a forensic postmortem report requires a .planning directory containing state files like STATE.md, ROADMAP.md, and phase PLAN.md, SUMMARY.md, and VERIFICATION.md files. The analysis correlates these planning artifacts with git history to produce evidence-backed findings.

What are the limitations of using git history forensics for crash or interruption analysis?

Git history forensics for crash or interruption analysis is limited to evidence available in commits, diffs, and .planning artifacts. It cannot diagnose failures caused by external system crashes or environmental issues if those events left no trace in the repository's git data or planning files.