gds-investigate

Investigates bugs and code areas into evidence-graded forensic case files.

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill gds-investigate-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-investigate
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/gds-investigate
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill gds-investigate-hordricjr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Debugging and incident analysis often rely on guesswork, scattered notes, and unverified assumptions. This Skill turns bug reports, logs, and unfamiliar code areas into structured, evidence-graded case files that another engineer can pick up cold, with every finding labeled Confirmed, Deduced, or Hypothesized. ## Core Features & Use Cases - Evidence-graded investigation: Every finding is cited with path:line, log timestamps, or commit hashes, and hypotheses are tracked with explicit confirm/refute criteria rather than deleted. - Structured case file lifecycle: Initializes a persistent case file from a template, maps the evidence perimeter, traces causality and timelines, and finalizes with a confidence-rated conclusion and hand-off brief. - Dual-mode operation: Handles both symptom-driven defect chasing (tickets, stack traces, logs) and symptom-free code area exploration to build a mental model before making changes. - Use Case: A user pastes a production stack trace and asks what caused the incident. The Skill opens a case file, anchors on the first Confirmed error, traces the caller chain across the source, and delivers a root-cause conclusion with a reproduction plan. ## Quick Start Investigate why the checkout endpoint returns a 500 error using the attached server log and produce an evidence-graded case file.

Frequently Asked Questions about gds-investigate

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

FAQPage Schema
How do I investigate a bug root cause from a stack trace?

Provide the stack trace or log file path as input. The Skill anchors on the first Confirmed error, greps for exact error strings, follows the caller chain through the source, and records a root-cause conclusion with confidence level in a case file.

How to document a software incident investigation?

The Skill generates a structured markdown case file from a template covering evidence inventory, timeline of events, confirmed findings, hypotheses with confirm/refute criteria, and a final conclusion. The file persists across sessions so investigations can resume later.

Can I use this to understand unfamiliar code before modifying it?

Yes, exploration mode works without any symptom. It maps I/O, dependencies, and control flow of a named code area, building an evidence-cited mental model sufficient for your stated goal before you make changes.

Does the investigation skill fix the bugs it finds?

No, investigation stops at the diagnosis. For trivial fixes like off-by-one errors it may suggest a one-line change, but implementation is routed to follow-up workflows such as gds-quick-dev or gds-create-story.

What happens when there is not enough evidence to find the root cause?

The Skill switches to evidence-light mode, documents the missing evidence as a finding itself, and builds a prioritized backlog of data-collection items. It states exactly what evidence would confirm or refute each open hypothesis.