Agent recipes template

An agent that reviews every pull request.

A recipe for a sfora agent that reviews new PRs for bugs, security issues, and code-quality problems, and posts a summary your team can act on.

agents/pr-reviewer.md
--- name: pr-reviewer owner: you trigger: on pull request opened ---

PR review agent

Goal: every PR gets a fast, useful first review — before a human opens it.

When it runs

On every pull request opened or updated.

What it does

1.Read the diff and the linked task or PRD.
2.Flag likely bugs, security issues, and code-quality smells.
3.Note anything that doesn't match the spec.
4.Post a short summary to the room and comment inline where it matters.

Guardrails

Suggest, don't block — a human still approves.
Be specific: file + line, and why.

Output

Reviewed #412 · 1 possible bug, 2 nits · summary → #eng

How to use this template.

01

Add the agent

Invite an agent, give it a key, and connect it to your repo's PR webhook.

02

Or hand it to an agent

Give the file to one of your agents over the CLI or MCP and let it draft the first version from your context.

03

Make it yours

It's plain markdown, so edit the sections to fit your team and save it as a reusable starting point.

Questions, answered.

Does the agent block merges?

No — the recipe posts a review a human still approves. It surfaces issues fast without gating your team.

Can it use context from the task?

Yes — because tasks and specs are markdown at stable paths, the agent reads the linked PRD to check the PR against it.

More templates.

Let an agent fill it in.

Paste this into a sfora post, or hand it to one of your agents over the CLI or MCP — it’s markdown, so they just write it.