Repository navigation
docs: find, link and track the work on an issue - #545
Closed
olebhansen-agent wants to merge 4 commits into
Closed
olebhansen-agent wants to merge 4 commits into
olebhansen-agent wants to merge 4 commits into
Conversation
Contributor
|
Important Review skippedAuto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the
|
olebhansen-agent
force-pushed
the
docs/agents-md-linked-prs
branch
from
November 18, 2026 08:18
d9b0cc3 to
a0bc744
Compare
…s to it Agents searched issue comments for earlier work, which do not show linked pull requests, and opened parallel ones. A pull request without a closing keyword in its description is also missing from the issue's Development section, so the next agent cannot find it there. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…issue in progress Others look at assignees and the project's Status to see whether someone is already on an issue, also before a pull request exists. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
`gh project` needs the read:org scope as well, and GitHub hides a private project from an account without access to it, so the project scope alone is not enough to name. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The project shows where each issue and pull request stands, and grouping by Agent State shows what waits on a person better than a label does. With the read:org scope, gh pr edit and gh project work, so the API workarounds go. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
olebhansen-agent
force-pushed
the
docs/agents-md-linked-prs
branch
from
November 18, 2026 11:48
e220102 to
edbc748
Compare
Collaborator
Author
|
Replaced by #553, which holds these rules together with the workflow for the project's new Status and WIP State fields. |
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.
Summary
AGENTS.mdgets rules for agents that work on issues:gh issue view N --json closedByPullRequestsReferences. Then search the free text for ones that only mention it.Closes #N, orPart of #N, in the pull request's description, and check the link after creating or editing it.Agents read the issue with
gh issue view --comments, which doesn't show linked pull requests, so they missed drafts that already existed and opened parallel ones. A pull request with its closing keyword only in the commit message is missing from the issue's Development section, so the next agent can't find it there either.Assignees and the project show who is on an issue and where it stands, before any pull request exists. Agent State takes over from the
process/human-neededlabel, since the board can group by it and show what waits on a person in one lane. GitHub's project workflows already add items and set Done, so agents only set what those don't.Setting the fields needs the
projectandread:orgscopes, and access to the project, which GitHub hides from accounts without it. When an agent can't set them, it tells the person and goes on with the work.Evidence
#539 repeated the change in the draft #533 for #532, and was closed as a duplicate. The fix for #531 was made a second time, though the draft #534 already had it. #538 was missing from #537's Development section until
Closes #537was added to its description. With the first command, #532 lists #533, and #537 lists #538.The commands in the rules ran as written against project 74 with a token scoped
project, read:org, repo, workflow:gh project item-addreturned the existing item for this pull request, andgh project item-editset its Agent State.Risk
process/human-neededlabel misses a pause set only in the project. No open issue or pull request carries the label now.🤖 Generated with Claude Code