hapo:debug

Diagnose software issues through evidence-first root-cause analysis and verification plans.

54|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/haposoft/cafekit --skill hapo-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hapo:debug
Source: https://github.com/haposoft/cafekit/tree/main/packages/spec/src/claude/skills/debug
Command: npx skills add https://github.com/haposoft/cafekit --skill hapo-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a structured process for diagnosing complex issues, ensuring that problems are addressed at their root cause, not just their symptoms.

Core Features & Use Cases

  • Evidence-First Approach: Prioritizes gathering and analyzing evidence before attempting fixes.
  • Scout-First Methodology: Requires a thorough investigation of the codebase context before forming hypotheses.
  • Root-Cause Analysis: Provides a systematic approach to identifying the underlying cause of problems.
  • Verification Plan: Offers a detailed plan for verifying the fix before considering it complete.
  • Integration with Hotfix: Seamlessly transitions to hapo:hotfix once the root cause is identified.

Quick Start

To start debugging an issue, use: /hapo:debug <issue> --quick|--ci|--frontend|--perf

Frequently Asked Questions about hapo:debug

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

FAQPage Schema
How do I perform root-cause diagnosis for complex software issues?

Root-cause diagnosis requires an evidence-first approach that systematically analyzes codebase context, evidence, and blast radius before forming hypotheses. This ensures you address the underlying cause rather than just treating symptoms.

What is evidence-first debugging and when should I use it?

Evidence-first debugging prioritizes gathering and analyzing concrete data before attempting fixes. Use this structured diagnosis process for complex software issues where superficial symptom treatment has failed or risks introducing regressions.

How do I start debugging an issue using a structured diagnosis process?

Start debugging an issue by providing the specific problem context to trigger a scout-first investigation of the codebase. This methodology mandates thorough code inspection to gather evidence before creating a verification plan.

Can I use this root-cause analysis approach for frontend and performance issues?

Yes, this root-cause analysis approach supports frontend and performance issues, alongside general CI and quick debugging contexts. It adapts its systematic codebase inspection and evidence gathering to these specific software engineering scenarios.

What is the best way to verify a software fix after identifying the root cause?

The best way to verify a software fix is to follow a detailed verification plan generated after root-cause identification. This structured plan confirms the fix resolves the issue completely without introducing unintended side effects.

Why does my software issue keep recurring after applying a fix?

Your software issue likely recurs because the fix addressed symptoms rather than the root cause. An evidence-first diagnosis process analyzes the codebase context and blast radius to ensure the underlying problem is fully resolved.