Skip to main content

User Story Authoring

Authoring User Stories with TestChimp​

TestChimp can help you write detailed user stories that include:

  • Functional requirements
  • Non-functional requirements
  • User acceptance criteria
  • And more

Creating a User Story​

  1. Navigate to the User Stories section
  2. Click "Add New"
  3. Type in a title for the user story
  4. Click "Write for Me"
  5. TestChimp will generate a detailed user story

Leveraging Atlas SiteMap Knowledge​

TestChimp leverages the knowledge it has accrued about your webapp (the Atlas SiteMap) to write detailed, accurate specifications. This knowledge includes:

  • The structure of your application (screens and states)
  • Behavioral patterns (navigation pathways)
  • Attached documents and knowledge base content

Why Use TestChimp vs Generic Tools​

Unlike generic GPT tools, TestChimp builds specific knowledge about your app via its explorations, which is captured in the Atlas SiteMap:

  • App-specific context: TestChimp knows your application's structure and behavior
  • Rich knowledge base: The SiteMap indexes your app's structure and behavioral patterns
  • Enriched context: You can attach documents at any level of the SiteMap
  • Accurate results: This rich context ensures user stories are accurate and useful

Using the Context Window for Richer Context​

Context Window Concept​

The Context Window is the specific knowledge that is leveraged for user story authoring. It includes:

  • The Atlas SiteMap (always included by default)
  • Relevant Knowledge Base documents (automatically included if relevant)
  • Manually added context items

Adding Confluence Docs​

If you have Confluence set up in your account:

  1. Click "Add Context" in the Context Window
  2. Select "Confluence Documents"
  3. Choose the documents you want to include
  4. Confluence docs are fetched via the Jira integration

Adding Figma Designs​

  1. Click "Add Context" in the Context Window
  2. Select "Figma Designs"
  3. Add Figma design links or files
  4. Designs are included in the context for authoring

Adding Text Content​

  1. Click "Add Context" in the Context Window
  2. Select "Text Content"
  3. Paste or type the content you want to include
  4. This content is used when generating the user story

Adding Knowledge Base Documents​

  1. Click "Add Context" in the Context Window
  2. Select "Knowledge Base"
  3. Choose documents from your TestChimp Knowledge Base
  4. These documents provide additional context

Default Context​

By default, the Context Window always leverages:

  • The Atlas SiteMap (which captures your app's structure and behavior)
  • Relevant Knowledge Base docs (automatically pulled in if relevant)

This ensures user stories are always informed by your application's current state.

Brainstorming Test Scenarios​

Suggesting Test Scenarios​

  1. Click on the Actions dropdown button for a user story
  2. Select "Suggest Test Scenarios"
  3. A wizard opens with suggested scenarios
  4. You can add, edit, or remove scenarios
  5. Click "Next" to scope out each scenario

Scoping Test Scenarios​

For each scenario:

  1. TestChimp authors the exact test steps to execute
  2. You can review and modify the steps
  3. Test scenarios linked to each user story are displayed as sub-rows
  4. Expand the user story row to view its test scenarios

Importing from Jira​

Import Process​

  1. Click on the dropdown icon next to the "Add New" button
  2. Select "Import from Jira"
  3. Follow the import wizard to connect and import user stories

Working with Imported Stories​

Imported user stories can be:

  • Scoped out with TestChimp AI: Enhance them with detailed requirements
  • Exported back to Jira: Keep Jira as your tracker while TestChimp helps with scoping and testing

This allows Jira to remain your primary tracker while TestChimp provides AI-powered assistance for scoping and testing.

Exporting/Syncing to Jira​

Export Process​

  1. Select the user stories you want to export
  2. An "Export to Jira" button appears
  3. Click on it to start the export

Export Details​

  • User stories are exported as "Story" type issues in Jira
  • If a user story has linked test scenarios, they are also exported
  • Test scenarios are exported as issues of a custom type (you configure this in your Jira integration)
  • Links between user stories and test scenarios are preserved in Jira

Keeping Jira in Sync​

TestChimp's Jira integration allows you to:

  • Keep Jira as your primary issue tracker
  • Use TestChimp for AI-powered scoping and testing
  • Sync changes bidirectionally
  • Maintain a single source of truth

User story authoring with TestChimp combines the power of AI with the specific knowledge of your application to create detailed, accurate user stories.