Skills
.Work. You
Rest

debug-red-first

Community

Fix UI bugs only after reproducing the symptom.

Software Engineering#debugging#reproduction#invariants#ui state#minimal fix#guard rails#red test
Authorpanamini
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It prevents teams from “guess-fixing” unstable UI and state issues by requiring a concrete failing reproduction that matches the exact user symptom before any product change.

Core Features & Use Cases

  • Symptom-first debugging workflow: Lock the pass to one exact user symptom and one user-facing invariant.
  • RED test discipline: Write a failing test that reproduces the symptom on current code, then only proceed when it truly fails.
  • Minimal, shared-path fixes: Apply the smallest change, prioritizing shared source-of-truth and shared load/switch paths before local tweaks.

Quick Start

Run the debug pass by defining the exact user symptom and its user invariant, writing one RED failing test that reproduces it on current code, then applying only a minimal fix and re-running guard-rail tests plus a short manual smoke check.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: debug-red-first
Download link: https://github.com/panamini/pi-tooling/archive/main.zip#debug-red-first

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.