investigation-mode

Pause after repeated failures and perform root-cause analysis before resuming.

16|1|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/kasuken/github-copilot-superpowers --skill investigation-mode-kasuken
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigation-mode
Source: https://github.com/kasuken/github-copilot-superpowers/tree/main/.github/skills/investigation-mode
Command: npx skills add https://github.com/kasuken/github-copilot-superpowers --skill investigation-mode-kasuken

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured approach to debugging when encountering repeated errors or getting stuck, preventing aimless coding and ensuring root cause analysis before proceeding.

Core Features & Use Cases

  • Error Handling: Automatically pauses execution upon detecting two or more consecutive failures.
  • Root Cause Analysis: Initiates a deep research and analysis phase to identify the underlying problem.
  • Controlled Resumption: Ensures that work only resumes after a verified plan and user approval for any significant direction changes.
  • Use Case: When a feature consistently fails tests after multiple attempts, this skill will halt the process, gather diagnostic information, and present options for fixing the core issue rather than just applying quick patches.

Quick Start

Use the investigation-mode skill when you encounter repeated errors in the current task.

Frequently Asked Questions about investigation-mode

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

FAQPage Schema
How do I debug persistent build errors and repeated test failures?

Debug persistent build errors by activating a systematic investigation protocol that pauses execution after two consecutive failures, gathers diagnostic evidence, and performs root cause analysis before applying fixes.

What is the best way to stop aimless coding when troubleshooting errors?

Troubleshooting errors systematically requires pausing development to gather evidence and identify the underlying root cause, ensuring you only resume work after creating a verified plan and receiving explicit approval.

How does root cause analysis work for unclear problem statements in software engineering?

Root cause analysis for unclear problem statements works by initiating a deep research phase that collects diagnostic evidence, traces the underlying issue, and presents evidence-based solutions rather than quick patches.

When do I need a structured investigation protocol for error handling?

You need a structured investigation protocol for error handling when encountering persistent failures, repeated test failures, or development stagnation that requires evidence-based solutions instead of superficial patches.

Can I resume coding automatically after a root cause analysis identifies the issue?

You cannot resume coding automatically after root cause analysis; controlled resumption mandates pausing, gathering evidence, and seeking explicit user approval for any significant direction changes before applying fixes.

Why does my development process halt after multiple consecutive test failures?

Your development process halts after multiple consecutive test failures because the error handling protocol automatically pauses execution to prevent aimless coding and ensure root cause analysis is performed.