What problem does it solve?
This Skill automates the tedious and error-prone process of repeatedly running a test suite, diagnosing failures, applying minimal implementation fixes, and re-running until the suite is green or a safe termination condition is reached.
Core Features & Use Cases
- Automated test runner detection: Locates the project test command from common manifests and accepts a custom command when provided.
- Safe checkpointing and rollback: Creates commit checkpoints before fixes and reverts on regressions, circular fixes, or non-convergence to protect the working tree.
- Failure clustering and diagnostics: Summarizes failures, clusters by module, reads tests and implementation to identify root causes before changing code.
- Controlled iterative fixes: Applies changes only to implementation code, never to test files, and enforces a max iteration limit and multiple termination conditions.
- Use Case: Recover a repository where a recent change caused widespread test failures by automatically diagnosing top failing modules, applying targeted fixes, and stopping if progress stalls.
Quick Start
Run the test-fix-loop skill with the detected test command and an iteration limit to automatically diagnose failures and apply minimal implementation fixes until tests pass.