Getting Started

Installation and quick start

Install StoryCraft, pick a template for your stories, and turn your first rough notes into a structured issue.

Installation

  1. 1

    Find StoryCraft on the Atlassian Marketplace and click Try it free. StoryCraft works with Jira Cloud.

  2. 2

    Grant the requested permissions. StoryCraft needs to read and write Jira issue data, and to store its settings in Atlassian's Forge storage.

  3. 3

    Open any issue and expand the StoryCraft section in the right-hand column.

Open StoryCraft on the Atlassian Marketplace ↗

Quick start

From a few lines of notes to a story in your team's template in five steps.

  1. 1

    Pick a template. In the StoryCraft project settings, open the Settings tab, select Story and click Choose & Create Template. Not sure which one fits? Take the one marked Recommended. You can skip this step: without a template, StoryCraft uses a default structure.

The Pick a template for Bug dialog with three templates on the left and a filled-in example of the Standard Bug Report on the right
The template library shows a filled-in example of each template. Create template saves it as an issue in your project.
  1. 2

    Write rough notes. Open a story and save a few lines in its description, such as who needs what and why.

  2. 3

    Apply the template. In the StoryCraft panel, click Improve Description, then Apply Team Template.

The StoryCraft panel with Improve Description expanded and Apply Team Template marked as Suggested
For a description without headings, StoryCraft suggests Apply Team Template and names the template it will use.
  1. 4

    Review the result. Switch between Diff and Result, type an instruction under Refine further to adjust it, or click Edit text to change it yourself.

  2. 5

    Click Apply Changes. The new description is saved to the issue. To start over instead, click Reject / Revert.

The Apply Team Template dialog showing the generated User Story and Acceptance Criteria in the Result view, with Close, Reject / Revert and Apply Changes buttons
The Result view shows exactly what will be saved. Nothing changes in Jira before you click Apply Changes.

Project settings

Project administrators find StoryCraft under Project settings → Apps → StoryCraft (called Space settings in newer Jira), or by clicking Configure Templates in the issue panel. There are four tabs: