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).
• cacheToReleases — when enabled, the autocommit timer also snapshots accumulated CLI output into a git release asset (restore point on a killed run).
• checkOpenPR — when true, skip tickets that already have an open pull request for this work.
• scmProvider — SCM provider override (github, gitlab, …) for this run (autocommit timer and release snapshots route through it).
• 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
• 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 ticket comment (via tracker)
  • 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 ticket comment (via tracker)
  • move ticket to status (via tracker)
  • git push
  • git checkout
• Parameters (customParams):
  • removeLabel

timerJSAction: timerAutoCommitAndSave.js

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

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

LLM step

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

Custom params

• removeLabel: "sm_bug_development_triggered"
• checkOpenPR (used by JS action)
• branchCreateFnPath (used by JS action)
• targetRepository.workingDir (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