unravel

Enforce a hypothesis preflight before code changes in debugging sessions.

12|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/Alexander-Tyagunov/magician --skill unravel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unravel
Source: https://github.com/Alexander-Tyagunov/magician/tree/main/skills/unravel
Command: npx skills add https://github.com/Alexander-Tyagunov/magician --skill unravel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging requires avoiding changes until a testable hypothesis is established; this skill enforces a hypothesis preflight to prevent blind edits and wasted time.

Core Features & Use Cases

  • Guided four-phase debugging: hypothesis preflight, evidence gathering, hypothesis testing, and fix/verify.
  • Guardrails to ensure no code changes occur without agreement from the user or redirect.
  • Anti-pattern awareness to avoid random code changes and promote traceable debugging.

Quick Start

Describe the symptom and exact error details, then state your hypothesis before reading any code or making changes, and await user confirmation to proceed.

Frequently Asked Questions about unravel

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

FAQPage Schema
What is hypothesis-driven debugging and how does it prevent bad code changes?

Hypothesis-driven debugging requires establishing a testable hypothesis before modifying code. This preflight process prevents blind edits and wasted time by enforcing evidence gathering, hypothesis testing, and verification to ensure safe, traceable fixes.

How do I start a systematic debugging session using a preflight checklist?

To start systematic debugging, describe the symptom and exact error details, then state your hypothesis before reading code. Await user confirmation to proceed, ensuring no code changes occur without explicit agreement during the four-phase workflow.

Why does my debugging process lead to random code changes and regression issues?

Random code changes during debugging often happen without a systematic workflow. Enforcing a strict four-phase hypothesis preflight with anti-pattern awareness promotes traceable debugging and ensures regression testing before applying any modifications.

Can I apply a systematic debugging workflow to any software project?

Yes, this systematic debugging workflow applies to debugging sessions across projects. It guides hypothesis creation, evidence gathering, testing, and verification regardless of the specific codebase, using guardrails to ensure safe fixes.

What is the best way to verify a code fix without introducing new bugs?

The best way to verify a code fix is through a strict four-phase debugging workflow that includes hypothesis testing and regression testing. This approach uses guardrails to ensure no code changes occur without agreement, preventing new bugs.

When should I not use a hypothesis preflight for debugging?

You should not bypass the hypothesis preflight when you need traceable fixes and regression testing. Skipping this systematic debugging phase risks introducing blind edits, anti-patterns, and unverified code changes into your project.