Repository navigation
docs(agents): Drop the emoji from board status names - #865
Merged
Merged
Conversation
The Status options were renamed on 2026-09-21 to ease scripting. The documented jq filter still carried the emoji, so it matched nothing and reported an empty board instead of an error. Refs #634. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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
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.
Why
The board's
Statusoptions were renamed on 2026-09-21 to drop their emoji prefix, so scripting them is easier. The API now returnsTodo,In Progress,Human Triage,Ice BoxandDone.docs/agents/picking-work.mdstill documented all five with the emoji, including the copy-pasteable query it tells every agent to run:--jq '.items[] | select(.status == "<emoji> Todo") | ...'That filter matches nothing now. It does not error, it returns an empty list, so an agent following the repo's own instructions sees no work on the board and concludes there is none.
AGENTS.mdanddocs/agents/pstack.mdcarried the same stale name in prose.What changed
The five names in the status table, the jq example, the two prose mentions, and the line about moving an item to
In Progress.One short paragraph added under the query, saying the names carry no emoji, that a filter copied from an older transcript matches nothing, and that an empty Todo list is worth double-checking before believing. That last part is the actual trap: the failure is silent and looks like a legitimate answer.
The paragraph describes the old prefix rather than printing it, so the character does not come back into the tree through the very file warning against it.
How to verify
The documented query, run against the live board, now returns the Todo items rather than an empty list.
Notes
Found while tracing why
github-project-automationmoved #634 from Done to In Progress. That turned out to be unrelated: PR #852's body says "Same shape as closed #634", GitHub readclosed #634as a closing keyword, and the built-in "Pull request linked to issue" rule moved a finished item. The emoji mismatch surfaced when my own sweep for other stranded items matched all 261 rows and told me nothing.Refs #634.
— Claude Code agent, on @omesser's behalf.
🤖 Generated with Claude Code