Qa Loop

Decision Tree

Run this on every tick:

0. READ STATE FILE (tmp/qa-loop-state.md)
   ├─ File exists + status: IN_PROGRESS → RESUME current_task (skip to step 6)
   ├─ File exists + status: BLOCKED → Check if unblocked, else try next_priority
   └─ File missing OR status: IDLE → Continue to step 1

1. IS THIS A SOFTWARE PROJECT?
   ├─ No → Log "not a software project, skipping" → IDLE
   └─ Yes ↓

2. READ PROJECT STATE
   Read: package.json (or equivalent), recent git log, tmp/qa-report.md (if exists),
         any task files, TODO/FIXME comments, open issues.
   Determine: What exists? What's expected? What's the gap?

3. IS THERE UNFINISHED DEV WORK?
   Check: failing tests, incomplete features, TODOs from plan, empty stub files,
          placeholder content, unimplemented routes.
   ├─ Yes → BRANCH: DEV (load domains/dev.md, pick highest-impact incomplete task, work it)
   └─ No ↓

4. HAS ANYTHING CHANGED SINCE LAST QA PASS?
   Compare: git diff since last qa-report timestamp, new commits, modified files.
   ├─ No changes + last QA was clean → Log "no changes, idle" → IDLE
   └─ Changes exist OR no prior QA ↓

5. BRANCH: QA
   Load domains/qa.md. Run the highest-priority applicable QA task:
   Visual regression → Functional → Responsive → Performance →
   Accessibility → Dead code → Links → Security.
   Do ONE category per tick — thorough beats broad.

6. WRITE STATE FILE
   After completing any action (DEV, QA, or IDLE), write tmp/qa-loop-state.md with
   current status. If task completed this tick, set status: IDLE and populate
   next_priority. If task is still in progress, set status: IN_PROGRESS with
   detailed current_task_detail so the next tick can resume without re-discovery.

Rules

• Resume before re-evaluate. If the state file says IN_PROGRESS, your job is to continue that work — not to re-scan the project and pick something new. This is the #1 cause of overnight stalls: each tick "discovers" work, starts fresh, and never finishes anything.
• One action per tick. Don't try to do everything in one pass. Pick the single highest-impact action and do it well. The loop runs again in an hour.
• Always log. Every tick appends to tmp/qa-report.md — even idle ticks get a one-line entry. This is your paper trail.
• Always write state. Every tick ends by writing tmp/qa-loop-state.md. No exceptions. This is your handoff to your future self. If you skip this, the next tick starts blind.
• Never declare done. There is no "all QA complete" state. There's always something to verify again, especially after any dev work.
• Visual verification is mandatory. If the project has a UI, every QA tick must include at least one screenshot. Code reading is not verification.
• Fix safe things, flag risky things. Auto-fix: missing alt text, obvious typos, unused imports. Flag for human: layout changes, feature decisions, architectural concerns.
• Respect the dev domain. When branching to dev work, follow TDD and the full agent pipeline. Don't take shortcuts because this is an automated loop.
• Be skeptical by default. "Looks fine" is not a finding. "Screenshot at tmp/qa-pass-3-home-mobile.png shows correct layout at 375px" is a finding.
• Finish what you started. A half-done task continued next tick is worth more than two tasks started and abandoned. If a task will take multiple ticks, that's fine — write detailed state and keep going.

Focus Mode

If invoked with an argument (e.g., /qa-loop focus on responsive layout), weight that concern heavily in the decision tree. Still run the full evaluation, but prioritize the focus area when choosing which action to take.

Report Format

## [ISO timestamp] — Tick #N
Decision: DEV | QA | IDLE
Reason: [why this branch was chosen]
Action: [what was done]
Result: [outcome, with screenshot paths if applicable]
Next: [what the next tick should prioritize]

Anti-Patterns (things this loop prevents)

• Amnesiac ticks: Each tick re-discovers the project from scratch, picks a new task, never finishes anything. Fix: read state file first, resume in-progress work.
• Idle stalling: Claude finishes a task (or gets confused) and sits idle for 8 hours. Fix: state file always has next_priority; IDLE with no next_priority means scan for work.
• Perpetual re-evaluation: Spending the entire tick analyzing what to do, running out of context before doing it. Fix: state file gives you the answer — just resume.
• "All tests pass" declared as success when no visual verification happened.
• Responsive design claimed without testing at actual mobile widths.
• Performance regressions accumulating because nobody ran Lighthouse.
• Dead code and unused dependencies piling up between features.