Skip to content

Commit 5a2d24b

Browse files
cliffhallclaude
andauthored
docs(agents): require version label on new issues and PRs (#1257)
* docs(agents): require version label on new issues and PRs (#1256) Recent v2 PRs (#1247, #1249, #1250, #1252, #1255) all landed without a v2 label, making version-filtered queries unreliable. Codify the expectation directly in the issue-driven workflow: each branch / board gets a fixed label, and the label is set at create time via the gh create flag rather than backfilled. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Also fix stale "PR against main" line The PR-target line still said "Open a PR against main", which is correct only for v1 work. Mirror the version-label mapping above so the PR base matches the board. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 39e1c67 commit 5a2d24b

1 file changed

Lines changed: 7 additions & 1 deletion

File tree

AGENTS.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,10 +48,16 @@ All work should be driven by items on the project board.
4848

4949
- Before starting work, check the board for the relevant item.
5050
- **Draft items vs. issues**: Board items may be draft items (no issue number) or full GitHub issues. Before creating a new issue, always check if a matching draft item already exists on the board. If it does, convert it to an issue using `gh project item-edit` or create the issue and link it — **never create a duplicate**.
51+
- **Label by version.** New issues and PRs must carry the label matching the target board / branch:
52+
- `main``v1`
53+
- `v1.5/main``v1.5`
54+
- `v2/main``v2`
55+
56+
Set the label at create time (`gh issue create --label v2 ...`, `gh pr create --label v2 ...`) — don't rely on backfilling later, since unlabeled PRs are easy to miss when filtering by version.
5157
- When work begins, create a feature branch and move the item to "In Progress".
5258
- When work is complete:
5359
- Run format, lint, typecheck, build, and test — ensure all checks pass
54-
- Open a PR against `main` and move the item to "In Review"
60+
- Open a PR against the matching base branch (`main` for v1, `v1.5/main` for v1.5, `v2/main` for v2) and move the item to "In Review"
5561
- If new tasks are discovered or requested during development, create issues and add them to the board.
5662

5763
### Always test new or modified code

0 commit comments

Comments
 (0)