Understanding Compose prompt mapping

This topic describes how prompts are mapped to work item types to generate structured content for key attributes such as description, hypothesis statement, and acceptance or success criteria. Each prompt is tailored to the planning level—portfolio, program, or team—to ensure the content aligns with business objectives and delivery goals. These mappings help maintain consistency, clarity, and quality across all work items.

Work Item Compose agent is available for the following work item types: Epics, Feature, Capability, and Story.

Epic

Work Item Type ID: com.ibm.team.apt.workItemType.epic

Available for the following attributes:

Description or Benefit Hypothesis

• ID: description
• Associated prompt: Epic Description Prompt - Generates program-level epic descriptions with strategic rationale, epic overview, and program impact, aligning with ART objectives and multi-PI roadmaps while ensuring epic scope consistency and feature coordination.

Success Criteria

• ID: com.ibm.team.workitem.attribute.successCriteria
• Associated prompt: Success Criteria Prompt - Defines concise, measurable outcomes indicating successful value delivery for the work item, generating verifiable, specific criteria in bullet lists while combining related points and focusing on key verification points with minimal, quality-focused content.

ART Epic

Work Item Type ID: com.ibm.team.workitem.workItemType.Epic

Available for the following attributes:

Description or Benefit Hypothesis

• ID: description
• Associated prompt: Epic Description Prompt - Generates program-level epic descriptions with strategic rationale, epic overview, and program impact, aligning with ART objectives and multi-PI roadmaps while ensuring epic scope consistency and feature coordination.

Epic Hypothesis Statement

• ID: com.ibm.team.workitem.attribute.epicHypothesisStatement
• Associated prompt: Epic Hypothesis Statement Prompt - Generates program-level epic hypothesis statements with For statement, target outcomes, and leading indicators appropriate to ART/Program Epic planning level, crafting testable hypotheses aligned with ART objectives and feature delivery goals while preserving existing content depth.

Success Criteria

• ID: com.ibm.team.workitem.attribute.successCriteria
• Associated prompt: Success Criteria Prompt - Defines concise, measurable outcomes indicating successful value delivery for the work item, generating verifiable, specific criteria in bullet lists while combining related points and focusing on key verification points with minimal, quality-focused content.

Program Epic

Work Item Type ID: com.ibm.team.workitem.workItemType.programEpic

Available for the following attributes:

Description or Benefit Hypothesis

• ID: description
• Associated prompt: Epic Description Prompt - Generates program-level epic descriptions with strategic rationale, epic overview, and program impact, aligning with ART objectives and multi-PI roadmaps while ensuring epic scope consistency and feature coordination.

Epic Hypothesis Statement

• ID: com.ibm.team.workitem.attribute.epicHypothesisStatement
• Associated prompt: Epic Hypothesis Statement Prompt - Generates program-level epic hypothesis statements with For statement, target outcomes, and leading indicators appropriate to ART/Program Epic planning level, crafting testable hypotheses aligned with ART objectives and feature delivery goals while preserving existing content depth.

Success Criteria

• ID: com.ibm.team.workitem.attribute.successCriteria
• Associated prompt: Success Criteria Prompt - Defines concise, measurable outcomes indicating successful value delivery for the work item, generating verifiable, specific criteria in bullet lists while combining related points and focusing on key verification points with minimal, quality-focused content.

Portfolio Epic

Work Item Type ID: com.ibm.team.workitem.workItemType.portfolioEpic

Available for the following attributes:

Description or Benefit Hypothesis

• ID: description
• Associated prompt: Portfolio Epic Description Prompt - Generates strategic portfolio-level epic descriptions with business strategy, solution vision, and organizational impact across multiple ARTs, aligning with portfolio objectives, strategic themes, and organizational goals while ensuring cross-program coordination.

Epic Hypothesis Statement

