Solution Description

Enhances the solution design description of a ticket with architecture detail and posts an assessment of the result.

Parameters

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

  • checkOpenPR — when true, skip tickets that already have an open pull request for this work.
  • childQuestions — fetches [Q] question sub-tickets of each matched context ticket and appends them to the context.
  • contexts — context definitions matched by summary prefix (label, output file, description for the agent).
  • fields — tracker fields to fetch for context tickets.
  • jql — JQL override for selecting context tickets.
  • parentContextFetch — enables fetching the parent ticket context so the solution description can reference BA/SA/VD decisions.

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

Attributes

AttributeValue
JobTeammate
Configsolution_description.json
ContextIdsolution_design_description
outputTypenone
skipAIProcessingtrue

Prompt snapshot

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

Actions

preJSAction: checkWipLabel.js

Check WIP Label Pre-Action

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

preCliJSAction: fetchParentContextToInput.js

Fetch Parent Context To Input

  • Source: agents/js/fetchParentContextToInput.js
  • Parameters (customParams):
    • childQuestions
    • contexts
    • fields
    • jql
    • parentContextFetch

postJSAction: enhanceSolutionDesignDescriptionAndAssess.js

Enhance SD CORE Description and Assess Action

  • Source: agents/js/enhanceSolutionDesignDescriptionAndAssess.js
  • No detected file I/O or side effects.

LLM step

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

Custom params

  • checkOpenPR (used by JS action)
  • childQuestions (used by JS action)
  • contexts (used by JS action)
  • fields (used by JS action)
  • jql (used by JS action)
  • parentContextFetch (used by JS action)

Generated by js/agentDocGenerator.js

View the agent config on GitHub →

Generated from solution_description.json in the agents repository and its human doc — edit either and the page follows. Last updated .