> For the complete documentation index, see [llms.txt](https://docs.walnutai.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.walnutai.ai/core-features/intelligence-hub/generate-user-stories/files-requirements-to-story.md).

# Files (Requirements to Story)

**When to Use Requirements-to-Story Conversion:**\
Use this feature when you have static requirements (such as BRDs, specifications, presentations, or spreadsheets) and want to automatically convert them into structured Epics, Features, User Stories, and Test Cases within WalnutAI.

* **Supported Formats:** `PDF`, `DOCX`, `XLSX`, `CSV`, `MD`, `PPTX`, `PPT`.
* **Maximum File Size:** 10 MB.

**Steps to Generate:**

* Click the **link** icon under the **Stories** tab.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FxjYEGXOGYGOR0W8w4i0z%2FScreenshot%202026-07-30%20at%206.18.05%E2%80%AFPM.png?alt=media&amp;token=fbf90321-b2aa-4306-9fe3-187f272774c0" alt=""><figcaption></figcaption></figure>

* Select the **Document** option.
* Upload a supported file from your local device.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKvS3H4JZ00eP6bxz774U%2FScreenshot%202026-07-30%20at%206.18.47%E2%80%AFPM.png?alt=media&amp;token=c94c70ae-2810-4026-8835-15fe62993794" alt=""><figcaption></figcaption></figure>

* The AI agent analyzes the uploaded document and generates **Epics, Features, and User Stories** based on the extracted requirements.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FkGaWDL0SA1Ja8sFlCvY8%2FScreenshot%202026-07-30%20at%206.21.31%E2%80%AFPM.png?alt=media&amp;token=9a88ff8d-c046-4b15-879d-47cd7c5dba19" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Select a generated User Story and click Use in Chat to generate the related test cases.
{% endhint %}

* Click **Save** to store the generated **Epics, Features, User Stories, and Test Cases**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FDCpzJAJxBtcDAovgTDhG%2FScreenshot%202026-07-30%20at%206.22.36%E2%80%AFPM.png?alt=media&amp;token=6fb09c79-858b-4b7b-aaf4-637f8dd09451" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Result: Saved Epics, features and User Stories reflect in Action Items, while Test Cases appear in the Test Cases module.
{% endhint %}