> 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.md).

# Generate User Stories

The **User Stories** section within the Intelligence Hub enables you to generate structured **Epics, Features, and User Stories** from multiple input sources within a unified workflow. Whether your requirements originate from documents, media inputs, integrated project management tools, or connected code repositories, this module transforms them into well-defined and actionable artifacts.

By selecting **User Stories**, you can choose the appropriate source [upload a file](/core-features/intelligence-hub/generate-user-stories/files-requirements-to-story.md), import from media, [integrate with external platforms](/core-features/intelligence-hub/generate-user-stories/integrate-external-platform-sync.md), or [analyze a connected repository](/core-features/intelligence-hub/generate-user-stories/code-repository-to-requirement.md). The system processes the input and converts it into organized Epics, Features, and User Stories. These artifacts can be further refined, and test cases can be generated for the required user stories as needed.

You can also interact with **Walnut AI Chatbot** to create, modify, refine, or manage your user stories and generated test cases. This allows you to enhance clarity, update acceptance criteria, or restructure stories before finalizing them.

It is mandatory to click **Save** to retain the generated content. If not saved, the generated Epics, Features, User Stories, and Test Cases will not be retained and will no longer be available. Upon saving:

* **Epics, Features, and User Stories** will appear under the **Action Items** module.
* **Test Cases** will be available in the **Test Cases** module.

Additionally, you can **download** the generated file for reference. If the file is no longer needed, you may choose to **delete** it. Please note that deleting a file is a permanent action and cannot be undone.


---

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