debug-testfail

Debug DekSpec TESTFAIL symptoms using Agans' nine rules and persisted state.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/Dektora/dekspec-public --skill debug-testfail
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-testfail
Source: https://github.com/Dektora/dekspec-public/tree/main/plugins/dekspec/skills/debug-testfail
Command: npx skills add https://github.com/Dektora/dekspec-public --skill debug-testfail

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill aids in debugging DekSpec TESTFAIL symptoms by applying Agans' nine rules of debugging and persisting the investigation state.

Core Features & Use Cases

  • Resumable Debugging: Continues debugging sessions even after context resets.
  • Nine-Rules Protocol: Applies Agans' debugging rules to a TESTFAIL symptom.
  • Audit Trail: Persists investigation state to a durable file.
  • Use Case: When a regression is observed in an Intent, this Skill can be used to diagnose the root cause by following the debugging protocol and keeping an audit trail.

Quick Start

Run the debugging loop for a TESTFAIL symptom using the command: /dekspec:debug-testfail --diagnose --at .

Frequently Asked Questions about debug-testfail

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

FAQPage Schema
How do I debug a DekSpec TESTFAIL symptom after a context reset?

Debug a DekSpec TESTFAIL symptom by applying Agans' nine rules of debugging and persisting investigation state to a durable file. This resumable loop lets you continue diagnosing root causes even after your session resets.

What is Agans' nine rules of debugging protocol for regression analysis?

Agans' nine rules protocol systematically isolates regression root causes by verifying the failure, tracking state changes, and persisting an audit trail. It diagnoses DekSpec TESTFAIL symptoms while maintaining a durable investigation record.

Can I resume a debugging session for a DekSpec workflow regression?

Yes, you can resume debugging a DekSpec workflow regression by loading the persisted debug state files. The audit trail captures your investigation state, letting you continue diagnosis without losing prior progress.

Do I need claude-opus-4-7 to run the debug-testfail protocol?

Yes, the debug-testfail protocol requires the Claude Code 'claude-opus-4-7' model and access to debug state files. These prerequisites support the advanced reasoning needed for regression analysis.

How do I diagnose a regression issue in a DekSpec Intent step by step?

Diagnose a regression issue in a DekSpec Intent by running `/dekspec:debug-testfail --diagnose --at .` from your project root. This initiates the debugging loop, applying the nine-rules protocol and persisting an audit trail.

Why is my DekSpec TESTFAIL debugging loop losing context between sessions?

A DekSpec TESTFAIL debugging loop loses context if investigation state is not persisted. This Skill solves that by writing an audit trail to durable debug state files, ensuring resumable regression analysis across resets.