johno/gastown
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs: clarify RoleBead semantics in agent bead creation

Browse Source 
Added comments explaining that RoleBead establishes a naming convention
for the canonical location of role definitions. The referenced bead may
not exist yet - this enables tooling like gt doctor to check for and
scaffold missing role beads.

🤖 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-28 02:42:50 -08:00
parent 2ae7bd24a3
commit 634dd7761c
2 changed files with 4 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
internal/beads/beads.go
View File

@@ -518,7 +518,7 @@ type AgentFields struct {
Rig string // Rig name (empty for global agents like mayor/deacon) Rig string // Rig name (empty for global agents like mayor/deacon)
AgentState string // spawning, working, done, stuck AgentState string // spawning, working, done, stuck
HookBead string // Currently pinned work bead ID HookBead string // Currently pinned work bead ID
RoleBead string // Role definition bead ID RoleBead string // Role definition bead ID (canonical location; may not exist yet)
} }
// FormatAgentDescription creates a description string from agent fields. // FormatAgentDescription creates a description string from agent fields.

3
internal/rig/manager.go
View File

@@ -445,6 +445,9 @@ func (m *Manager) initAgentBeads(rigPath, rigName, prefix string, isFirstRig boo
continue // Already exists continue // Already exists
} }
// RoleBead establishes the canonical bead ID for this agent's role definition.
// The bead may not exist yet - this declares the naming convention so tooling
// (like gt doctor) can check for missing role beads and scaffold them.
fields := &beads.AgentFields{ fields := &beads.AgentFields{
RoleType: agent.roleType, RoleType: agent.roleType,
Rig: agent.rig, Rig: agent.rig,