claws-auto-enginelisted

# claws-auto-engine ## What this is The engine backing `/claws-auto`. Runs a bounded wave loop (≤6 waves, ≤90 min): plan workers → dispatch → audit → repeat until goal met or budget exhausted. Coordinates plain workers, LEADs, titans, and legions. ## When to invoke Invoked automatically by [[claws-auto]]. Activates when the user grants open-ended autonomy ("keep working", "don't stop") or the task spans multiple waves. Not called directly. ## When NOT to invoke - Single-wave tasks → use [[claws-do]] directly. - Need user decision before proceeding → surface and wait. - Budget exhausted (6 waves / 90 min) → write BLOCKED section and halt. - Destructive or irreversible actions → always gate on explicit confirmation. ## Decision tree ``` startedAt = now(); waveNum = 1; budget = {maxWaves:6, maxMin:90} while not goalMet and not budgetExhausted: workers = planWave(waveNum) // max 4 workers dispatch + Monitor-arm each worker wait for all Monitors to exit auditWave → events.log + pty logs + git log update PROGRESS.md if fatalFailure → recovery wave (max 1 per wave) waveNum++; budgetExhausted = waveNum>6 or elapsed>90min writeFinalSection(DONE or BLOCKED) ``` **Class rules — per-iteration picker (scope × duration × parallelism → class, first match wins):** | Class | Tool | Model | Pick when | |-------|------|-------|-----------| | Shell | `claws_exec` | — | ≤1 read-only command, ≤2 min, no peer identity needed | | Worker | `claws_worker` | sonnet | ≤5