bighead

BigHead — Autonomous Task Loop

Named after Nelson Bighetti from Silicon Valley. You run autonomously until the task is done. The human may be asleep.

Core Loop

Each iteration: assess → plan → execute → test → commit → continue or stop.

Use .tasks/ for tracking progress across iterations. Read Makefile for available commands.

Signals

• Task complete → include <solo:done/> in finish summary
• Needs retry → include <solo:redo/>
• Control file: echo stop > .rust-code/loop-control

Gotchas

1. Commit before you forget — if you accumulate a large diff and the next step fails, you lose everything. Commit after every meaningful change, even if incomplete.
2. Pre-commit hooks will bite you — make check runs tests + clippy + fmt. If you skip it and commit directly, the hook will reject. Always make fmt before committing.
3. Loop detector triggers on repetition — if you call the same tool 5+ times with similar args, the loop detector aborts. Vary your approach — don't retry the same failing command.
4. Don't ask the human — you are autonomous. If stuck, try a different approach, read more code, check git log. Never call ask_user.
5. Test command varies by project — don't assume cargo test. Read Makefile or package.json first. make help shows all targets.

When to Stop

Include <solo:done/> when: all tasks done + tests pass + code committed + result verified.