• ID: com.ibm.team.workitem.attribute.epicHypo thesisStatement
• Associated prompt: Portfolio Epic Hypothesis Statement Prompt - Generates strategic portfolio-level epic hypothesis statements with For statement, business outcomes, and leading indicators for Portfolio/Solution Train planning levels, crafting testable hypotheses aligned with organizational objectives and market opportunities while preserving existing content depth.

Success Criteria

• ID: com.ibm.team.workitem.attribute.successCriteria
• Associated prompt: Success Criteria Prompt - Defines concise, measurable outcomes indicating successful value delivery for the work item, generating verifiable, specific criteria in bullet lists while combining related points and focusing on key verification points with minimal, quality-focused content.

Solution or Solution Train Epic

Work Item Type ID: com.ibm.team.workitem.workItemType.solutionEpic

Available for the following attributes:

Description or Benefit Hypothesis

• ID: description
• Associated prompt: Portfolio Epic Description Prompt - Generates strategic portfolio-level epic descriptions with business strategy, solution vision, and organizational impact across multiple ARTs, aligning with portfolio objectives, strategic themes, and organizational goals while ensuring cross-program coordination.

Epic Hypothesis Statement

• ID: com.ibm.team.workitem.attribute.epicHypothesisStatement
• Associated prompt: Portfolio Epic Hypothesis Statement Prompt - Generates strategic portfolio-level epic hypothesis statements with For statement, business outcomes, and leading indicators for Portfolio/Solution Train planning levels, crafting testable hypotheses aligned with organizational objectives and market opportunities while preserving existing content depth.

Success Criteria

• ID: com.ibm.team.workitem.attribute.successCriteria
• Associated prompt: Success Criteria Prompt - Defines concise, measurable outcomes indicating successful value delivery for the work item, generating verifiable, specific criteria in bullet lists while combining related points and focusing on key verification points with minimal, quality-focused content.

Feature

Work Item Type ID: com.ibm.team.workitem.workItemType.feature

Available for the following attributes:

Description or Benefit Hypothesis

• ID: description
• Associated prompt: Feature Description Prompt - Generates complete feature or capability descriptions with problem statement, business value, customer value, and scope boundaries, aligning with program/portfolio objectives and PI goals while ensuring cross-team coordination and strategic clarity.

Acceptance Criteria

• ID: com.ibm.team.workitem.attribute.acceptanceCriteria
• Associated prompt: Acceptance Criteria Prompt - Defines concise, testable conditions verifying work item completion, detecting and preserving existing format (Given-When-Then, Checklist, Scenario-Based) or using simple bullet lists while focusing on verifiable outcomes with minimal, combined criteria.

Capability

Work Item Type ID: com.ibm.team.workitem.workItemType.capability

Available for the following attributes:

Description or Benefit Hypothesis

• ID: description
• Associated prompt: Feature Description Prompt - Generates complete feature or capability descriptions with problem statement, business value, customer value, and scope boundaries, aligning with program/portfolio objectives and PI goals while ensuring cross-team coordination and strategic clarity.

Acceptance Criteria

• ID: com.ibm.team.workitem.attribute.acceptanceCriteria
• Associated prompt: Acceptance Criteria Prompt - Defines concise, testable conditions verifying work item completion, detecting and preserving existing format (Given-When-Then, Checklist, Scenario-Based) or using simple bullet lists while focusing on verifiable outcomes with minimal, combined criteria.

Story or User Story

Work Item Type ID: com.ibm.team.apt.workItemType.story

Available for the following attributes:

Description or Benefit Hypothesis

• ID: description
• Associated prompt: Story Description Prompt - Generates complete story descriptions with background, user statement, needs, and scope, classifying as Technical or Functional and adapting content accordingly while maintaining logical section order.

Acceptance Criteria

• ID: com.ibm.team.workitem.attribute.acceptanceCriteria
• Associated prompt: Acceptance Criteria Prompt - Defines concise, testable conditions verifying work item completion, detecting and preserving existing format (Given-When-Then, Checklist, Scenario-Based) or using simple bullet lists while focusing on verifiable outcomes with minimal, combined criteria.