From e5a356d8f1eff3770796198c7132fd6766bb3f5f Mon Sep 17 00:00:00 2001
From: gastown/crew/kerosene <gastown-crew-kerosene@gastown.local>
Date: Thu, 22 Jan 2026 19:58:35 -0800
Subject: [PATCH] feat: add bd tree to Key Commands in gt prime output

- Add `bd tree <id>` to Key Commands in bd prime template (beads.go)
- Add `bd tree <issue>` to prime_output.go for mayor/polecat/crew roles
- Helps agents understand bead ancestry, siblings, and dependencies

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 internal/beads/beads.go      | 1 +
 internal/cmd/prime_output.go | 3 +++
 2 files changed, 4 insertions(+)

diff --git a/internal/beads/beads.go b/internal/beads/beads.go
index b8014599..f8e6b420 100644
--- a/internal/beads/beads.go
+++ b/internal/beads/beads.go
@@ -747,6 +747,7 @@ This is physics, not politeness. Gas Town is a steam engine - you are a piston.
 - ` + "`gt mol status`" + ` - Check your hooked work
 - ` + "`gt mail inbox`" + ` - Check for messages
 - ` + "`bd ready`" + ` - Find available work (no blockers)
+- ` + "`bd tree <id>`" + ` - View bead ancestry, siblings, and dependencies
 - ` + "`bd sync`" + ` - Sync beads changes
 
 ## Session Close Protocol
diff --git a/internal/cmd/prime_output.go b/internal/cmd/prime_output.go
index 04ae9e0f..df6b6b51 100644
--- a/internal/cmd/prime_output.go
+++ b/internal/cmd/prime_output.go
@@ -113,6 +113,7 @@ func outputMayorContext(ctx RoleContext) {
 	fmt.Println("- `gt status` - Show overall town status")
 	fmt.Println("- `gt rig list` - List all rigs")
 	fmt.Println("- `bd ready` - Issues ready to work")
+	fmt.Println("- `bd tree <issue>` - View ancestry, siblings, dependencies")
 	fmt.Println()
 	fmt.Println("## Hookable Mail")
 	fmt.Println("Mail can be hooked for ad-hoc instructions: `gt hook attach <mail-id>`")
@@ -176,6 +177,7 @@ func outputPolecatContext(ctx RoleContext) {
 	fmt.Println("## Key Commands")
 	fmt.Println("- `gt mail inbox` - Check your inbox for work assignments")
 	fmt.Println("- `bd show <issue>` - View your assigned issue")
+	fmt.Println("- `bd tree <issue>` - View ancestry, siblings, dependencies")
 	fmt.Println("- `bd close <issue>` - Mark issue complete")
 	fmt.Println("- `gt done` - Signal work ready for merge")
 	fmt.Println()
@@ -200,6 +202,7 @@ func outputCrewContext(ctx RoleContext) {
 	fmt.Println("- `gt mail inbox` - Check your inbox")
 	fmt.Println("- `bd ready` - Available issues")
 	fmt.Println("- `bd show <issue>` - View issue details")
+	fmt.Println("- `bd tree <issue>` - View ancestry, siblings, dependencies")
 	fmt.Println("- `bd close <issue>` - Mark issue complete")
 	fmt.Println()
 	fmt.Println("## Hookable Mail")