Bug Development

Implements a bug fix end to end: checks out the repository, analyzes the root cause, writes the fix with tests, and opens a pull request.

Parameters

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

• branchCreateFnPath — path to a JS hook that creates the feature branch (two-branch flow customization).
• 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).
• targetRepository — repository override block (owner, repo, baseBranch, workingDir) — run the work against this repository instead of the project default.

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

Attributes

Prompt snapshot

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

Actions

preJSAction: checkWipLabel.js

Check WIP Label Pre-Action

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

preCliJSAction: preCliDevelopmentSetup.js

Pre-CLI Development Setup Action

• Source: agents/js/preCliDevelopmentSetup.js
• Writes:
  • input/<KEY>/merge_conflicts.md
• Side effects:
  • post Jira comment
  • git push
  • git checkout
  • git merge
• Parameters (customParams):
  • branchCreateFnPath
  • targetRepository.workingDir

postJSAction: developBugAndCreatePR.js

Develop Bug and Create PR Post-Action

• Source: agents/js/developBugAndCreatePR.js
• Side effects:
  • post Jira comment
  • git push
  • git checkout
• Parameters (customParams):
  • removeLabel

LLM step

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

Custom params

• removeLabel: "sm_bug_dev_triggered"
• checkOpenPR (used by JS action)
• branchCreateFnPath (used by JS action)
• targetRepository.workingDir (used by JS action)

Generated by js/agentDocGenerator.js