Polecat template cleanup (gt-t9u7)

- Rename "Dependency Trap" to "Gotchas when Filing Beads" in all 6 role templates
- Fix "git clone" to "git worktree" in polecat template
- Simplify completion section to just "gt done"
- Condense Work Protocol section (let molecule define steps)
- Simplify "Before Signaling Done" to trust gt done internals
- Clarify work status: use "gt mol status" as primary command

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Steve Yegge
2025-12-23 17:08:55 -08:00
parent f6b099eb14
commit 1931ec736a
6 changed files with 16 additions and 43 deletions

View File

@@ -50,7 +50,7 @@ You work from: {{ .WorkDir }}
This is a full git clone of the project repository. You have complete autonomy This is a full git clone of the project repository. You have complete autonomy
over this workspace. over this workspace.
## Dependency Trap ## Gotchas when Filing Beads
**Temporal language inverts dependencies.** "Phase 1 blocks Phase 2" is backwards. **Temporal language inverts dependencies.** "Phase 1 blocks Phase 2" is backwards.
- WRONG: `bd dep add phase1 phase2` (temporal: "1 before 2") - WRONG: `bd dep add phase1 phase2` (temporal: "1 before 2")

View File

@@ -38,7 +38,7 @@ Go Daemon (watches you, auto-starts you if down)
patrol cycle is a wisp that gets squashed to a digest when complete. This keeps patrol cycle is a wisp that gets squashed to a digest when complete. This keeps
beads clean while maintaining an audit trail. beads clean while maintaining an audit trail.
## Dependency Trap ## Gotchas when Filing Beads
**Temporal language inverts dependencies.** "Phase 1 blocks Phase 2" is backwards. **Temporal language inverts dependencies.** "Phase 1 blocks Phase 2" is backwards.
- WRONG: `bd dep add phase1 phase2` (temporal: "1 before 2") - WRONG: `bd dep add phase1 phase2` (temporal: "1 before 2")

View File

@@ -42,7 +42,7 @@ Town ({{ .TownRoot }})
- The rig-level `<rig>/.beads/` is **gitignored** (local runtime state) - The rig-level `<rig>/.beads/` is **gitignored** (local runtime state)
- Rig beads use `beads-sync` branch for multi-clone coordination - Rig beads use `beads-sync` branch for multi-clone coordination
## Dependency Trap ## Gotchas when Filing Beads
**Temporal language inverts dependencies.** "Phase 1 blocks Phase 2" is backwards. **Temporal language inverts dependencies.** "Phase 1 blocks Phase 2" is backwards.
- WRONG: `bd dep add phase1 phase2` (temporal: "1 before 2") - WRONG: `bd dep add phase1 phase2` (temporal: "1 before 2")

View File

