systematic-debugging

Diagnose EVA failures by reproducing errors, finding root causes, and verifying fixes with tests.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/raulisai/eva02 --skill systematic-debugging-raulisai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/raulisai/eva02/tree/main/apps/eva-core/src/skills/software-development/systematic-debugging
Command: npx skills add https://github.com/raulisai/eva02 --skill systematic-debugging-raulisai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging failures in the EVA platform often leads to guesswork, overly broad fixes, or changes that bypass safety mechanisms like the Approval Engine. This Skill enforces a disciplined process that reproduces the failure, isolates the root cause, and proves the fix with tests. ## Core Features & Use Cases - Structured Debugging Process: Follows a six-step workflow from reading the exact error to running focused and broader verification tests. - EVA-Specific Safety Checks: Verifies tenant boundaries, RLS and auth behavior, task state machine integrity, and Approval Engine compliance during debugging. - Runtime Safety Policy: Requires explicit approval before debugging production systems, tenant data, secrets, or destructive state. - Use Case: A NestJS service test fails after a migration. Use this Skill to reproduce the failure with the smallest command, identify the root cause in the data access layer, write a failing test, apply a minimal fix, and confirm tenant isolation is preserved. ## Quick Start Use the systematic-debugging skill to investigate this failing test, find the root cause, and fix it with a verified minimal change.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I debug a failing test systematically?

Start by reading the exact error and relevant logs, then reproduce the failure with the smallest possible command or test. Identify the root cause in code or configuration, write a failing test to protect the behavior, apply the smallest fix, and run focused then broader verification.

How to debug runtime errors in a NestJS backend?

Reproduce the runtime error with a minimal reproduction, trace the root cause in service logic or configuration, and fix it narrowly. In EVA, check RLS and auth behavior separately from service logic and preserve the task state machine.

Can I debug production tenant data with this Skill?

Debugging production systems, tenant data, secrets, or destructive state requires explicit approval under the EVA Runtime Skill Policy. Always confirm tenant boundaries when the bug touches data access.

Why should I not bypass the Approval Engine when fixing bugs?

Bypassing the Approval Engine papers over approval failures instead of fixing their root cause, which can hide real defects and weaken platform safety. The correct approach is to diagnose why the approval failed and fix that behavior directly.

When should I write a failing test during debugging?

Write or update a failing test when the behavior should be protected against regression. The test proves the bug exists before the fix and confirms the fix resolves it afterward.