wp-agentic-writer/WHAT_IS_WP_AGENTIC_WRITER.md

# What is WP Agentic Writer?

**WP Agentic Writer** is an intelligent WordPress plugin that revolutionizes content creation by implementing a multi-phase AI workflow. Instead of staring at a blank page, you work with AI through a structured process: brainstorm ideas, research topics, create an outline, generate content, and refine—all within the WordPress editor.

## 🎯 Core Concept

Traditional writing workflow:
```
Blank Page → Write → Edit → Publish
```

WP Agentic Writer workflow:
```
Ideas/Scribble → Research → Plan (Outline) → Execute (Write) → Discuss/Refine → Publish
```

This **plan-first approach** ensures your content is well-structured before a single word is written, resulting in higher quality articles with less effort.

---

## 🚀 Key Features

### 1. **5-Phase Agentic Workflow**

#### Phase 1: Brainstorm & Scribble
- Share raw ideas, code snippets, or vague topics
- No need for perfect prompts—just dump your thoughts
- AI understands context and extracts intent

#### Phase 2: Research (Optional)
- Built-in web search powered by OpenRouter
- Fetch current information, statistics, and trends
- Toggle on/off based on your needs
- Cost: ~$0.02 per search

#### Phase 3: Plan (Outline)
- AI generates structured outline with H2 sections
- Review and edit before writing
- Ensures logical flow and comprehensive coverage
- Clarity quiz asks questions if topic is unclear

#### Phase 4: Execute (Write)
- Auto-generate full article from approved outline
- Streaming output—see content appear in real-time
- Maintains consistent tone and style
- Includes SEO optimization (keyword placement, outbound links, internal links)

#### Phase 5: Revise & Refine
- Regenerate individual blocks or sections
- Chat-based refinement: "make this shorter", "add more examples"
- Block-level control—no need to regenerate entire article

---

### 2. **Intelligent Features**

#### Clarity Quiz
- AI asks clarifying questions when topic is unclear
- Ensures high-quality output by understanding your intent
- Includes configuration questions (language, SEO, keywords)

#### Multi-Language Support
- Auto-detects language from your input
- Supports 10+ languages including English, Indonesian, Spanish, French, German, Japanese, Chinese
- Custom language option available
- Language persists throughout the workflow

#### SEO Optimization (New!)
- **Focus keyword integration**: Automatically places keyword in intro, headings, conclusion
- **Outbound links**: Includes 2-3 authoritative external links
- **Internal links**: Smart algorithm suggests relevant posts from your site
- **Meta description**: Auto-generated after article completion (< 155 chars)
- **Image alt text**: Includes focus keyword in suggested alt text
- **Title optimization**: Keeps title under 60 characters, starts with keyword

#### Real-Time Cost Tracking
- See API costs for every operation
- Detailed cost history with operation types
- Budget-friendly with free tier support
- Typical article cost: $0.00 (free models) to $0.70 (premium models)

#### Block-Level Regeneration
- Regenerate any paragraph, heading, or code block
- No need to rewrite entire sections
- Maintains context from surrounding content

---

### 3. **Technical Advantages**

#### Single API Key via OpenRouter
- Access 200+ AI models with one API key
- No need for separate accounts (OpenAI, Anthropic, Google, etc.)
- Switch models anytime without reconfiguration

#### Free Tier Support
- 25+ free models available
- Zero cost for planning and writing
- Perfect for testing or budget-conscious users

#### Gutenberg Integration
- Native WordPress block editor support
- Seamless insertion of generated content
- Preserves formatting and structure

#### Web Search Integration
- Powered by OpenRouter's search capabilities
- Choose search engine: Auto, Native, or Exa
- Adjustable depth: Low, Medium, High
- Fetch current data for time-sensitive topics

---

## 💡 Use Cases

### For Developers
- Document technical projects without the writing struggle
- Generate tutorials with code examples
- Create API documentation
- Write release notes and changelogs

