메뉴
Branch naming, base branch, draft policy, auto-merge policy, force-push policy. Short, table-driven. Triggers: branch naming, branch policy, where to branch from.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
End-to-end PR loop. Opens PR, waits CI, waits CodeRabbit, triages, fixes, replies, resolves, re-runs CI, merges. The mastermind invokes this and walks away. Triggers: babysit pr, drive pr, ship pr end to end.
When and how to evolve .coderabbit.yaml — enable new tools, switch profile, add path-instructions for new doc subtrees, tune tone. Triggers: update coderabbit config, tune cr, edit coderabbit yaml.
Post threaded replies to CodeRabbit review threads via GraphQL addPullRequestReviewThreadReply (or REST fallback). For wrong/opinion threads include principle citation. Triggers: reply coderabbit, post cr reply.
Mark review threads resolved via GraphQL resolveReviewThread mutation. Paginated, dry-run, batch. REST cannot do this. Triggers: resolve cr threads, mark resolved, close review threads.
Fetch all coderabbitai[bot] review threads via GraphQL, classify each (bug/nit/suggestion/opinion/wrong), emit accept/reject/discuss plan. Triggers: triage coderabbit, classify cr comments, cr plan.
For each accepted CR thread, locate file, route to right subagent, apply fix, build, run scoped tests, push, then resolve threads. Triggers: fix cr, apply coderabbit, address review comments.
| name | branch-conventions |
| description | Branch naming, base branch, draft policy, auto-merge policy, force-push policy. Short, table-driven. Triggers: branch naming, branch policy, where to branch from. |
Five tables. Read once. Apply forever.
| Prefix | When | Example |
|---|---|---|
feat/ | new feature/spec impl | feat/renderer-shadow-maps |
fix/ | bug fix | fix/character-controller-step |
perf/ | perf-only change | perf/ecs-archetype-iter |
refactor/ | no behavior change | refactor/jobs-fiber-pool |
docs/ | docs/spec/contract | docs/specs-audio-spatial |
test/ | tests only | test/replay-fuzz-harness |
build/ ci/ chore/ | tooling | ci/pin-action-shas |
adr/ | new ADR | adr/0042-why-wgpu |
revert/ | revert prior PR | revert/123-shadow-regression |
bot/ | bot-authored | bot/sync-glossary-2026-05-17 |
Rules:
Closes #N).feat/sebi-shadows ✗).| Source of change | Base |
|---|---|
| anything | main |
| live-content hotfix | main (cherry-pick to active release branch after merge) |
| security backport | release/X.Y (rare, coordinated) |
Nexus is trunk-based. No develop. No long-lived feature branches (>3 days = rebase or split).
| State | When |
|---|---|
| draft | branch < first CI run; impl incomplete; experimenting |
| ready | impl complete; CI green; spec referenced |
| draft (back) | force-pushed history rewrite; awaiting fresh CR review |
Mark ready via gh pr ready <PR> or GraphQL markPullRequestReadyForReview (see gh-graphql-helpers).
| Condition | Auto-merge? |
|---|---|
feat/fix + ≤3 file change + ≤200 LOC | YES (squash) |
docs only | YES (squash) |
chore/ci + green | YES (squash) |
touches docs/architecture/01-principles.md | NO — requires architect review + ADR |
touches docs/architecture/00-vision.md | NO — requires ADR + 7-day notice |
revert/* | NO — require human ack |
| breaking change | NO — require release-engineer review |
Enable via:
gh pr merge --auto --squash --delete-branch
| Target | Policy |
|---|---|
| own PR branch | OK with --force-with-lease (never plain --force) |
main | FORBIDDEN |
release/* | FORBIDDEN |
| branch shared with another agent | coordinate first or rebase locally and PR a rebase commit |
After force-push: CR re-reviews from scratch → expect a full triage round.
# 1. Create
git switch -c feat/<scope>-<slug>
# 2. Push (sets upstream)
git push -u origin "$(git branch --show-current)"
# 3. Sync (rebase, not merge)
git fetch origin main && git rebase origin/main
# 4. Force-push (safely)
git push --force-with-lease
# 5. After merge — clean up
git switch main && git pull && git branch -d feat/<scope>-<slug>
None — this is reference only. Other skills consult it before naming/branching.
docs/guides/merge-system.md (Agent 16)docs/guides/pr-protocol.md (Agent 16).claude/skills/open-pr/SKILL.md.claude/skills/pr-rebase-and-recover/SKILL.md