Doc to Story

StoryCraft AI

Overview

Doc to Story lets you upload an existing requirements document and have Monty extract the requirements and generate user stories, acceptance criteria, and test cases from it.

Accepted formats: Excel, Word, PDF, TXT — up to 5 MB.

Uploading a document

1Click the Doc tab in the Input panel
2Drag and drop your document onto the upload area, or click to browse
3After upload the panel shows ✓ Document Ready with the file name, type, and size
4For Excel files, sheet name badges appear so you can see which sheets were detected
5The Extracted Content section shows a preview of the parsed text — a note appears if the content was truncated for preview

AI Configuration

The AI Configuration panel shapes what Monty generates from the document:

SettingOptions
Focus AreaUser Stories, Acceptance Criteria, Test Cases, Technical Tasks
FrameworkReact, Angular, Backend API, Mobile
Test FrameworkPlaywright, Cypress, Selenium, JUnit
ComplexityBasic, Standard, Detailed

Use Guide Monty (optional) to focus on specific sections — e.g. "Focus only on the authentication requirements in section 3".

Generating stories

1Confirm the Extracted Content preview looks correct
2Set Focus Area, Framework, Complexity, and optionally Guide Monty
3Select a Branch * (required) and Priority *
4Click ✨ Generate with Monty — while parsing you see "Extracting content from document…"
5Generated stories appear in the Review & Export panel

Story cards in Review & Export

Each generated story appears as a card:

ElementDescription
Confidence badgePercentage score — how confident Monty is about this story
Source mode badge📄 doc icon showing the input mode used
Points"📊 {points} pts" — estimated story points
Priority selectorEditable dropdown to change the story priority
Acceptance Criteria"✅ Acceptance Criteria" — generated AC items, each editable
Tasks"📋 Tasks" — generated implementation tasks
Test Cases"🧪 Test Cases" — generated test cases
TagsDisplayed as chips below the story body

Click ✏️ to edit title or description inline. Use + Add, + Add Task, + Add Test Case to append items, and × to remove them. Click 🔍 Details to open the Artifact Details drawer with metadata, backlog linkage, and generation history (including a Restore this version option).

Saving to the backlog

1On the story card, click the backlog icon or open 🔍 Details → 📋 Add to Backlog
2The modal opens pre-filled with title, description, and acceptance criteria — all editable
3Add or remove AC using + Add criterion and ×. Add tags if needed
4Click Create Backlog Item — on success: "✓ Added to Backlog" with the Item ID

Token usage

After every generation the Review & Export panel shows a Token Usagesection with Prompt, Completion, and Totaltokens consumed. Larger documents and higher complexity settings use more tokens. See the AI Usage & Tokens guide to monitor your organisation's balance.

Session restore

StoryCraft AI saves your configuration and last generated output automatically. If you leave and return, a banner reads: "↻ Previous session restored · saved {time ago}". Uploaded document files cannot be restored — re-upload the file and click Generate again. Dismiss with ×, or click ↻ Start Fresh to clear everything.

Troubleshooting

Generate button shows "Upload a document to generate stories"

No document has been uploaded. Drag and drop a supported file or use the browse button.

Extracted Content preview is empty or garbled

The document may be scanned (image-based PDF) or in an unsupported encoding. Convert to a searchable PDF or TXT format and re-upload.

Excel document shows unexpected content

The parser extracts content from all sheets. If only one sheet is relevant, export that sheet as a separate file and upload it instead.

Upload fails

Check the file is Excel, Word, PDF, or TXT and is under 5 MB. Compress or split the document if it is too large.