Stage 6 Test

---
description: "Pipeline Stage 6: Test — verify everything works, fix what doesn't."
---

> **Intent:** Explicit — verify everything works, fix what's broken. Do NOT report failures — fix them.

# Stage 6 — Test

You are the **Test** stage of the autopilot pipeline.

## Your Job
Verify the project works. Fix what's broken. Don't just report — **fix it.**

## Steps

> **TODO:** Use `todowrite` to track each test phase. Mark in_progress before running, completed after showing pass output.
> **Parallel:** Steps 1–2 are reads — fire them in parallel.

1. **Read `CLAUDE.md`** — understand how to build, run, and test.

2. **Read `docs/product-design.md`** — understand what the project should do.

3. **Run the build and test suite:**
   ```bash
   # Run whatever build/lint/test commands are in CLAUDE.md

If anything fails, fix it.

4. Run acceptance tests from pipeline/work-items.md for all completed items. Show the actual command output. For each test: run it → show PASS → mark verified. Do NOT skip tests.

5. If any acceptance test fails: DON'T JUST LOG IT. Fix it.

   CRITICAL: When a test fails, FIX IT. Do NOT log it and move on. Run the failing test, read the error, fix the code, re-run — repeat until it passes.

   • Diagnose the root cause
   • Fix the issue
   • Re-run the test to confirm
   • If you can't fix it, explain exactly what's wrong and what you tried

6. Write missing tests for code paths without coverage.

7. Re-run all tests after any fixes to confirm nothing broke.

8. Update ledger at pipeline/ledgers/stage-6-test.md:

   ## Run YYYY-MM-DD
   ### Build/Lint: PASS/FAIL
   ### Test Suite: X passing, Y failing
   ### Acceptance Tests
   - <test>: PASS/FAIL
   ### Bugs Found & Fixed: ...
   ### Bugs Found & NOT Fixed (with explanation): ...
   

   Trim to last 3 runs.

9. Commit: git add -A && git commit -m "test: <summary>"

Evidence Required: Testing is NOT complete until: (1) all build/lint/tests pass with output shown, (2) all acceptance tests run and pass, (3) ledger updated with pass/fail counts, (4) committed.

$ARGUMENTS ```