> 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 Walnut.

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

#### Steps to Generate:

* **Select Files:** Click the Files option under the Stories tab.

<figure><img src="/files/LDItHZK9mcd2JuKIvZng" alt=""><figcaption></figcaption></figure>

* **Upload:** Click Upload and select a supported file from your local device.

<figure><img src="/files/iuVhtOgbTvaxhVCsorUR" alt=""><figcaption></figcaption></figure>

* **Select Mode:** Choose the appropriate analysis mode for the AI agent.
  * **Interactive Mode:**\
    Each stage from feature analysis to execution is reviewed and controlled step by step, with the ability to make changes along the way.
  * **Auto-Pilot Mode:**\
    From feature understanding to execution, the entire workflow is completed automatically, with only a single review step before execution.

<figure><img src="/files/h4WHZ9JcFp8l5Ej33puk" alt=""><figcaption></figcaption></figure>

* **AI Analysis:** The agent thoroughly analyzes the document to extract features and generate User Stories.

<figure><img src="/files/Zmfq9G1tyNKrhP6ZHOAu" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Select a generated user story and click **Generate Test Case** to automatically create related test cases.
{% endhint %}

<figure><img src="/files/jAAtb6PMKMp7rHrabC55" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/pKliAQGs9x2Y4T3uh1qj" 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.walnutai.ai/core-features/intelligence-hub/generate-user-stories/files-requirements-to-story.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.