Quick Summary

The AI Description Expansion feature turns your brief notes into comprehensive, well-formatted task descriptions. Click the "Expand with AI" button below any description field, and AI will create a detailed version for you.

What You'll Learn

• Where to find the expand button
• How to use it step-by-step
• What AI does to expand descriptions
• How to regenerate if you don't like the first version
• Real examples and best practices

Where to Find It

You'll see the "Expand with AI" button in these places:

• Below the description editor when creating a new task
• Below the description editor when editing an existing task
• It has a ⚡ sparkle icon next to the text

How to Use It - Step by Step

Step 1: Write a Brief Description

Type a short description of what needs to be done. Don't worry about making it detailed or perfectly formatted. Just get the key points down.

Examples of brief descriptions:

• "We need a new hero section design for the homepage"
• "Fix the header on the website"
• "Build contact page with form and map"
• "Update product page layout to match new design"

Step 2: Click "Expand with AI"

Look for the button that says "Expand with AI" (with a ⚡ icon) below the description editor and click it.

Step 3: Wait for AI

The AI will analyze your brief description and create a detailed, well-formatted version. This usually takes 2-3 seconds.

Step 4: Review the Expanded Description

A modal will pop up showing you the expanded description. It will be formatted with proper HTML, including:

• Clear paragraphs
• Bullet points for lists
• Bold text for emphasis
• Professional language

Step 5: Choose What to Do

You have three options:

• Use This: Replace your brief description with the AI-generated one
• Regenerate ↻: Get a different version if you don't like this one
• Cancel: Keep your original brief description

What AI Does to Your Descriptions

The AI expands your descriptions by:

• Adding Context: Explains the purpose and goals
• Adding Detail: Expands on what you wrote
• Organizing Information: Uses bullets for multiple items
• Professional Language: Writes in clear, objective tone
• HTML Formatting: Adds proper formatting for the editor
• Removing Fluff: Removes phrases like "as requested" automatically

Smart Formatting

AI automatically chooses the best format based on your content:

Simple Tasks (1-2 Items)

AI writes 2-3 clear sentences in paragraph form.

Your Input: "Fix header on website"

AI Output:
"Fix the header on the website. The header is currently displaying incorrectly and needs to be corrected to match the design specifications."

Complex Tasks (3+ Items)

AI uses an introduction plus bullet points.

Your Input: "Build contact page with form, map, office info, and social links"

AI Output:
"Build a contact page with the following elements:

• Contact form with name, email, phone, and message fields
• Embedded Google Map showing office location
• Office information (address, phone, email, hours)
• Social media links

Bug Reports

AI uses "Current behavior" and "Expected behavior" format.

Your Input: "Mobile menu not opening on iPhone"

AI Output:
"Current Behavior: The mobile menu hamburger icon does not open the navigation menu when tapped on iPhone devices.

Expected Behavior: Tapping the hamburger icon should open the mobile navigation menu with a smooth slide-in animation."

Real Examples

Example 1: Simple Task

Your Input:
"We need a new hero section design for the homepage"

AI Output:
"Design a new hero section for the homepage. The hero section should be visually engaging and clearly communicate the main value proposition. Ensure the design is responsive and works well on all device sizes."

Example 2: Multi-Page Website

Your Input:
"Build 5-page website in Elementor: Home, About, Services, Portfolio, Contact. Responsive and match Figma."

AI Output:
"Build a 5-page website using Elementor with the following pages:

• Home page
• About page
• Services page
• Portfolio page
• Contact page

All pages must be fully responsive across desktop, tablet, and mobile devices. Design should match the provided Figma mockup."

Example 3: E-commerce Task

Your Input:
"Setup WooCommerce store with products, cart, checkout, Stripe payment"

AI Output:
"Setup WooCommerce store with the following components:

• Product pages with images, descriptions, and pricing
• Shopping cart functionality
• Checkout page with customer information fields
• Stripe payment gateway integration
• Order confirmation emails

Ensure all pages are mobile-responsive and follow e-commerce best practices."

Using the Regenerate Feature

If you don't like the first AI-generated description, you can regenerate it:

1. Click the Regenerate ↻ button in the modal
2. Wait 2-3 seconds for a new version
3. Review the new description
4. Keep regenerating until you get one you like, or click Cancel

Why regenerate?

• First version is too detailed or not detailed enough
• You want different wording
• You want a different format (bullets vs paragraphs)

Important Things to Know

AI Uses Only Your Information

AI only expands on what you wrote. It won't add features or details you didn't mention.

Example:
If you write "Build homepage", AI won't invent sections like "hero, services, testimonials". It will just expand on "Build homepage" generically.

To get better results, mention key elements in your brief description.

AI Removes Unwanted Phrases

AI automatically removes phrases like:

• "as requested"
• "as per client requirements"
• "client wants"
• "as discussed"

This keeps descriptions objective and professional.

You Can Edit After Using

After clicking "Use This", you can still manually edit the description in the editor to fine-tune it.

Best Practices

Provide Key Details

Include important information in your brief description:

• Platform: WordPress, Shopify, Webflow, Elementor
• Pages: List specific pages needed
• Features: Mention key features or sections
• Requirements: Responsive? Match design? Specific tools?

Good: "Build contact page"
Better: "Build contact page with form, map, and office info in Elementor"

Use for Client-Facing Tasks

Use AI expansion for tasks that clients or team members will see to ensure clear communication.

Review and Edit

Always review the AI output and edit if needed. AI is a starting point, not a final product.

Try Regenerate

If the first version isn't quite right, use Regenerate instead of starting over.

Cost

Each description expansion costs approximately $0.0005 (half a penny). For typical usage, this is extremely affordable.

Common Questions

Q: Can I use this on mobile?
A: Yes, the AI description expansion works on all devices.

Q: How many times can I regenerate?
A: As many times as you want, though each regeneration costs a small amount (~$0.0005).

Q: Can I edit the AI description after using it?
A: Yes! After clicking "Use This", you can edit the description in the editor like normal.

Q: What if AI adds something I don't want?
A: Click Cancel and either use your original description or manually edit it. You can also try regenerating for a different version.

Q: Does AI work with the rich text editor?
A: Yes, AI generates HTML-formatted content that works perfectly with the Summernote editor.

Q: How long does it take?
A: Usually 2-3 seconds for the initial expansion, same for regeneration.

Q: What if it fails?
A: Check that your admin has configured the OpenAI API key in Settings. If the problem persists, contact support.

Tips for Best Results

• Mention the platform or tool (Elementor, Shopify, etc.)
• List specific pages or sections needed
• Include key requirements (responsive, match design, etc.)
• Mention any specific features or functionality
• Keep your brief description focused on one task
• Use Regenerate if the first version isn't quite right

Need More Help?

Contact your project manager or email support@thrivepix.com