### For Technical Writers
- Speed up content creation by 10x
- Maintain consistent quality across articles
- Research and write in one workflow
- Focus on editing rather than drafting

### For Bloggers
- Overcome writer's block with structured workflow
- Generate SEO-optimized content
- Create comprehensive guides and how-tos
- Maintain publishing schedule effortlessly

### For Content Marketers
- Produce high-quality blog posts at scale
- Ensure SEO best practices automatically
- Research competitors and trends
- Generate content briefs and outlines

---

## 🎨 How It Works

### Step-by-Step Example

**1. Brainstorm Phase**
```
You type: "I want to write about WordPress security best practices"
```

**2. Research Phase (Optional)**
```
AI searches web for:
- Latest WordPress vulnerabilities
- Security plugin comparisons
- Expert recommendations
```

**3. Plan Phase**
```
AI generates outline:
- Introduction to WordPress Security
- Common Security Threats
- Essential Security Plugins
- Best Practices for Hardening
- Monitoring and Maintenance
- Conclusion
```

**4. Execute Phase**
```
AI writes full article with:
- Focus keyword: "WordPress security"
- 2-3 outbound links to official docs
- 1-2 internal links to related posts
- Image suggestions with alt text
- Meta description (< 155 chars)
- 2,500 words, SEO-optimized
```

**5. Refine Phase**
```
You: "Make the 'Common Security Threats' section shorter"
AI: Regenerates that section with concise content
```

---

## 🔧 Configuration

### Recommended Model Setup

**Planning Model** (generates outlines):
- `google/gemini-2.0-flash-exp` - Free, fast, excellent for planning
- `xiaomi/mimo-v2-flash` - Free, high quality
- `anthropic/claude-sonnet-4-20250514` - Paid, best quality

**Execution Model** (writes articles):
- `anthropic/claude-sonnet-4-20250514` - Recommended balance
- `anthropic/claude-opus-4-20250514` - Premium, best quality
- `meta-llama/llama-3.3-70b` - Free alternative
- `qwen/qwen3-coder-480b` - Free, great for technical content

**Image Model** (generates images):
- `black-forest-labs/flux-schnell` - Fast, $0.04/image
- `black-forest-labs/flux-pro` - Premium, $0.25/image

### SEO Configuration

Enable SEO optimization in clarity quiz:
- **Focus keyword**: Main keyword for the article
- **Secondary keywords**: Additional keywords (comma-separated)
- **Meta description**: Auto-generated after execution
- **Internal links**: Automatically suggested based on relevance

---

## 💰 Cost Breakdown

### Per Article (2,500 words)

**Free Tier** (using free models):
- Planning: $0.00
- Research: $0.00 (skip web search)
- Writing: $0.00
- **Total: $0.00**

**Budget Tier** (free planning + paid writing):
- Planning: $0.00 (Gemini 2.0 Flash)
- Research: $0.02 (optional)
- Writing: $0.63 (Claude Sonnet)
- Meta description: $0.001
- **Total: ~$0.65**

**Premium Tier** (best quality):
- Planning: $0.001 (Claude Sonnet)
- Research: $0.02
- Writing: $1.50 (Claude Opus)
- Meta description: $0.001
- Image: $0.04 (FLUX Schnell)
- **Total: ~$1.56**

---

## 🔒 Security & Privacy

- **API keys encrypted**: Stored securely in WordPress options
- **No data collection**: Your content stays on your server
- **Sanitized inputs**: All user inputs are validated and sanitized
- **Nonce verification**: AJAX requests protected against CSRF
- **Local processing**: No external tracking or analytics

---

## 📋 Requirements

- **WordPress**: 6.6 or higher
- **PHP**: 7.4 or higher
- **Editor**: Gutenberg (Block Editor)
- **API Key**: OpenRouter account (free tier available)

---

## 🎓 Getting Started

