Manage Stories

The Stories tab in the Plan view is where you define and organize the activities and user stories that shape your application. The story map displays activities as columns and user stories as cards within each column.

Each activity represents a functional area of your application—such as "Order Processing" or "Customer Management"—and the user stories beneath it represent the specific things users or the system do within that area. Together, activities and user stories form a visual story map that communicates your application's scope and structure at a glance.

Scroll or drag to pan · ⌘+/⌘− to zoom · Esc to close

In the Stories tab, you can:

• Manage activities: Rearrange, add, edit, or delete activities.
• Manage user stories: View and edit story details, add your own stories, or delete stories.
• Export your story map: Export the story map to a comma-separated value (CSV) file to share with stakeholders or import it into external tools.

Organize your story map

A well-organized story map makes it easier for your team to understand the overall structure and flow of the application.

Keep the following principles in mind as you add and arrange activities and user stories:

• Order activities by user journey. Activities are arranged horizontally, left to right. Rearrange the activities so the columns tell the chronological story of how a user moves through your application.
• Prioritize user stories vertically. User stories are stacked top to bottom under each activity. Drag and drop user stories to place essential stories at the top and more sophisticated ones lower.
• Use clear, descriptive names. Each activity and user story name must convey its purpose at a glance. Avoid generic names like Process. Instead, use specific labels like Customer Onboarding or Claim Submission.
• Break down complex activities. If an activity becomes too large, split it into smaller activities. Smaller groupings keep the story map readable and make each area of functionality clearer.

Manage activities

By default, Composer uses the information you provided for your application plan to generate a set of activities and their order. You can organize and update the activities to ensure your application’s high-level requirements are accurate and well-ordered.

Scroll or drag to pan · ⌘+/⌘− to zoom · Esc to close

Rearrange activities

To rearrange the activity columns:

1. On the Stories tab, click > Rearrange Activities.
2. In the Rearrange Activities display, click and hold an activity.
3. Drag and drop the activity into the desired order. The order reflects the left to right order on the story map.
4. Click SAVE.

Add an activity

To manually add a new activity:

1. On the Stories tab, click + ADD ACTIVITY. The Add Activity dialog appears.

2. For Name, enter a clear and concise title for your activity.

   Tip:  The name should be specific enough to convey the activity's purpose at a glance. Avoid overly general names and ensure it reflects the main function of the activity within your application. For example, instead of "Process," use something like "Customer Onboarding" or "Claim Submission."
   

3. (Optional) For Goal, enter a description of the activity's purpose or objective.
4. Click ADD.

Edit an activity

To edit an activity:

1. On the Stories tab, hover over the activity card and click Edit activity . The Edit Activity dialog appears.
2. Update the Name or Goal.
3. Click SAVE.

Delete an activity

To delete an activity and all its associated user stories:

1. On the Stories tab, hover over the activity card and click Delete activity .
2. Click DELETE

Manage user stories

Composer generates user stories to accompany the activities it identifies for your application plan. Each user story captures a specific action a user or the system does within an activity. You can add, edit, and delete user stories to keep your plan accurate.

Well-scoped user stories give Composer clear context to work from. When you click START BUILDING, the user stories you define in the Stories tab appear on the Board tab in the Build view, where Composer can help you build them.

Scroll or drag to pan · ⌘+/⌘− to zoom · Esc to close

View user story details

To review the current configuration of a user story:

1. On the Stories tab, click a user story.
2. Review the following details for the user story:
   • Description: A detailed explanation of the user story.
   • Acceptance Criteria: The conditions that must be met for the story to be considered complete.
   • Status: The current state of the user story.
   • Type: The specific action type assigned to the user story.
   • Persona: The user responsible for the user story.
3. Click Stories to return to the full story board.

Manually add a user story

When Composer generates your application plan, it automatically creates user stories based on the requirements you provide. You can add more user stories manually to capture work that Composer didn't include.

To manually add a user story:

1. On the Stories tab, hover over an activity and click Add story . The Add Story dialog appears.
2. For Status, select a value to indicate the current progress of the user story:
   • Not started
   • In progress
   • In review
   • Done
3. For Name, enter a clear and concise title for the user story.
4. (Optional) For Description, enter a detailed explanation of the user story.
5. (Optional) For Type, select the action type.
6. (Optional) For Persona, select the persona responsible for the user story.
7. Click ADD.

Edit a user story

To edit the details of a user story:

1. On the Stories tab, hover over the user story and click the Edit story . The user story details display.
2. Modify the user story details as needed.
3. Click SAVE CHANGES.
4. Click Stories to return to the full story board.

Delete a user story

To permanently delete a user story and its associated data:

1. On the Stories tab, hover over the user story you want to delete.
2. Click Delete story .
3. Click DELETE.

Export story map to a CSV file

You can export your story map to a comma-separated value (CSV) file to share your application's story map with stakeholders, or import it into external tools such as Jira or Azure DevOps. Exporting the story map helps ensure your requirements remain consistent as you move from architecting a solution in Composer to project execution.

To export your requirements as a CSV:

1. On the Stories tab, click > Export to CSV.
2. Save the generated StoryMapExport file to your local machine.

The CSV maintains the hierarchy of your story map: activities map to parent items (typically epics), and user stories map to child items (typically stories or tasks). It contains all the fields nested within their parent activities.

The exported file contains all the fields nested within their parent activities. The following table describes what each field indicates:

CSV Field Name	Composer	Jira Field	Description
issue type	Activity / User story	Issue Type	Indicates the hierarchy level. Epic for activities and Story for user stories.
issue id	N/A	Issue ID	A unique sequence number for each activity. Map this to the Issue ID column when importing into Jira.
issue key	N/A	Issue Key	A placeholder for Jira’s internal ID. This can remain unmapped during initial import.
summary	Name	Summary	The title of the activity or user story.
parent	N/A	Parent/Parent ID	The issue id of the activity associated with a user story.
description	Description	Description	The detailed objectives or requirements defined for the user story.
status	Status	Status	The current progress of the user story, such as Not Started, In Progress, or Done.

Feedback