feat(mol): add hint to view step instructions in mol current output#1403
Merged
steveyegge merged 1 commit intosteveyegge:mainfrom Jan 31, 2026
Merged
Conversation
When bd mol current displays the step list with "YOU ARE HERE" marker, agents often improvise based on the step title alone without reading the detailed step instructions stored in the step bead's description. This adds a footer hint: 💡 Run `bd show <step-id>` to see detailed instructions. The hint shows the current step ID if one is in_progress, otherwise the next ready step ID. This makes it clear how to access the full step description which contains the actual commands and procedures. Addresses: steveyegge/gastown#1128
aleiby
force-pushed
the
fix/bd-p00k0-mol-current-step-hint
branch
from
7e407dd to
ecfc43c
Compare
steveyegge
approved these changes
Jan 31, 2026
Owner
steveyegge
left a comment
steveyegge
left a comment
There was a problem hiding this comment.
Easy-win: clean UX improvement adding hint to view step instructions. Small, additive, no risk. LGTM.
groblegark
pushed a commit
to groblegark/beads
that referenced
this pull request
Jan 31, 2026
…teveyegge#1403) When bd mol current displays the step list with "YOU ARE HERE" marker, agents often improvise based on the step title alone without reading the detailed step instructions stored in the step bead's description. This adds a footer hint: 💡 Run `bd show <step-id>` to see detailed instructions. The hint shows the current step ID if one is in_progress, otherwise the next ready step ID. This makes it clear how to access the full step description which contains the actual commands and procedures. Addresses: steveyegge/gastown#1128 (cherry picked from commit 82a2354)
groblegark
pushed a commit
to groblegark/beads
that referenced
this pull request
Jan 31, 2026
…teveyegge#1403) When bd mol current displays the step list with "YOU ARE HERE" marker, agents often improvise based on the step title alone without reading the detailed step instructions stored in the step bead's description. This adds a footer hint: 💡 Run `bd show <step-id>` to see detailed instructions. The hint shows the current step ID if one is in_progress, otherwise the next ready step ID. This makes it clear how to access the full step description which contains the actual commands and procedures. Addresses: steveyegge/gastown#1128 (cherry picked from commit 82a2354)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
When
bd mol currentdisplays the step list with "YOU ARE HERE" marker, agents often improvise based on the step title alone without reading the detailed step instructions stored in the step bead's description.This adds a footer hint after the progress line:
The hint shows the current step ID if one is in_progress, otherwise the next ready step ID.
Problem
Step descriptions are stored in formula files and copied to step beads when molecules are poured.
bd show <step-id>displays these descriptions. However, agents don't know to run this command because nothing tells them about it.Evidence: The Deacon patrol saw step title "Feed stranded convoys" and improvised with
bd list | grepinstead of usinggt convoy stranded --jsonas specified in the step description.See: steveyegge/gastown#1128
Test plan
go build ./cmd/bd- compilesgo test ./cmd/bd/... -run "Mol"- all tests passbd mol currenton an active molecule and verify hint appears🤖 Tackled with Claude Code