gsd-forensics

Diagnose GSD workflow failures by analyzing git history, artifacts, and system state.

Updated Jan 21, 2026
One-click install
npx skills add https://github.com/zerAda/RestaurantAgentAutomation --skill gsd-forensics-zerada
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-forensics
Source: https://github.com/zerAda/RestaurantAgentAutomation/tree/main/.agent/skills/gsd-forensics
Command: npx skills add https://github.com/zerAda/RestaurantAgentAutomation --skill gsd-forensics-zerada

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Quickly identify and resolve issues in failed or stuck GSD workflows with detailed analysis.

Core Features & Use Cases

  • Git History Analysis: Examines commits and changes to pinpoint the source of problems.
  • Artifact Review: Assesses .planning/ artifacts for errors or omissions.
  • State Evaluation: Reviews the file system and session history for discrepancies.
  • Report Generation: Provides a structured forensic report outlining findings and recommendations.

Quick Start

Run the gsd-forensics skill with the 'analyze-workflow-failure' command.

Frequently Asked Questions about gsd-forensics

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

FAQPage Schema
How do I diagnose failures in stuck workflow executions?

To diagnose failures in stuck workflow executions, the skill examines git history, project artifacts, and system state to pinpoint the source of problems and generates a structured diagnostic report for recovery.

What is the best way to recover data after a workflow error or stall?

The best way to recover data after a workflow error or stall is to perform a forensic analysis of your git history and project artifacts, which produces a structured report outlining findings and recommendations for data recovery.

How does git history analysis help troubleshoot complex workflow issues?

Git history analysis helps troubleshoot complex workflow issues by examining commits and changes to identify discrepancies in the project state, allowing you to trace exactly where the workflow execution encountered errors.

Do I need specific project artifacts to diagnose workflow failures?

Yes, you need specific project artifacts like the .planning/ directory to diagnose workflow failures. The forensic analysis assesses these artifacts for errors or omissions, alongside reviewing the file system and session history for discrepancies.

Why does my workflow execution stall and how can I get a diagnostic report?

Your workflow execution may stall due to errors or omissions in project artifacts or file system discrepancies. You can get a diagnostic report by analyzing your git history and system state to outline findings and recovery recommendations.

Can I use forensic analysis to review session history and file system discrepancies?

Yes, you can use forensic analysis to review session history and file system discrepancies. The diagnostic process evaluates the file system and session logs to identify inconsistencies causing workflow failures.