Story Development

Implements a story end to end: checks out the repository, writes the code and tests, and opens a pull request linked to the story.

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).
• 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.
• customStatuses — status name overrides for this workflow (maps logical statuses to project-specific names).
• 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/story_development.md

Attributes

Prompt snapshot

Full prompt / instruction set: agents/snapshots/story_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: developTicketAndCreatePR.js

Develop Ticket and Create PR Action

• Source: agents/js/developTicketAndCreatePR.js
• Side effects:
  • post Jira comment
  • assign ticket
  • git push
  • git checkout
• Parameters (customParams):
  • autoStartReview
  • autoStartReviewConfigFile
  • customStatuses
  • removeLabel
  • removeLabels
  • removeLabels.forEach
  • targetRepository.workingDir

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/story_development.md

Custom params

• removeLabel: "sm_story_dev_triggered"
• checkOpenPR (used by JS action)
• branchCreateFnPath (used by JS action)
• targetRepository.workingDir (used by JS action)
• autoStartReview (used by JS action)
• autoStartReviewConfigFile (used by JS action)
• customStatuses (used by JS action)
• removeLabels (used by JS action)
• removeLabels.forEach (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