---
title: "AGENTS.md — Scrum4Me agent rules"
status: active
audience: [ai-agent]
language: en
last_updated: 2026-05-03
---

# Agent Instructions — Scrum4Me

This file is a redirect stub. All agent instructions live in **[CLAUDE.md](./CLAUDE.md)**.

For Claude Code specifically, CLAUDE.md is loaded automatically. Start there.

## Branch & PR-flow (quick reference)

| Moment | Actie | Verbod |
|---|---|---|
| Start run | `git checkout -b feat/<batch-slug>` | `gh pr create` |
| Na elke taak | `git add -A && git commit -m "<type>(ST-XXX): <title>"` | `git push` |
| Queue leeg | `git push -u origin <branch>` + `gh pr create` | `gh pr merge` |
| Na PR-create | `mcp__scrum4me__set_pbi_pr(pbi_id, pr_url)` → **STOP** | idem |

Full details: [docs/runbooks/branch-and-commit.md § Agent-batch flow](./docs/runbooks/branch-and-commit.md)

---

## PR-merge & PBI-volgorde

**De agent mergt nooit zelf een PR.** Na `gh pr create`:

1. Roep direct `mcp__scrum4me__set_pbi_pr(pbi_id, pr_url)` aan zodat de gate weet dat deze PBI in review zit.
2. Stop — wacht op handmatige merge door de PB-owner.
3. Als de gebruiker daarna een nieuwe batch voor een andere PBI start en `enqueueClaudeJobsBatchAction` de error `open_pr_url` teruggeeft: toon de foutmelding aan de gebruiker en stop. Niet opnieuw proberen; de gebruiker moet eerst de open PR mergen.

**Verboden:**
- `gh pr merge` (ook niet met `--auto`, `--squash`, of `--rebase`)
- Een PR sluiten en herforken om de gate te omzeilen
- Opnieuw enqueuen na een gate-weigering zonder gebruikersbevestiging

**PR-body** bevat minimaal:
- Lijst van geïmplementeerde taak-titels (één per regel)
- Link naar de PBI (`pbi_id` of de Scrum4Me-URL)

---