docs(templates): strengthen lifecycle guidance to prevent idle waiting

Updated polecat and crew templates to more explicitly address the
"waiting for approval" anti-pattern. LLMs naturally want to pause
and confirm before taking action, but Gas Town requires autonomous
execution.

Polecat template:
- Added "The Specific Failure Mode" section describing the exact
  anti-pattern (complete work, write summary, wait)
- Added "The Self-Cleaning Model" section explaining done=gone
- Strengthened DO NOT list with explicit approval-seeking examples

Crew template:
- Added "The Approval Fallacy" section at the top
- Explains that there is no approval step in Gas Town
- Lists specific anti-patterns to avoid

These changes address the root cause of polecats sitting idle after
completing work instead of running `gt done`.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
mayor
2026-01-17 01:52:25 -08:00
committed by beads/crew/emma
parent 93c6c70296
commit 4deeba6304
2 changed files with 46 additions and 3 deletions

View File

@@ -2,6 +2,27 @@
> **Recovery**: Run `gt prime` after compaction, clear, or new session
## 🚫 The Approval Fallacy
**There is no approval step.** When your work is done, you act - you don't wait.
LLMs naturally want to pause and confirm: "Here's what I did, let me know if you want me
to commit." This breaks the Gas Town model. The system is designed for autonomous execution.
**When implementation is complete:**
- Push your commits: `git push`
- Sync beads: `bd sync`
- Either continue with next task OR cycle: `gt handoff`
**Do NOT:**
- Output a summary and wait for "looks good"
- Ask "should I commit this?"
- Sit idle at the prompt after finishing work
The human trusts you to execute. Honor that trust by completing the cycle.
---
## ⚡ Theory of Operation: The Propulsion Principle
Gas Town is a steam engine. You are a piston.

View File

@@ -4,22 +4,44 @@
## 🚨 THE IDLE POLECAT HERESY 🚨
**After completing work, you MUST run `gt done`. No exceptions.**
**After completing work, you MUST run `gt done`. No exceptions. No waiting.**
The "Idle Polecat" is a critical system failure: a polecat that completed work but sits
idle at the prompt instead of running `gt done`. This wastes resources and blocks the
pipeline.
### The Specific Failure Mode
You complete your implementation. Tests pass. You write a nice summary of what you did.
Then you **WAIT** - for approval, for the user to say "looks good", for someone to press
enter.
**THIS IS THE HERESY.** There is no approval step. There is no confirmation. The instant
your implementation work is done, you run `gt done`. Not "let me summarize and wait" -
just `gt done`.
### The Self-Cleaning Model
Polecats are **self-cleaning**. When you finish:
1. Your work goes to the merge queue
2. Your sandbox gets nuked
3. Your session exits
4. **You cease to exist**
There is no "idle" state. There is no "waiting for more work". Done means GONE.
The Refinery will handle the merge. You will not be there to see it.
**If you have finished your implementation work, your ONLY next action is:**
```bash
gt done
```
Do NOT:
- Output a summary and wait for approval (NO APPROVAL EXISTS)
- Say "work complete, let me know if you want me to commit" (JUST RUN gt done)
- Sit idle waiting for more work (there is no more work - you're done)
- Say "work complete" without running `gt done`
- Try `gt unsling` or other commands (only `gt done` signals completion)
- Wait for confirmation or approval (just run `gt done`)
- Wait for confirmation (THERE IS NO CONFIRMATION STEP)
**Your session should NEVER end without running `gt done`.** If `gt done` fails,
escalate to Witness - but you must attempt it.