docs: improve help text and add nudge documentation
Polish help text across all agent commands to clarify roles: - crew: persistent workspaces vs ephemeral polecats - deacon: town-level watchdog receiving heartbeats - dog: cross-rig infrastructure workers (cats vs dogs) - mayor: Chief of Staff for cross-rig coordination - nudge: universal synchronous messaging API - polecat: ephemeral one-task workers, self-cleaning - refinery: merge queue serializer per rig - witness: per-rig polecat health monitor Add comprehensive gt nudge documentation to crew template explaining when to use nudge vs mail, common patterns, and target shortcuts. Add orphan-process-cleanup step to deacon patrol formula to clean up claude subagent processes that fail to exit (TTY = "?"). Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -40,14 +40,22 @@ var dogCmd = &cobra.Command{
|
||||
Use: "dog",
|
||||
Aliases: []string{"dogs"},
|
||||
GroupID: GroupAgents,
|
||||
Short: "Manage dogs (Deacon's helper workers)",
|
||||
Long: `Manage dogs in the kennel.
|
||||
Short: "Manage dogs (cross-rig infrastructure workers)",
|
||||
Long: `Manage dogs - reusable workers for infrastructure and cleanup.
|
||||
|
||||
Dogs are reusable helper workers managed by the Deacon for infrastructure
|
||||
and cleanup tasks. Unlike polecats (single-rig, ephemeral), dogs handle
|
||||
cross-rig infrastructure work with worktrees into each rig.
|
||||
CATS VS DOGS:
|
||||
Polecats (cats) build features. One rig. Ephemeral (one task, then nuked).
|
||||
Dogs clean up messes. Cross-rig. Reusable (multiple tasks, eventually recycled).
|
||||
|
||||
The kennel is located at ~/gt/deacon/dogs/.`,
|
||||
Dogs are managed by the Deacon for town-level work:
|
||||
- Infrastructure tasks (rebuilding, syncing, migrations)
|
||||
- Cleanup operations (orphan branches, stale files)
|
||||
- Cross-rig work that spans multiple projects
|
||||
|
||||
Each dog has worktrees into every configured rig, enabling cross-project
|
||||
operations. Dogs return to idle state after completing work (unlike cats).
|
||||
|
||||
The kennel is at ~/gt/deacon/dogs/. The Deacon dispatches work to dogs.`,
|
||||
}
|
||||
|
||||
var dogAddCmd = &cobra.Command{
|
||||
|
||||
Reference in New Issue
Block a user