skills: autoresearch

.agents/skills/autoresearch/references/debug-workflow.md

@@ -0,0 +1,25 @@
+# `autoresearch debug` mode — Autonomous Debug Loop
+
+This workflow is triggered by the `debug` mode. It is designed to reproduce, isolate, and fix specific bugs autonomously.
+
+## Context
+Use this when something is clearly broken (e.g., a failing test, a crash, or a UI bug).
+
+## Phase 1: Reproduction
+1. Create a minimal reproduction script (e.g., `debug/repro.js` or a new test case).
+2. Run the repro script and verify it fails as expected.
+3. This repro command becomes your `Verify` command for the loop.
+
+## Phase 2: Isolation
+1. Use `Grep` and `Read` to find the code responsible for the failure.
+2. Form a hypothesis about the root cause.
+
+## Phase 3: Fix Loop
+1. Start a standard autoresearch loop with:
+   - **Goal**: Fix the bug identified in the repro script.
+   - **Verify**: The repro command (must exit 0 on success).
+   - **Guard**: Existing test suite and linting.
+
+## Phase 4: Hardening
+1. After the fix is verified, add a permanent regression test to the codebase.
+2. Verify that the fix holds across the entire project.