agentleFS
roedyrustamroedyrustam/vibes-plug/skills/autonomous-tdd-debugger/SKILL.md

autonomous-tdd-debugger

Skill75 starsChanged 38 days agoMITView on GitHub

Empowers the agent to autonomously run tests, read terminal stack traces, and self-heal code until tests pass. Transforms the agent from a passive coder to an active CI pipeline debugger.

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 3 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Heal Recursively: If it fails, do NOT stop and ask the user for help.

    line 35
  2. Very specific:

    Report: Only when exit code 0 is achieved does the agent stop and report success to the user.

    line 36
  3. Distinctive:

    Zero-Human Intervention: Do NOT ask the user "Please run this and tell me the error." You are fully authorized and mandated to run it …

    line 39
  4. Distinctive:

    Avoid modifying the test files to make them pass unless the test itself is fundamentally flawed or outdated.

    line 40
  5. Very specific:

    If a terminal command hangs, use kill on the task and try again with a timeout.

    line 41
  6. Very specific:

    Zero-Slop Test & Fix Enforcement (anti-slop): Never write dummy assertions (expect(true).toBe(true)), never comment out or skip failing …

    line 42

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Autonomous TDD Debugger & Self-Healing Agent

English | Bahasa Indonesia


<a name="english"></a>

English

Orchestration & Integration

Connects and orchestrates with relevant domain skills like brainstorming, zero-to-prod-orchestrator, and session-memory-manager to ensure cohesive execution.

Description

This skill transforms the AI from a passive code generator into an active, autonomous engineer. When triggered, the agent is mandated to execute tests, read stack traces directly from the terminal, and modify code autonomously in a loop until all tests pass (Test-Driven Development) without asking the user to manually test.

Trigger Conditions

Activate this skill when the user asks to:

  • Fix failing tests or bugs without providing the error log.
  • "Write the code and ensure it works."
  • "Debug this completely autonomously."

Core Concepts

1. The Autonomous Proactive Loop

  1. Write/Modify Code: The agent modifies the application files.
  2. Execute: The agent uses run_command (e.g., npm run test, cargo test, pytest).
  3. Analyze: The agent reads the stdout/stderr from the background task.
  4. Heal Recursively: If it fails, do NOT stop and ask the user for help. The agent MUST parse the stack trace, identify the line number, apply a fix, and loop back to Step 2. Continue this cycle autonomously in the background.
  5. Report: Only when exit code 0 is achieved does the agent stop and report success to the user.

2. Agent Constraints

  • Zero-Human Intervention: Do NOT ask the user "Please run this and tell me the error." You are fully authorized and mandated to run it yourself iteratively until it works.
  • Avoid modifying the test files to make them pass unless the test itself is fundamentally flawed or outdated. Fix the implementation first.
  • If a terminal command hangs, use kill on the task and try again with a timeout.
  • Zero-Slop Test & Fix Enforcement (anti-slop): Never write dummy assertions (expect(true).toBe(true)), never comment out or skip failing tests to fake exit code 0, and never insert fake mock returns in production code. The fix must be complete and real.

Integration with Other Skills (MANDATORY)

  • e2e-testing-expert — Provides the exact testing frameworks (Vitest, Playwright) that this agent will execute.
  • error-resilience-expert — Helps the agent understand what architecture patterns to apply when fixing an error.
  • session-memory-manager — Allows the agent to find where the failing component is located in large codebases.

Referenced By Orchestrators (MANDATORY)

  • brainstorming — Add to "Testing & Security".
  • zero-to-prod-orchestrator — Phase 6 (Automated Testing).

<a name="bahasa-indonesia"></a>

Bahasa Indonesia

Integrasi Orkestrasi

Terhubung dan mengorkestrasi skill domain yang relevan seperti brainstorming, zero-to-prod-orchestrator, dan session-memory-manager untuk memastikan eksekusi yang kohesif.

Deskripsi

Memberdayakan agen AI untuk menjalankan test, membaca stack trace di terminal, dan menyembuhkan (self-heal) kode secara mandiri hingga sukses. Mengubah agen dari sekadar penulis kode pasif menjadi debugger aktif.

Kondisi Pemicu

  • Pengguna meminta untuk memperbaiki bug tetapi tidak memberikan log error.
  • Pengguna meminta agen untuk memastikan kode yang ditulis benar-benar berjalan (bukan sekadar teori).

Panduan Singkat

  • Jangan Meminta Bantuan User (Zero-Human Intervention): Jangan pernah berkata "Tolong jalankan kode ini dan berikan saya error-nya." Anda memiliki alat run_command untuk menjalankannya sendiri secara berulang (rekursif) dalam background hingga sukses.
  • Siklus Mandiri: Tulis Kode ➔ Jalankan Test (via run_command) ➔ Baca Output Terminal ➔ Perbaiki Kode ➔ Ulangi hingga exit code 0 (Sukses).
  • Hargai File Test: Kecuali test file-nya memang salah konfigurasi, usahakan perbaiki kode implementasinya, bukan memanipulasi test agar hijau.
  • Penegakan Anti-Slop Mutlak (anti-slop): Dilarang keras menulis asersi tiruan (expect(true).toBe(true)), dilarang me-skip atau menonaktifkan test gagal demi memalsukan exit code 0, dan dilarang menyisipkan mock return palsu ke kode produksi. Perbaikan harus tuntas dan nyata.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.