Pr Rework

Reworks a pull request after review: reads review comments, implements the requested fixes, and pushes updates to the PR branch.

Parameters

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

• autoStartReview — when true, automatically trigger the PR review workflow after this agent finishes.
• autoStartReviewConfigFile — agent config file used for the auto-started review workflow.
• branchCreateFnPath — path to a JS hook that creates the feature branch (two-branch flow customization).
• branchSyncFnPath — path to a JS hook that syncs the base branch before rebasing.
• cacheToReleases — when enabled, caches the workspace into a git release so later runs restore instead of re-cloning.
• checkOpenPR — when true, skip tickets that already have an open pull request for this work.
• removeLabel — label removed from the ticket after a successful run (idempotency cleanup).
• removeLabels — list of labels removed from the ticket after a successful run.
• scmProvider — SCM provider override (github, gitlab, …) for this run.
• targetRepository — repository override block (owner, repo, baseBranch, workingDir) — run the work against this repository instead of the project default.

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

Attributes

Prompt snapshot

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

Actions

preJSAction: checkWipLabel.js

Check WIP Label Pre-Action

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

preCliJSAction: preCliReworkSetup.js

Pre-CLI Rework Setup Action (preCliJSAction for pr_rework agent)

• Source: agents/js/preCliReworkSetup.js
• Side effects:
  • post Jira comment
• Parameters (customParams):
  • branchCreateFnPath
  • branchSyncFnPath

postJSAction: pushReworkChanges.js

Push Rework Changes Post-Action

• Source: agents/js/pushReworkChanges.js
• Side effects:
  • post Jira comment
  • assign ticket
  • git push
  • git checkout
  • git merge
• Parameters (customParams):
  • autoStartReview
  • autoStartReviewConfigFile
  • removeLabel
  • removeLabels

timerJSAction: timerAutoCommitAndSave.js

Timer JS Action — Auto-commit, push, and save session artefacts

• Source: agents/js/timerAutoCommitAndSave.js
• Side effects:
  • git push
• Parameters (customParams):
  • cacheToReleases
  • cacheToReleases.releaseNameTemplate
  • cacheToReleases.releaseTagTemplate
  • scmProvider
  • targetRepository

LLM step

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

Custom params

• removeLabels:

  [
    "sm_story_rework_triggered",
    "sm_story_review_triggered"
  ]

• checkOpenPR: true

• branchCreateFnPath (used by JS action)

• branchSyncFnPath (used by JS action)

• autoStartReview (used by JS action)

• autoStartReviewConfigFile (used by JS action)

• removeLabel (used by JS action)

• cacheToReleases (used by JS action)

• cacheToReleases.releaseNameTemplate (used by JS action)

• cacheToReleases.releaseTagTemplate (used by JS action)

• scmProvider (used by JS action)

• targetRepository (used by JS action)

Generated by js/agentDocGenerator.js