investigate

Reproduce bugs and document root causes with file:line evidence.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/chughtapan/safer-by-default --skill investigate-chughtapan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/chughtapan/safer-by-default/tree/main/skills/investigate
Command: npx skills add https://github.com/chughtapan/safer-by-default --skill investigate-chughtapan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reproduce and document bugs by reproducing failures, isolating the failing code path, and naming the root cause with file:line evidence. Produces a written writeup and a fix recommendation routed to the correct implementation modality. Use when a bug is reported, when production is misbehaving, or when a test fails for non-obvious reasons. Do NOT use to apply the fix; that is a separate modality. Investigation and remediation are different budgets.

Core Features & Use Cases

  • Reproduce defects deterministically to reveal the failing path.
  • Name the root cause with concrete file:line evidence and produce a formal artifact writeup.
  • Route remediation effort to the correct modality (implement-junior/senior/architect/spec) based on scope.

Quick Start

Describe the bug and reproduce it deterministically, then publish the root-cause writeup with evidence.

Frequently Asked Questions about investigate

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

FAQPage Schema
How do I find the root cause of a bug that fails for non-obvious reasons?

Root-cause analysis for non-obvious test failures requires deterministic reproduction to reveal the failing code path, naming the root cause with concrete file:line evidence, and producing a formal writeup for remediation.

What is the best way to document a production bug with evidence?

Documenting a production bug involves reproducing the failure deterministically, isolating the failing code path, and publishing a formal writeup that names the root cause with concrete file:line evidence.

How do I reproduce a defect deterministically to reveal the failing path?

Reproduce defects deterministically by collecting evidence and triggering the failure consistently to reveal the failing code path, which allows you to isolate the issue and name the root cause with concrete file:line evidence.

Can I use this investigation process to apply a code fix directly?

No, you should not use this investigation process to apply a code fix directly. Investigation and remediation are different budgets; this process diagnoses and documents the root cause, then routes the fix to a separate implementation modality.

When should I perform a structured investigation instead of immediately patching code?

Perform a structured investigation when bugs are reported, production misbehaves, or tests fail for non-obvious reasons. It isolates the failing code path and names the root cause with file:line evidence before routing remediation effort.