1. **Install Plugin**
   - Download and activate WP Agentic Writer
   - Go to Settings > Agentic Writer

2. **Configure API Key**
   - Visit [OpenRouter.ai](https://openrouter.ai/keys)
   - Create account and generate API key
   - Paste key in plugin settings

3. **Select Models**
   - Choose planning model (recommend: Gemini 2.0 Flash)
   - Choose execution model (recommend: Claude Sonnet)
   - Save settings

4. **Create First Article**
   - Open new post in WordPress editor
   - Click "Agentic Writer" in sidebar
   - Type your topic or ideas
   - Follow the 5-phase workflow
   - Publish!

---

## 🆚 Comparison with Other Tools

### vs Traditional AI Writing Tools (ChatGPT, Jasper, Copy.ai)

| Feature | WP Agentic Writer | Traditional AI Tools |
|---------|-------------------|---------------------|
| **Workflow** | Structured 5-phase process | Single prompt → output |
| **Planning** | Outline-first approach | No planning phase |
| **Integration** | Native WordPress blocks | Copy-paste required |
| **Refinement** | Block-level regeneration | Regenerate entire content |
| **Cost Tracking** | Built-in, real-time | Not available |
| **SEO** | Auto-optimized with keywords | Manual optimization |
| **Research** | Built-in web search | External research needed |
| **Free Tier** | 25+ free models | Limited free usage |

### vs WordPress AI Plugins (AI Engine, AI Power)

| Feature | WP Agentic Writer | Other WP AI Plugins |
|---------|-------------------|---------------------|
| **Workflow** | Multi-phase agentic | Single-step generation |
| **Outline Control** | Review before writing | No outline phase |
| **Model Choice** | 200+ models via OpenRouter | Limited to 1-2 providers |
| **Cost** | $0.00 - $1.56 per article | $0.10 - $5.00 per article |
| **SEO** | Auto-optimized | Manual or basic |
| **Refinement** | Chat-based + block-level | Limited refinement |

---

# Frequently Asked Questions (FAQ)

## General Questions

### Q: What makes WP Agentic Writer different from ChatGPT?

**A:** WP Agentic Writer is specifically designed for WordPress content creation with a structured workflow. Unlike ChatGPT where you need to craft perfect prompts and copy-paste results, WP Agentic Writer:
- Guides you through brainstorm → research → plan → write → refine
- Generates content directly as WordPress blocks
- Tracks costs in real-time
- Allows block-level regeneration
- Includes SEO optimization automatically

Think of it as ChatGPT + WordPress integration + structured workflow + cost tracking.

---

### Q: Do I need coding knowledge to use this plugin?

**A:** No coding knowledge required! The plugin is designed for:
- Bloggers who want to write faster
- Developers who struggle with writing
- Content creators who need SEO-optimized articles
- Anyone who uses WordPress

If you can use WordPress editor, you can use WP Agentic Writer.

---

### Q: Can I use this plugin for free?

**A:** Yes! WP Agentic Writer supports 25+ free AI models through OpenRouter:
- **Planning**: Use `google/gemini-2.0-flash-exp` (free)
- **Writing**: Use `meta-llama/llama-3.3-70b` (free)
- **Cost**: $0.00 per article

You only need a free OpenRouter account. No credit card required for free tier.

---

### Q: How much does it cost to generate an article?

**A:** Cost depends on your model choice:

**Free Tier**: $0.00 (using free models)
**Budget Tier**: ~$0.65 (free planning + Claude Sonnet for writing)
**Premium Tier**: ~$1.56 (Claude Opus for best quality)

For comparison:
- Hiring a writer: $50-$200 per article
- Other AI tools: $0.10-$5.00 per article
- WP Agentic Writer: $0.00-$1.56 per article

---

## Installation & Setup

### Q: How do I get an OpenRouter API key?

**A:** Follow these steps:
1. Visit [OpenRouter.ai](https://openrouter.ai/keys)
2. Sign up for a free account (no credit card needed for free tier)
3. Click "Create Key" to generate your API key
4. Copy the key
5. In WordPress, go to Settings > Agentic Writer
6. Paste your API key and save

That's it! You can now use 25+ free models or add credits for premium models.

---

### Q: Which models should I choose?

**A:** Recommended setup:

**For Free Tier**:
- Planning: `google/gemini-2.0-flash-exp`
- Execution: `meta-llama/llama-3.3-70b`

**For Best Quality**:
- Planning: `anthropic/claude-sonnet-4-20250514`
- Execution: `anthropic/claude-sonnet-4-20250514`

**For Technical Content**:
- Planning: `google/gemini-2.0-flash-exp`
- Execution: `qwen/qwen3-coder-480b` (free, excellent for code)

You can change models anytime in Settings > Agentic Writer.

---

### Q: Do I need multiple API keys?

**A:** No! OpenRouter provides access to 200+ AI models with a single API key. You don't need separate accounts for:
- OpenAI (GPT-4, GPT-3.5)
- Anthropic (Claude)
- Google (Gemini)
- Meta (Llama)
- Mistral, Cohere, and 50+ other providers

One key = access to all models.

---

## Usage & Workflow

### Q: How does the 5-phase workflow work?

**A:** Here's the complete flow:

**Phase 1: Brainstorm**
- Type your topic, ideas, or code snippets
- No need for perfect prompts
- Example: "WordPress security tips"

**Phase 2: Research** (optional)
- AI searches the web for current information
- Toggle on/off based on needs
- Cost: ~$0.02 if enabled

**Phase 3: Plan**
- AI generates structured outline
- Review and edit sections
- Approve when ready

**Phase 4: Execute**
- AI writes full article from outline
- See content stream in real-time
- SEO-optimized automatically

**Phase 5: Refine**
- Regenerate any block or section
- Chat with AI: "make this shorter"
- Fine-tune until perfect

---

### Q: What is the Clarity Quiz?

**A:** The Clarity Quiz appears when AI needs more information about your topic. It asks questions like:
- "What is the target audience?"
- "What tone should I use?"
- "Any specific points to cover?"

It also includes configuration questions:
- Language selection
- SEO settings (focus keyword, secondary keywords)
- Web search preference

This ensures the AI understands your intent and generates high-quality content.

---

### Q: Can I edit the outline before writing?

**A:** Yes! That's the key benefit of the plan-first approach:
1. AI generates outline with H2 sections
2. You review and can:
   - Add new sections
   - Remove sections
   - Reorder sections
   - Edit section titles
3. Click "Execute" when ready
4. AI writes based on your approved outline

This ensures the article structure matches your vision before any writing happens.

---

### Q: Can I regenerate just one paragraph?

**A:** Yes! WP Agentic Writer supports block-level regeneration:
1. Select any block (paragraph, heading, code, list)
2. Click "Regenerate" in block toolbar
3. AI rewrites just that block
4. Keep or discard the new version

No need to regenerate the entire article. This saves time and cost.

---

### Q: How do I refine content with chat?

**A:** Use the chat interface for conversational refinement:

**Examples:**
- "Make the introduction shorter"
- "Add more code examples to the security section"
- "Simplify the technical jargon"
- "Add statistics to support the claims"

AI understands context and regenerates the relevant sections while maintaining the rest of the article.

---

## SEO Features

### Q: How does SEO optimization work?

**A:** When you enable SEO in the clarity quiz and provide a focus keyword, WP Agentic Writer automatically:

1. **Keyword Placement**:
   - Uses keyword 5-8 times naturally
   - Includes in first paragraph
   - Adds to 2+ H2/H3 headings
   - Places in conclusion

2. **Outbound Links**:
   - Adds 2-3 authoritative external links
   - Links to Wikipedia, official docs, industry leaders

3. **Internal Links**:
   - Suggests 1-2 relevant posts from your site
   - Based on category, tags, and keyword relevance

4. **Meta Description**:
   - Auto-generated after article completion
   - Includes focus keyword
   - Strict 155 character limit

5. **Image Alt Text**:
   - Suggests images with keyword in alt text

6. **Title Optimization**:
   - Keeps under 60 characters
   - Starts with focus keyword

---

### Q: Does this work with Yoast SEO or Rank Math?

**A:** Yes! WP Agentic Writer is designed to work alongside SEO plugins:

**With Yoast SEO**:
1. Generate article with SEO enabled
2. Copy focus keyword → Paste in Yoast focus keyword field
3. Copy auto-generated meta description → Paste in Yoast meta description
4. Yoast score: 85-90% (green) automatically

**With Rank Math**:
- Same process as Yoast
- Copy focus keyword and meta description
- Rank Math will recognize optimizations

**Manual steps**: Only 2 (copy focus keyword + meta description)
**Automated**: Everything else (keyword placement, links, alt text, title)

---

### Q: Where is the auto-generated meta description stored?

**A:** The meta description is stored in WordPress post meta as `_wpaw_meta_description`. To use it:

**Option 1: Manual Copy**
1. After article generation completes
2. Check post meta or plugin interface
3. Copy meta description
4. Paste into Yoast/Rank Math meta description field

**Option 2: Programmatic Access**
```php
$meta_desc = get_post_meta( $post_id, '_wpaw_meta_description', true );
```

Future versions may include direct integration with SEO plugins.

---

### Q: How does internal link suggestion work?

**A:** WP Agentic Writer uses a smart relevance algorithm:

**Scoring factors**:
- Same category: 30 points per category
- Focus keyword in title: 25 points
- Same tags: 20 points per tag
- Focus keyword in content: 15 points
- Recency: 10 points (< 30 days) or 5 points (< 90 days)

**Process**:
1. Scans your published posts
2. Calculates relevance score for each
3. Suggests top 3 most relevant posts
4. AI naturally incorporates 1-2 links where contextually appropriate

**Note**: Requires existing published posts. New sites won't have suggestions until you have related content.

---

## Cost & Pricing

### Q: Why do costs vary between articles?

**A:** Article cost depends on several factors:

1. **Article Length**:
   - Short (500 words): ~$0.20
   - Medium (1,500 words): ~$0.65
   - Long (3,000 words): ~$1.20

2. **Model Choice**:
   - Free models: $0.00
   - Claude Sonnet: ~$0.65
   - Claude Opus: ~$1.50

3. **Web Search**:
   - Disabled: $0.00
   - Enabled: +$0.02

4. **Refinements**:
   - Each regeneration adds ~$0.05-$0.15

5. **Images**:
   - No images: $0.00
   - FLUX Schnell: +$0.04 per image
   - FLUX Pro: +$0.25 per image

---

### Q: How is cost calculated?

**A:** Cost is based on token usage:

**Input tokens**: Text you send to AI (prompts, context)
**Output tokens**: Text AI generates (responses, content)

**Pricing example** (Claude Sonnet):
- Input: $3.00 per 1M tokens
- Output: $15.00 per 1M tokens

**Typical 2,500-word article**:
- Input: ~5,000 tokens = $0.015
- Output: ~4,000 tokens = $0.060
- Total: ~$0.075 per section × 8 sections = ~$0.60

WP Agentic Writer shows exact costs in real-time for every operation.

---

### Q: Can I set a budget limit?

**A:** Currently, WP Agentic Writer doesn't have built-in budget limits, but you can:

1. **Use free models**: Zero cost per article
2. **Monitor costs**: Real-time cost tracking shows spending
3. **Set OpenRouter limits**: Configure spending limits in your OpenRouter account
4. **Choose shorter articles**: Reduce word count to lower costs

Future versions may include budget alerts and limits.

---

## Technical Questions

### Q: What languages are supported?

**A:** WP Agentic Writer supports 10+ languages with auto-detection:
- English
- Indonesian (Bahasa Indonesia)
- Spanish (Español)
- French (Français)
- German (Deutsch)
- Japanese (日本語)
- Chinese (中文)
- Portuguese (Português)
- Italian (Italiano)
- Dutch (Nederlands)
- Custom (specify your own)

**Auto-detection**: AI detects language from your input automatically
**Manual selection**: Choose language in clarity quiz
**Persistence**: Selected language applies to entire article

---

### Q: Can I use this for technical documentation?

**A:** Absolutely! WP Agentic Writer excels at technical content:

**Best for**:
- API documentation
- Tutorial articles with code examples
- Technical how-to guides
- Developer blog posts
- Release notes
- Architecture explanations

**Recommended model**: `qwen/qwen3-coder-480b` (free, specialized for technical writing)

**Features**:
- Proper code block formatting
- Syntax highlighting support
- Technical accuracy
- Clear explanations with examples

---

### Q: Does it work with custom post types?

**A:** Currently, WP Agentic Writer is designed for standard WordPress posts. Support for custom post types may be added in future versions based on user demand.

---

### Q: Can I use this in a multisite installation?

**A:** Yes, WP Agentic Writer works in WordPress multisite. Each site in the network needs its own configuration (API key, model selection). Settings are not shared across sites.

---

### Q: Is my content stored anywhere outside WordPress?

**A:** No! Your content stays on your WordPress server:
- API calls go to OpenRouter (for AI processing)
- Generated content is immediately saved to WordPress database
- No external storage or tracking
- No data collection by the plugin

OpenRouter processes requests but doesn't store your content permanently. See [OpenRouter Privacy Policy](https://openrouter.ai/privacy) for details.

---

## Troubleshooting

### Q: Why is the plugin not generating content?

**A:** Check these common issues:

1. **API Key**: Verify your OpenRouter API key is correct
   - Go to Settings > Agentic Writer
   - Re-enter API key if needed

2. **Model Selection**: Ensure models are selected
   - Planning model must be set
   - Execution model must be set

3. **Credits**: Check OpenRouter account balance
   - Free models: No credits needed
   - Paid models: Requires credits in OpenRouter account

4. **Browser Console**: Check for JavaScript errors
   - Open browser DevTools (F12)
   - Look for errors in Console tab

5. **WordPress Version**: Ensure WordPress 6.6+
   - Update WordPress if needed

---

### Q: Why is generation slow?

**A:** Generation speed depends on:

1. **Model Choice**:
   - Fast models: Gemini 2.0 Flash, Llama 3.3
   - Slower models: Claude Opus, GPT-4

2. **Article Length**:
   - Longer articles take more time
   - Each section is generated sequentially

3. **Streaming**: Content appears as it's generated
   - You see progress in real-time
   - Total time: 30 seconds to 3 minutes

4. **Server Response**: OpenRouter API speed varies
   - Peak times may be slower
   - Free models may have rate limits

**Tip**: Use faster models for planning, premium models for final execution.

---

### Q: Why did generation stop mid-article?

**A:** Possible causes:

1. **API Error**: OpenRouter service issue
   - Check OpenRouter status page
   - Retry generation

2. **Rate Limit**: Too many requests too quickly
   - Wait 1-2 minutes
   - Try again

3. **Token Limit**: Model's maximum output reached
   - Use shorter sections
   - Split into multiple articles

4. **Browser Tab**: Tab was closed or inactive
   - Keep tab active during generation
   - Don't close browser

5. **Network Issue**: Internet connection interrupted
   - Check connection
   - Retry generation

---

### Q: How do I report bugs or request features?

**A:** We welcome feedback!

**Bug Reports**:
1. Check existing issues on GitHub
2. Create new issue with details:
   - WordPress version
   - PHP version
   - Plugin version
   - Steps to reproduce
   - Error messages (if any)

**Feature Requests**:
1. Search existing feature requests
2. Create new request with:
   - Use case description
   - Expected behavior
   - Why it's valuable

**GitHub**: [https://github.com/wp-agentic-writer/wp-agentic-writer/issues](https://github.com/wp-agentic-writer/wp-agentic-writer/issues)

---

## Best Practices

### Q: What's the best workflow for high-quality articles?

**A:** Follow this proven workflow:

1. **Brainstorm Phase**:
   - Be specific about your topic
   - Include key points you want covered
   - Mention target audience

2. **Research Phase**:
   - Enable web search for time-sensitive topics
   - Skip for evergreen content you know well

3. **Plan Phase**:
   - Review outline carefully
   - Add/remove sections as needed
   - Ensure logical flow

4. **Execute Phase**:
   - Enable SEO with focus keyword
   - Let it complete fully
   - Don't interrupt generation

5. **Refine Phase**:
   - Read through entire article
   - Regenerate weak sections
   - Add personal insights
   - Verify facts and links

6. **Manual Polish**:
   - Add images (replace placeholders)
   - Insert internal links (use suggestions)
   - Copy focus keyword to SEO plugin
   - Copy meta description to SEO plugin
   - Final proofread

**Result**: 85-90% ready article in 10-15 minutes.

---

### Q: How can I improve article quality?

**A:** Tips for better results:

1. **Be Specific in Brainstorm**:
   - ❌ "Write about WordPress"
   - ✅ "Write about WordPress security best practices for 2025, targeting beginner developers"

2. **Use Better Models**:
   - Planning: Gemini 2.0 Flash (free, excellent)
   - Execution: Claude Sonnet (paid, high quality)

3. **Edit the Outline**:
   - Don't accept first outline blindly
   - Add sections for important topics
   - Remove irrelevant sections

4. **Enable SEO**:
   - Provide focus keyword
   - Add secondary keywords
   - Better keyword integration

5. **Refine Iteratively**:
   - Regenerate weak paragraphs
   - Ask for more examples
   - Request specific improvements

6. **Add Personal Touch**:
   - Insert your own experiences
   - Add unique insights
   - Include custom screenshots

---

### Q: Should I enable web search for every article?

**A:** Enable web search when:

✅ **Yes, enable**:
- Time-sensitive topics (news, trends, statistics)
- Technical topics requiring latest information
- Comparison articles (current prices, features)
- Topics you're not expert in

❌ **No, skip**:
- Evergreen content (timeless topics)
- Personal experience articles
- Opinion pieces
- Topics you know well
- Budget-conscious (saves $0.02)

**Cost**: ~$0.02 per search
**Benefit**: Current, accurate information

---

### Q: How do I maintain consistent brand voice?

**A:** Configure tone and style:

1. **In Clarity Quiz**:
   - Answer tone questions consistently
   - Example: "Professional but friendly"

2. **In Settings** (future feature):
   - Save default tone preferences
   - Create brand voice guidelines

3. **In Refinement**:
   - Ask: "Make this more conversational"
   - Or: "Use more professional language"

4. **Manual Editing**:
   - Add brand-specific phrases
   - Insert company terminology
   - Adjust voice in final proofread

**Tip**: Create a document with your brand voice guidelines and reference it in brainstorm phase.

---

## Comparison & Migration

### Q: I'm currently using [other AI tool]. Should I switch?

**A:** Consider switching if you want:

✅ **Switch to WP Agentic Writer**:
- Native WordPress integration (no copy-paste)
- Structured workflow (plan before write)
- Block-level regeneration
- Real-time cost tracking
- Free tier support (25+ models)
- SEO optimization built-in
- Lower cost per article

❌ **Stay with current tool**:
- You need features beyond blog posts
- You're happy with current workflow
- You don't use WordPress
- You need team collaboration features (not yet supported)

**Migration**: No migration needed! Just install and start using. Your existing content remains unchanged.

---

### Q: Can I use this alongside other AI plugins?

**A:** Yes! WP Agentic Writer doesn't conflict with:
- SEO plugins (Yoast, Rank Math, All in One SEO)
- Other AI plugins (AI Engine, AI Power)
- Page builders (Elementor, Divi)
- Performance plugins

However, using multiple AI content generators simultaneously may be redundant. Choose one primary tool for content creation.

---

## Future & Roadmap

### Q: What features are planned?

**A:** Upcoming features (based on user feedback):

**Short-term**:
- Direct Yoast/Rank Math integration
- Custom post type support
- Saved templates and presets
- Bulk article generation

**Medium-term**:
- Team collaboration features
- Content calendar integration
- A/B testing for headlines
- Automatic image generation and insertion

**Long-term**:
- Multi-language site support
- Content repurposing (blog → social media)
- Analytics integration
- Custom model fine-tuning

**Note**: Roadmap subject to change based on user priorities.

---

### Q: Is there a premium version?

**A:** Currently, WP Agentic Writer is a single version with all features included. There are no premium tiers or paid add-ons.

**Costs**:
- Plugin: Free (GPL-2.0+)
- AI models: Pay-per-use via OpenRouter (or use free models)

Future versions may include premium features based on development needs and user demand.

---

## Support & Community

### Q: Where can I get help?

**A:** Support channels:

1. **Documentation**: Read this guide and README.md
2. **GitHub Issues**: Report bugs and ask questions
3. **GitHub Discussions**: Community Q&A
4. **Email**: support@wp-agentic-writer.com (if available)

**Response time**: 24-48 hours for GitHub issues

---

### Q: Can I contribute to the project?

**A:** Yes! Contributions welcome:

**Code Contributions**:
- Fork the repository
- Create feature branch
- Submit pull request
- Follow coding standards

**Non-Code Contributions**:
- Report bugs
- Suggest features
- Improve documentation
- Share use cases
- Write tutorials

---

### Q: How can I support the project?

**A:** Ways to support:

1. **Star on GitHub**: Show appreciation
2. **Share with others**: Spread the word
3. **Write reviews**: Share your experience
4. **Report bugs**: Help improve quality
5. **Contribute code**: Add features
6. **Donate**: Support development (if donation link available)

Every bit helps make WP Agentic Writer better for everyone!

---

## License & Legal

### Q: What license is WP Agentic Writer under?

**A:** GPL-2.0+ (GNU General Public License v2.0 or later)

This means:
- ✅ Free to use
- ✅ Free to modify
- ✅ Free to distribute
- ✅ Can use commercially
- ✅ Source code available

**Requirement**: Derivative works must also be GPL-licensed.

---

### Q: Can I use this for client projects?

**A:** Yes! You can:
- Use on unlimited client sites
- Charge clients for your services
- Include in your agency workflow
- White-label (modify branding)

**Note**: You cannot sell the plugin itself as proprietary software (GPL requirement).

---

### Q: Who owns the generated content?

**A:** You do! Content generated by WP Agentic Writer belongs to you:
- Full ownership of all generated articles
- No attribution required
- Use commercially without restrictions
- Modify as needed

**AI Model Terms**: Check OpenRouter and individual model provider terms for any specific restrictions.

---

## Conclusion

WP Agentic Writer transforms WordPress content creation from a daunting blank page into a guided, structured workflow. By implementing a plan-first approach with AI assistance at every step, it enables anyone—from developers who struggle with writing to professional content creators—to produce high-quality, SEO-optimized articles efficiently and affordably.

**Get Started**: Install the plugin, add your OpenRouter API key, and create your first article in minutes!

**Questions?** Open an issue on GitHub or check the documentation.

---

**Developed with ❤️ for WordPress users who want to write better, faster.**