> For the complete documentation index, see [llms.txt](https://docs.simplifyqa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.simplifyqa.ai/create-and-manage-your-requirements/create-and-manage-user-stories/generate-description-using-ai.md).

# Generate Description using AI

SimplifyQA provides an AI-powered feature that helps users create or refine **User Story Descriptions** quickly and effectively. This ensures that user stories are well-structured, clear, and aligned with Agile standards.

### How It Works

There are **two ways** to generate a user story description using AI:

#### 1. Generate from a Goal Prompt

* Navigate to the **User Story** section.
* Click on the Write with AI button.

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

* Enter the **goal of the user story** in the provided input field.
* The system will automatically create a detailed **User Story Description** based on the given goal.
* Click on Insert to add the description.

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

#### 2. Refine an Existing Description

* Enter or paste an existing user story description in the description field.
* Click on the Write with AI button and then Generate.
* The AI will refine the content, making it more structured, concise, and aligned with Agile best practices.

### Output

* The generated or refined description will be displayed in the **Description** field of the User Story.
* Users can review, edit, and save the final version.

### **Key Benefits**

* Saves time by auto-generating user story descriptions.
* Ensures consistency and clarity across all user stories.
* Provides flexibility to either **create from scratch** or **improve existing descriptions**.


---

# 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.simplifyqa.ai/create-and-manage-your-requirements/create-and-manage-user-stories/generate-description-using-ai.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.