investigate

Trace data flow to identify root causes of software bugs and failing tests.

3|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/The13thNode/VibeCorp_PromptCEO --skill investigate-the13thnode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/The13thNode/VibeCorp_PromptCEO/tree/main/skills/public/investigate
Command: npx skills add https://github.com/The13thNode/VibeCorp_PromptCEO --skill investigate-the13thnode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enforces an investigation-first workflow to reliably identify root causes of software bugs and failing tests so that fixes do not introduce regressions.

Core Features & Use Cases

  • Reproduce & Trace: Reproduce issues consistently and trace data flow from user action through event handlers, services, APIs, and databases to find where data first diverges.
  • Hypothesis-Driven Testing: Form explicit hypotheses, validate them with logs, console outputs or debugger, and confirm the cause before changing code.
  • Controlled Fixing & Escalation: Require the smallest possible fix with a failing regression test added first, and apply a 3-strike rule that stops attempts and escalates when fixes fail.
  • Use Case: A frontend developer traces a mismatched UI value back to an API query, writes a failing test, verifies the hypothesis with logging, implements a minimal fix, and documents the investigation.

Quick Start

Use the investigate skill to trace the failing test's data flow, verify the root cause with logs or a debugger, add a failing regression test, then apply the minimal fix.

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 before applying a fix?

To find a bug's root cause, reproduce the issue consistently and trace data flow from user action through event handlers, services, APIs, and databases to identify where data first diverges. Form explicit hypotheses and validate them with logs or a debugger before changing code.

What is the best way to trace data flow across frontend and backend systems?

Tracing data flow across frontend and backend systems involves tracking client-to-server-to-database paths. You reproduce the issue, monitor logs or console outputs at each layer, and verify where the expected behavior first diverges from the actual data returned.

How do I perform hypothesis-driven testing for intermittent failures?

Hypothesis-driven testing for intermittent failures requires forming explicit assumptions about the root cause. You validate each hypothesis using logs, console outputs, or a debugger to confirm the exact failure point before implementing any code changes.

When should I escalate a failing test or bug investigation?

You should escalate a bug investigation after three failed attempts to fix the issue. This three-strike policy stops repeated failed fixes, ensuring you halt attempts and escalate the problem when your hypotheses are not resolving the root cause.

How do I add a regression test when triaging a reported bug?

To add a regression test during bug triage, write a failing test that specifically captures the reported defect. You verify the root cause with logging, implement the smallest possible fix, and ensure the previously failing test now passes.