Skip to content

docs(agents): Drop the emoji from board status names - #865

Merged
omesser merged 1 commit into
mainfrom
docs/board-status-names
Sep 21, 2026
Merged

omesser merged 1 commit into
mainfrom
docs/board-status-names

Conversation

@omesser

@omesser omesser commented Sep 21, 2026

Copy link
Copy Markdown
Owner

Why

The board's Status options were renamed on 2026-09-21 to drop their emoji prefix, so scripting them is easier. The API now returns Todo, In Progress, Human Triage, Ice Box and Done.

docs/agents/picking-work.md still 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.md and docs/agents/pstack.md carried 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

grep -rn "emoji status names" AGENTS.md docs/agents/   # nothing remains
node --test tests/*.test.js                            # 285 pass
pre-commit run --all-files                             # clean

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-automation moved #634 from Done to In Progress. That turned out to be unrelated: PR #852's body says "Same shape as closed #634", GitHub read closed #634 as 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

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>
@omesser
omesser merged commit a4674cf into main Sep 21, 2026
5 checks passed
@omesser
omesser deleted the docs/board-status-names branch September 21, 2026 20:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

macOS Settings Off pick does not leave the Harness popup

1 participant