Pr Review

Reviews a pull request like a senior reviewer: analyzes the diff, checks conventions and risks, and posts inline review comments plus a verdict.

Parameters

Configured via customParams in the agent JSON or the project .dmtools/config.js (project values win).

• aiRepository — repository the AI CLI works in when it differs from the PR repository.
• allowApproveWithSuggestions — when true, the reviewer may approve a PR while leaving non-blocking suggestions.
• autoStartRework — when true, automatically trigger the rework workflow when the review asks for changes.
• autoStartReworkConfigFile — agent config file used for the auto-started rework workflow.
• checkOpenPR — when true, skip tickets that already have an open pull request for this work.
• configPath — path to the project .dmtools/config.js to load for this run.
• maxReviewThreadsBeforeForceApprove — maximum open review threads before the reviewer is forced to an approve/reject verdict.
• onApproved — action to run when the review approves (e.g. trigger merge).
• projectKey — tracker project key override.
• removeLabel — label removed from the ticket after a successful run (idempotency cleanup).

Human doc: agents/docs/agents/pr_review.md

Attributes

Prompt snapshot

Full prompt / instruction set: agents/snapshots/pr_review.md

Actions

preJSAction: checkWipLabel.js

Check WIP Label Pre-Action

• Source: agents/js/checkWipLabel.js
• Side effects:
  • post Jira comment
• Parameters (customParams):
  • checkOpenPR

preCliJSAction: preparePRForReview.js

Prepare PR for Review Action (preCliJSAction for pr_review agent)

• Source: agents/js/preparePRForReview.js
• Side effects:
  • post Jira comment

postJSAction: postPRReviewComments.js

Post PR Review Comments Action

• Source: agents/js/postPRReviewComments.js
• Side effects:
  • add label “sm_story_rework_triggered”
  • post Jira comment
  • assign ticket
• Parameters (customParams):
  • aiRepository
  • allowApproveWithSuggestions
  • autoStartRework
  • autoStartReworkConfigFile
  • configPath
  • maxReviewThreadsBeforeForceApprove
  • onApproved
  • projectKey
  • removeLabel

LLM step

• outputType: none
• Prompt snapshot: agents/snapshots/pr_review.md

Output schemas

• pr_review.json
  • required: recommendation, summary, generalComment, inlineComments, issueCounts

Custom params

• removeLabel: "sm_story_review_triggered"
• allowApproveWithSuggestions: true
• checkOpenPR: true
• aiRepository (used by JS action)
• autoStartRework (used by JS action)
• autoStartReworkConfigFile (used by JS action)
• configPath (used by JS action)
• maxReviewThreadsBeforeForceApprove (used by JS action)
• onApproved (used by JS action)
• projectKey (used by JS action)

Generated by js/agentDocGenerator.js