> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vistaly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Document Drafting Overview

> Generate evidence-based documentation for opportunities, solutions, experiments, and any other card type using AI and templates

<Info>
  **Beta Feature:** AI Document Drafting is currently in beta. We're actively improving the feature based on user feedback.
</Info>

# AI Document Drafting

Generate structured, evidence-based documents for opportunities, solutions, experiments, and any other card type using AI and customizable templates. AI combines your workspace data (cards, insights, comments) with template instructions to create comprehensive documentation that links directly to source data.

## How It Works

```
Workspace Data + Template + Your Context = Evidence-Backed Draft
```

1. **Select a Template**: Choose from your organization's templates or start blank
2. **Add Context** (optional): Provide additional details not in Vistaly
3. **Generate**: AI creates documentation following your template structure
4. **Refine**: Edit and polish your draft to perfection

AI automatically sources context from surrounding cards by leveraging relationships, associated insights from interviews, feedback, integrated metric data, and team conversations.

<Info>
  **Key principle**: When evidence is missing, our drafting experience explicitly acknowledges gaps and points out where information is thin. When there's rich information, links are automatically generated to interviews, feedback, conversations, and more.
</Info>

## Where to Access

Available in three places:

1. **Card Description Editor** - Generate documentation for any card
2. **Jira Integration** - Draft issue descriptions when creating Jira tickets
3. **Linear Integration** - Draft issue descriptions when creating Linear issues

## Common Use Cases

**Product Requirements (Solution Brief template)**:

* Problem definition with customer evidence
* Solution approach and key features
* Goals, success metrics, and scope

**Opportunity Analysis (Opportunity Summary template)**:

* Market opportunity with customer validation
* Current state and impact sizing
* Success metrics

**Custom Templates**: Design your own for technical specs, research summaries, retrospectives, or any structured documentation needs.

## Next Steps

* **[Template Management](/documentation/ai-document-drafting/template-management)**: Learn how to create and manage templates
* **[Drafting Workflow](/documentation/ai-document-drafting/drafting-workflow)**: Step-by-step guide to using AI drafting

***

Questions or feedback? Contact us at [support@vistaly.com](mailto:support@vistaly.com)