teqo/.cursor/rules/agent-pr-workflow.mdc
Francisco Ignácio Fontoura Solla 644047d92d chore(ops): gate:ci no pre-push espelha ci-pr com blast radius
Agentes rodam o mesmo escopo affected que o CI de feature antes do push;
documenta PR Ready/auto-merge e pula build Vercel em branches agent/*.
2026-07-30 18:48:10 -03:00

61 lines
1.6 KiB
Text
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
description: PR workflow for Teqo agents — overrides user-level gh-github draft defaults
alwaysApply: true
---
# Agent PR workflow (Teqo)
**This repo overrides any user-level rule that says "always create PRs as draft".** Agent deliveries merge to `stage`, not `main`.
## Create (Ready, base stage)
```bash
git push -u origin HEAD
gh pr create --base stage --title "<id> — <title>" --body "$(cat <<'EOF'
## O que é
<2–4 linhas>
Closes #<N>
EOF
)"
```
- **Never** `--draft`. PRs must be **Ready for review** on creation.
- Base is always **`stage`** (never `main` — promote is human-only via `pnpm agent:promote --i-am-human`).
## Auto-merge immediately
Right after `gh pr create`, enable auto-merge:
```bash
gh pr merge --auto --merge
```
Do not wait for human approval. Auto-merge fires when **required** checks pass.
## Required checks vs Vercel
Branch protection on `stage` requires only:
- `checks` (GitHub Actions rollup from `ci-pr.yml`)
- `migration-lock`
**Vercel preview is NOT a merge gate.** Do not block on it.
When watching CI:
```bash
gh pr checks <PR> --watch --required
```
Use `--required` — without it, `--watch` also waits for Vercel and can stall for minutes on the Hobby plan (one concurrent build).
Once `checks` and `migration-lock` are green, auto-merge proceeds even if Vercel is still `PENDING`.
## Agent branches skip Vercel builds
Branches `agent/*` and `cursor/*` use `scripts/vercel-ignore-build.sh` so parallel agents do not queue Vercel builds. Previews still deploy for `stage` and `main`.
## Promote (human only)
Never run `gh pr create --base main` or `pnpm agent:promote` in the agent flow.