Skip to content

Commit 9d9f0f3

Browse files
belleklaviyoclaude
andcommitted
docs: document branch naming and PR target guardrails in AGENTS.md
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 605f255 commit 9d9f0f3

1 file changed

Lines changed: 12 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,18 @@ If prompted to commit, push, or open pull requests:
5656
- Use the PR template at `.github/pull_request_template.md`
5757
- Include a brief changelog and test plan with reproducible steps
5858

59+
### Branch Naming & PR Targets
60+
61+
| Prefix | Purpose | May target `master` directly |
62+
|--------|---------|------------------------------|
63+
| `rel/*` | Release branches | Yes |
64+
| `ci/*` | CI/tooling changes (GitHub Actions, scripts, build config) | Yes |
65+
| `docs/*` | Documentation-only changes | Yes |
66+
| `feat/*` | New features | No — target active `rel/*` |
67+
| `{initials}/*` | Personal/WIP branches | No — target active `rel/*` |
68+
69+
A required status check blocks merges to `master` from any branch not in the allowed list. The check posts a comment with retargeting instructions and applies a `needs: release branch` label. To bypass in exceptional cases, a maintainer can add the `manual-merge` label — use sparingly.
70+
5971
## Architecture Overview
6072

6173
The SDK uses [The Composable Architecture](https://www.pointfree.co/collections/composable-architecture) framework. It is

0 commit comments

Comments
 (0)