@@ -36,11 +36,11 @@ Town ({{ .TownRoot }})
| Rig | `polecats/{{ .Polecat }}/.beads/` | `beads-sync` | project prefix | Project issues | | Rig | `polecats/{{ .Polecat }}/.beads/` | `beads-sync` | project prefix | Project issues |
**Key points:** **Key points:**
- You're in a project git clone - your `.beads/` is tracked in the project repo - You're in a project git worktree - your `.beads/` is tracked in the project repo
- The rig-level `{{ .RigName }}/.beads/` is **gitignored** (local runtime state) - The rig-level `{{ .RigName }}/.beads/` is **gitignored** (local runtime state)
- Run `bd sync` to push/pull beads changes via the `beads-sync` branch - Run `bd sync` to push/pull beads changes via the `beads-sync` branch
## Dependency Trap ## Gotchas when Filing Beads
**Temporal language inverts dependencies.** "Phase 1 blocks Phase 2" is backwards. **Temporal language inverts dependencies.** "Phase 1 blocks Phase 2" is backwards.
- WRONG: `bd dep add phase1 phase2` (temporal: "1 before 2") - WRONG: `bd dep add phase1 phase2` (temporal: "1 before 2")
@@ -58,8 +58,8 @@ Town ({{ .TownRoot }})
## Key Commands ## Key Commands
### Your Work ### Your Work
- `bd show <issue>` - View your assigned issue - `gt mol status` - Check your hooked molecule (primary work source)
- `bd list --status=in_progress` - Your active work - `bd show <issue>` - View specific issue details
### Progress ### Progress
- `bd update <id> --status=in_progress` - Claim work - `bd update <id> --status=in_progress` - Claim work
@@ -78,9 +78,7 @@ bd create --title="gt session capture: Support positional line count" --type=tas
Agent-friendly UX is critical. Your guesses reveal what's intuitive. Agent-friendly UX is critical. Your guesses reveal what's intuitive.
### Completion ### Completion
- `gt done` - Signal work ready for merge queue (preferred) - `gt done` - Signal work ready for merge queue (handles beads sync internally)
- `gt handoff` - Also works (redirects to `gt done` for polecats)
- `bd sync` - Sync beads changes
## Startup Protocol: Propulsion ## Startup Protocol: Propulsion
@@ -111,43 +109,18 @@ hook with all your steps. Resume from the next unclosed step and execute.
## Work Protocol ## Work Protocol
Your work follows the **mol-polecat-work** molecule steps: Your work follows the **mol-polecat-work** molecule. As you complete each step:
1. **load-context** - Run `gt prime`, read your assignment
2. **implement** - Write the solution, make commits
3. **self-review** - Check for bugs, style issues
4. **verify-tests** - Run tests, fix any failures
5. **rebase-main** - Rebase on origin/main
6. **submit-merge** - Run `gt done` to submit to merge queue
7. **generate-summary** - Write a summary of what you did
8. **request-shutdown** - Signal done, Witness cleans you up
As you complete each step, close it:
```bash ```bash
bd close <step-id> bd close <step-id> # Mark step complete
bd ready --parent=<mol-id> # See next step bd ready # See next step
``` ```
When finished, squash the molecule: When all steps are done, the molecule gets squashed automatically when you run `gt done`.
```bash
bd mol squash <mol-id> --summary="Implemented X, tests pass, ready for merge"
```
## Before Signaling Done ## Before Signaling Done
Run this checklist: Run `gt done` when your work is complete. It verifies git is clean, syncs beads,
and submits your branch to the merge queue. The Witness handles the rest.
```
[ ] git status clean (no uncommitted changes)
[ ] Tests pass (if applicable)
[ ] bd close <issue> (issue marked complete)
[ ] bd sync (beads synced)
```
**DO NOT push your branch to origin.** The `gt done` command handles submission
to the merge queue. The Refinery will merge your work to main.
The Witness will verify git state is clean before killing your session.
## If You're Stuck ## If You're Stuck

View File

@@ -46,7 +46,7 @@ Town ({{ .TownRoot }})
│ └── witness/ ← Worker lifecycle │ └── witness/ ← Worker lifecycle
``` ```
## Dependency Trap ## Gotchas when Filing Beads
**Temporal language inverts dependencies.** "Phase 1 blocks Phase 2" is backwards. **Temporal language inverts dependencies.** "Phase 1 blocks Phase 2" is backwards.
- WRONG: `bd dep add phase1 phase2` (temporal: "1 before 2") - WRONG: `bd dep add phase1 phase2` (temporal: "1 before 2")

View File

@@ -49,7 +49,7 @@ You're part of a self-monitoring village, not a rigid hierarchy:
This is an ant colony where ants help each other recover. You don't just watch This is an ant colony where ants help each other recover. You don't just watch
polecats - you're part of a network where everyone watches everyone. polecats - you're part of a network where everyone watches everyone.
## Dependency Trap ## Gotchas when Filing Beads
**Temporal language inverts dependencies.** "Phase 1 blocks Phase 2" is backwards. **Temporal language inverts dependencies.** "Phase 1 blocks Phase 2" is backwards.
- WRONG: `bd dep add phase1 phase2` (temporal: "1 before 2") - WRONG: `bd dep add phase1 phase2` (temporal: "1 before 2")