oco-investigate-bug

Guide call chain analysis and evidence gathering to identify root causes.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/hoklims/oco --skill oco-investigate-bug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oco-investigate-bug
Source: https://github.com/hoklims/oco/tree/main/oco-plugin/skills/oco-investigate-bug
Command: npx skills add https://github.com/hoklims/oco --skill oco-investigate-bug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a rigorous, evidence-first process for diagnosing bugs without clear stack traces, reducing guesswork.

Core Features & Use Cases

  • Call Chain Analysis: Traces suspect functions through oco_routes MCP tool or code search methods to identify potential sources of bugs.
  • Scope Narrowing: Guides the developer to focus on a small set of candidate files based on call dependencies.
  • Evidence Gathering: Recommends inspecting code, recent changes, and tests to pinpoint root causes, facilitating precise fixes.
  • Use Case: Debugging unpredictable behavior in a complex codebase where tracebacks are unavailable or insufficient.

Quick Start

Follow the step-by-step instructions to trace the bug's call path, gather evidence, and confirm root causes before applying fixes.

Frequently Asked Questions about oco-investigate-bug

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

FAQPage Schema
How do I find the root cause of a bug without a clear stack trace?

To find the root cause of a bug without a stack trace, use a structured debugging workflow that traces call chains and gathers evidence from code and recent changes. This approach narrows down candidate files to pinpoint exact failures.

What is the best way to trace a call chain in a complex codebase?

Tracing a call chain in a complex codebase involves analyzing suspect functions and their dependencies to narrow scope. By inspecting code paths and recent modifications, you can identify potential sources of unpredictable behavior.

How do I debug code when I have no error logs or tracebacks?

Debugging without error logs requires an evidence-first investigation process. You analyze the suspect call chain, inspect recent code changes, and run tests to confirm the root cause before attempting any fixes, eliminating guesswork.

Can I narrow down candidate files for debugging using call dependencies?

Yes, you can narrow down candidate files by analyzing call dependencies. Tracing suspect functions through the codebase highlights a small set of relevant files, focusing your investigation on the actual paths causing the bug.

Why should I use an evidence-based code investigation workflow?

An evidence-based code investigation workflow ensures you only apply fixes after confirming the root cause through call chain analysis and evidence gathering. This reduces guesswork and prevents introducing new errors into complex systems.