forensics

Analyze GSD runtime artifacts to produce a GitHub-issue-ready forensic report.

12|1|Updated May 29, 2026
One-click install
npx skills add https://github.com/qdzsh/gsd-revamp --skill forensics-qdzsh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: forensics
Source: https://github.com/qdzsh/gsd-revamp/tree/main/src/resources/skills/forensics
Command: npx skills add https://github.com/qdzsh/gsd-revamp --skill forensics-qdzsh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Post-mortem a failed GSD auto-mode run. Traces from symptom to root cause using .gsd/activity/*.jsonl, .gsd/journal/YYYY-MM-DD.jsonl, .gsd/metrics.json, and .gsd/auto.lock. Produces a filing-ready bug report with file:line references and a concrete fix suggestion. Reads existing artifacts — does NOT re-run anything.

Core Features & Use Cases

  • Read-only forensic analysis across GSD runtime artifacts to identify root causes without mutating state.
  • Generates a GitHub-issue-ready report with citations to artifact paths and exact lines or fields.
  • Use case: When auto-mode terminates unexpectedly, or a unit loops, invoke forensics to produce a structured investigation and remediation plan.

Quick Start

Run /gsd forensics to generate a deeper forensic report from the current session artifacts.

Frequently Asked Questions about forensics

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

FAQPage Schema
How do I investigate a failed auto-mode run using runtime artifacts?▼

To investigate a failed auto-mode run, you can trace symptoms to root causes by analyzing read-only runtime artifacts in .gsd/activity, .gsd/journal, and .gsd/metrics.json. This generates a GitHub-issue-ready forensic report with exact file:line citations.

What is the best way to generate a post-mortem report for an unexpected session termination?▼

The best way to generate a post-mortem report for an unexpected session termination is to analyze .gsd/auto.lock and journal artifacts. This read-only process identifies the root cause and outputs a structured narrative with a concrete fix suggestion without mutating state.

Can I find the root cause of a unit re-dispatch loop without re-running the session?▼

Yes, you can find the root cause of a unit re-dispatch loop without re-running anything. Forensic analysis reads existing JSONL traces and metrics to map the failure progression, providing a remediation plan based solely on historical runtime data.

Does forensic analysis of GSD artifacts modify my project state?▼

No, forensic analysis of GSD artifacts does not modify your project state. The investigation is strictly read-only, parsing existing activity logs and metrics to produce a filing-ready bug report without executing or mutating any code.

When do I need to analyze .gsd/journal and .gsd/metrics.json files?▼

You need to analyze .gsd/journal and .gsd/metrics.json files when auto-mode fails, a session ends unexpectedly, or a unit loops. These artifacts provide the runtime traces required to identify root causes for a formal post-mortem investigation.

What does a forensic report produced from runtime traces include?▼

A forensic report produced from runtime traces includes a GitHub-issue-ready narrative, exact citations to artifact paths and lines, and a concrete fix suggestion. It maps the failure from symptom to root cause using read-only activity logs.