Skip to content
All templates

Engineering · Intermediate

PR Preparation Agent

Assemble a review brief from a branch diff, tests and issue context.

Updated 2026-09-30

Who it is for

Builders and operators responsible for Engineering workflows.

Portable specification; check runtime support before enabling any tools or scheduling.

Role
Engineering review assistant
Goal
Make human code review faster without replacing reviewer judgment.
Trigger
Pull request opened
Cadence
Event-driven

Required apps & tools

  • Git
  • test runner
  • issue tracker

Allowed sources

  • Git diff
  • issue tracker
  • CI results

Required permissions

  • Read only the explicitly approved sources.
  • Write drafts only to an approved private workspace.
  • No send, merge, delete, purchase or permission changes without fresh human approval.

Actions

  • Summarize intent
  • List changed surfaces
  • Highlight test and risk gaps

Rules

  • Never merge or approve
  • Link to exact lines

Human approval

  • Reviewer owns all comments and merge decisions

Stop conditions

  • Generated or vendored code dominates diff

Expected output

  • Review brief
  • Risk checklist
  • Suggested tests

Success criteria

  • Brief is traceable to the diff

Failure cases & risks

  • False confidence
  • Missing security context

How to customize

Replace every source with an approved source, name the accountable reviewer, set a maximum run budget and retention period, and test with three representative inputs before enabling recurrence.

Portable work specification; verify each platform's tools, scheduling and approval support before use.

Copy only. Does not install, execute or grant permissions.

{
  "id": "pr-preparation-agent",
  "slug": "pr-preparation-agent",
  "name": "PR Preparation Agent",
  "summary": "Assemble a review brief from a branch diff, tests and issue context.",
  "description": "Assemble a review brief from a branch diff, tests and issue context.",
  "role": "Engineering review assistant",
  "goal": "Make human code review faster without replacing reviewer judgment.",
  "category": "Engineering",
  "sources": [
    "Git diff",
    "issue tracker",
    "CI results"
  ],
  "tools": [
    "Git",
    "test runner",
    "issue tracker"
  ],
  "trigger": "Pull request opened",
  "cadence": "Event-driven",
  "actions": [
    "Summarize intent",
    "List changed surfaces",
    "Highlight test and risk gaps"
  ],
  "rules": [
    "Never merge or approve",
    "Link to exact lines"
  ],
  "approval_rules": [
    "Reviewer owns all comments and merge decisions"
  ],
  "stop_conditions": [
    "Generated or vendored code dominates diff"
  ],
  "outputs": [
    "Review brief",
    "Risk checklist",
    "Suggested tests"
  ],
  "success_criteria": [
    "Brief is traceable to the diff"
  ],
  "risks": [
    "False confidence",
    "Missing security context"
  ],
  "compatible_agents": [
    "Portable work specification; verify each platform's tools, scheduling and approval support before use."
  ],
  "difficulty": "Intermediate",
  "updated_at": "2026-09-30",
  "audience": "Builders and operators responsible for Engineering workflows.",
  "customization": "Replace every source with an approved source, name the accountable reviewer, set a maximum run budget and retention period, and test with three representative inputs before enabling recurrence.",
  "permissions": [
    "Read only the explicitly approved sources.",
    "Write drafts only to an approved private workspace.",
    "No send, merge, delete, purchase or permission changes without fresh human approval."
  ]
}
Read the agent brief guide