Intro to Plane Compose

Video Placeholder Duration: 4-6 minutes Topics covered: What is Compose, generating content, refining text, practical applications

---

What is Plane Compose?

Plane Compose is Plane's AI writing assistant that helps you create and refine content throughout the platform. Generate descriptions, improve documentation, and overcome writer's block.

Note: This is a focused recap from Plane 102 for the integration context.

---

Where Compose Works

Compose is available wherever you write:

• Work item descriptions
• Page content
• Comments
• Project descriptions

Look for the AI/Compose icon in any text editor.

---

Core Actions

Generate

Create new content from a prompt:

Prompt: "Write a bug report template for mobile issues"

Result: Full formatted bug report with sections for
device info, steps to reproduce, expected/actual behavior

Rephrase

Improve clarity and tone:

Before: "thing broke when clicking"
After: "Application crashes when the submit button is clicked"

Expand

Add more detail:

Before: "Add dark mode"
After: Full description with requirements, user stories,
and acceptance criteria

Summarize

Condense long content:

Before: Long detailed document
After: Concise 2-3 paragraph summary

Continue

Generate next section:

You write: "## Installation\n..."
Compose continues with configuration steps

---

Using Compose

Quick Access

1. Click into any text field
2. Click the Compose/AI icon
3. Select an action or enter a prompt

From Scratch

1. Start with an empty field
2. Open Compose
3. Describe what you need
4. Compose generates content
5. Edit and refine

Improving Existing Text

1. Select text to improve
2. Open Compose
3. Choose Rephrase, Expand, or Summarize
4. Review result
5. Accept or modify

---

Practical Examples

Work Item Descriptions

Input prompt:

Write a feature request for user profile customization
including avatar upload and theme preferences

Compose generates:

## Feature: User Profile Customization

### Overview
Allow users to personalize their profile with custom
avatars and theme preferences.

### Requirements
- Avatar upload (JPG, PNG, max 5MB)
- Theme selection (light, dark, system)
- Color accent customization

### User Stories
- As a user, I want to upload a custom avatar...
- As a user, I want to choose my theme preference...

### Acceptance Criteria
- [ ] Avatar upload works with supported formats
- [ ] Theme preference persists across sessions
- [ ] Changes reflect immediately

Documentation Pages

Input prompt:

Create an onboarding guide for new engineers

Compose generates: A structured document with sections for setup, tools, processes, and resources.

Comments

Input prompt:

Write a constructive code review comment about
error handling

Compose generates: A professional, helpful comment with specific suggestions and reasoning.

---

Tips for Better Results

Be Specific

❌ "Write something about the feature"
✅ "Write a user-facing description for a dark mode toggle
   feature targeting accessibility-conscious users"

Include Context

• What's the audience?
• What's the purpose?
• What format do you need?

Iterate

1. Generate first draft
2. Refine with specific prompts
3. Combine Compose with manual editing

Use for Drafts

Compose excels at:

• Getting started quickly
• Overcoming blank page
• Generating structure

Always review and personalize the output.

---

Compose vs Manual Writing

Use Compose For	Write Manually For
First drafts	Final polish
Structure	Unique voice
Repetitive content	Sensitive topics
Overcoming blocks	Brief updates

---

Key Takeaways

• Compose is Plane's AI writing assistant
• Available in work items, pages, and comments
• Actions: Generate, Rephrase, Expand, Summarize, Continue
• Be specific in prompts for better results
• Use for drafts, then refine manually
• Always review AI-generated content

---

Next Steps

Work with Plane from your terminal using Plane CLI.

Next Lesson: Intro to Plane CLI