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:
@@ -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")
|
||||||
|
|||||||
@@ -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")
|
||||||
|
|||||||
@@ -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")
|
||||||
|
|||||||
@@ -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
|
||||||
|
|
||||||
|
|||||||
@@ -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")
|
||||||
|
|||||||
@@ -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")
|
||||||
|
|||||||
Reference in New Issue
Block a user