# Claude AI Copywriter - Complete User Guide
**Part of the Kinetic Framework**

Version 1.6.0 | Last Updated: April 8, 2026

---

## Table of Contents

1. [Welcome to Claude AI Copywriter](#welcome)
2. [Getting Started](#getting-started)
3. [License Activation & Management](#license-management)
4. [Authentication Setup](#authentication-setup)
4. [Features Overview](#features-overview)
5. [Copywriting Studio](#copywriting-studio)
6. [Tone & Persona Management](#tone-persona-management)
7. [Content Library](#content-library)
8. [Rewrite with Tone](#rewrite-with-tone)
9. [Schema JSON-LD](#schema-json-ld)
10. [Brain - AI Chat Assistant](#brain-chat-assistant)
11. [Content Analysis](#content-analysis)
12. [Breakdance Integration](#breakdance-integration)
13. [Integrations](#integrations)
14. [Best Practices](#best-practices)
14. [Troubleshooting](#troubleshooting)
15. [FAQ](#faq)

---

## Welcome to Claude AI Copywriter {#welcome}

Claude AI Copywriter is a professional WordPress plugin that brings the power of Anthropic's Claude AI directly into your WordPress admin and Breakdance page builder. As part of the **Kinetic Framework**, it's designed to streamline your content creation workflow with:

- **AI-powered copywriting** with tone blending (up to 4 tones) and persona targeting
- **Brain AI assistant** - conversational chat inside wp-admin that knows your site and brand
- **Rewrite with Tone** - rewrite any post in a saved tone template with preview and one-click revert
- **Schema JSON-LD** generation with auto-inject via `wp_head`
- **Content Library** with folders, tags, ratings, and prompt/output separation
- **Deep Breakdance integration** with native builder element
- **Content analysis** engine with 6 scoring metrics
- **KineticBrand Sync** - auto-populate brand voice from KineticBrand
- **Enterprise-grade security** with AES-256 encryption, injection detection, output leak filter

### Who Is This For?

- **Marketing Teams** - Scale content creation without hiring
- **Agencies** - Manage multiple client brand voices
- **Breakdance Users** - Build pages 3x faster with AI copy
- **Content Creators** - Generate professional copy instantly

---

## Getting Started {#getting-started}

### System Requirements

- WordPress 6.0 or higher
- PHP 8.0 or higher with OpenSSL extension
- MySQL 5.7+ or MariaDB 10.3+
- HTTPS (recommended for production)
- Modern browser (Chrome, Firefox, Safari, Edge)

### Installation

1. **Download the Plugin**
   - You should have `claude-ai-copywriter.zip`

2. **Install in WordPress**
   - Go to: WordPress Admin → Plugins → Add New
   - Click "Upload Plugin"
   - Choose `claude-ai-copywriter.zip`
   - Click "Install Now"

3. **Activate**
   - Click "Activate Plugin"
   - You'll see "Claude AI Copywriter" in your admin menu

4. **Initial Setup**
   - Go to: Claude AI → Settings
   - Add your Anthropic API key
   - Configure your preferences

---

## License Activation & Management {#license-management}

KineticCopy uses license keys to unlock premium features. Your license key was provided when you purchased KineticLaunch (Tier 2 and above include a KineticCopy license automatically).

### Activating Your License

1. **Find your license key** - Your key starts with `KB-` and was included in your purchase confirmation email. You can also find it in your [KineticLaunch account dashboard](https://launch.kineticbrain.ai/licenses/manage).

2. **Enter the key in WordPress**
   - Go to: WordPress Admin > Claude AI > Settings > License
   - Paste your license key in the field
   - Click "Activate"

3. **Verify activation** - Once activated, you'll see your tier (Premium, Pro, or Agency) and the number of site activations used.

### Managing Your Activations

Each license key has a limited number of site activations (the exact number depends on your tier). If you need to move KineticCopy to a different WordPress site, you can deactivate an existing site to free up a slot.

**Online license management portal:** [https://licensing.kineticbrain.ai](https://licensing.kineticbrain.ai)

From this portal you can:
- View your current activations and which sites are using your license
- Remove a site to free up an activation slot
- Check your license status and expiry

You can also manage your full account (including KineticLaunch tier, credits, and all licenses) by signing in at [https://launch.kineticbrain.ai/licenses/manage](https://launch.kineticbrain.ai/licenses/manage).

### License Tiers

| Tier | Sites | Price |
|---|---|---|
| **Solo** | 1 site | $79/yr |
| **Studio** | 3 sites | $199/yr |
| **Agency** | 25 sites | $349/yr |
| **Enterprise** | Unlimited | $599/yr |

Every feature is included in every tier - 43 content types, Brain AI, Writing DNA profiling, tone templates, Rewrite with Tone, AEO/GEO schema, Content Library, KineticLaunch Calendar Sync, bidirectional status sync, Breakdance native element, and research engine. Tiers differ only by site count. Enterprise additionally gets a dedicated support channel.

**BYOK - Bring Your Own Claude API Key:** KineticCopy does not charge per generation. You use your own Anthropic API key and pay Anthropic directly at their rates. KineticCopy licensing covers access to the plugin features only.

### Need Help?

If you have trouble activating your license or need to reset your activations, contact [support@kineticbrain.ai](mailto:support@kineticbrain.ai).

---

## Authentication Setup {#authentication-setup}

Claude AI Copywriter supports authentication through Anthropic API keys. Here's how to set it up:

### Step 1: Get Your API Key

1. **Visit Anthropic Console**
   - Go to: https://console.anthropic.com/settings/keys
   - Sign in or create an account

2. **Create API Key**
   - Click "Create Key"
   - Give it a name (e.g., "WordPress Plugin")
   - Copy the key (starts with `sk-ant-api03-`)

### Step 2: Add Key to Plugin

1. **Navigate to Settings**
   - WordPress Admin → Claude AI → Settings
   - Click the "Authentication" tab

2. **Enter Your API Key**
   - Paste your API key in the field
   - (Optional) Give it a descriptive name
   - Click "Save Key"

3. **Test the Connection**
   - Click "Test Key" button
   - You should see: ✓ "API key is valid"

### Understanding Authentication Options

#### API Key (Pay-as-you-go)
- **Best for:** High-volume usage
- **Billing:** Pay only for what you use
- **Setup:** Get key from console.anthropic.com
- **Security:** Encrypted with AES-256 before storage

#### Claude Pro Subscription
- **Best for:** Predictable monthly costs
- **Billing:** $20/mo for Claude Pro
- **Note:** You still need an API key from console.anthropic.com (separate from claude.ai login)

### Security Features

- **AES-256 Encryption** - Your API key is encrypted before storage
- **wp-config.php Support** - Move encryption key to wp-config for enhanced security
- **Secure Communication** - All API calls use HTTPS
- **No Key Exposure** - Keys never sent to frontend

---

## Features Overview {#features-overview}

### 1. Copywriting Studio
Generate professional copy with AI assistance:
- Headlines, CTAs, paragraphs, blog posts
- Up to 4 blended tones
- Persona-targeted messaging
- Character/word count constraints

### 2. Tone Management
Create and save tone templates:
- 24 preset tones (Professional, Friendly, Bold, etc.)
- Blend up to 4 tones simultaneously
- Save templates for reuse
- Context-aware tone application

### 3. Persona System
Define your target audience:
- Demographics (age, location, interests)
- Psychographics (values, pain points, goals)
- Behavioral traits
- Communication style preferences

### 4. Snippet Library
Organize your best copy:
- Rate snippets 1-5 stars
- Organize by folders
- Tag for easy searching
- One-click copy to clipboard

### 5. Content Analysis
AI-powered page reviews:
- Headline effectiveness scoring
- Opening hook strength
- Clarity and readability analysis
- CTA optimization suggestions
- SEO opportunities
- Tone consistency check

### 6. Dashboard Widget
At-a-glance insights:
- Total snippets saved
- Recent AI generations
- Content analysis scores
- Quick action buttons

### 7. Breakdance Integration
In-builder AI copywriting:
- Custom toolbar button
- Element-level content generation
- Context-aware prompts
- Seamless workflow

### 8. KineticBrand Sync
Pull your full brand strategy from KineticBrand automatically:
- Paste your KineticBrand API key + Project ID to sync
- Brand name, tagline, positioning, audience, tone of voice, values, and vocabulary all populate instantly
- No copy-pasting or manual entry required
- Works with or without KineticBrand - you can fill fields manually too

---

## Copywriting Studio {#copywriting-studio}

### Accessing the Studio

**WordPress Admin → Claude AI → Copywriting Studio**

### Basic Workflow

1. **Select Content Type**
   ```
   - Headline
   - Subheadline
   - Call to Action (CTA)
   - Paragraph
   - Blog Post
   - Product Description
   - Email Subject Line
   - Social Media Post
   ```

2. **Choose or Create Tone**
   - Select from saved tone templates
   - Or blend new tones (up to 4)

3. **Select or Create Persona**
   - Choose target audience
   - Or create new persona

4. **Add Context (Optional)**
   - Product/service details
   - Key benefits
   - Keywords to include
   - Competitor references

5. **Set Constraints**
   - Character limit
   - Word count
   - Specific format requirements

6. **Generate**
   - Click "Generate Copy"
   - AI creates 3 variations
   - Review and select best

7. **Save or Use**
   - Copy to clipboard
   - Save to snippet library
   - Insert directly into page

### Example Use Cases

#### Use Case 1: Generate Blog Post Headline

```
Content Type: Headline
Tone: Bold + Persuasive
Persona: Tech-savvy Marketers (25-40, SaaS industry)
Context: "Article about AI in content marketing, focus on ROI"
Constraint: 60 characters max

Generated:
1. "AI Content Marketing: 300% ROI in 90 Days"
2. "How Smart Marketers Use AI to Triple Content ROI"
3. "The AI Marketing Revolution: Real Results, Real Fast"
```

#### Use Case 2: Create CTA Button

```
Content Type: Call to Action
Tone: Direct + Urgent
Persona: Small Business Owners
Context: "Free trial of project management software"
Constraint: 25 characters max

Generated:
1. "Start Free Trial Now"
2. "Get Organized Today"
3. "Try Free for 30 Days"
```

---

## Tone & Persona Management {#tone-persona-management}

### Tone Templates

#### Available Preset Tones

1. **Professional** - Formal, credible, authoritative
2. **Friendly** - Warm, approachable, conversational
3. **Bold** - Confident, assertive, attention-grabbing
4. **Inspirational** - Motivating, uplifting, aspirational
5. **Persuasive** - Convincing, compelling, action-oriented
6. **Casual** - Relaxed, informal, relatable
7. **Authoritative** - Expert, definitive, commanding
8. **Empathetic** - Understanding, compassionate, supportive
9. **Humorous** - Witty, playful, entertaining
10. **Urgent** - Time-sensitive, pressing, immediate
11. **Educational** - Informative, instructive, clarifying
12. **Luxurious** - Premium, exclusive, sophisticated
13. **Technical** - Precise, detailed, specialized
14. **Direct** - Straightforward, clear, to-the-point
15. **Conversational** - Dialogue-like, engaging, natural

#### Tone Blending Guidelines

**2 Tones (Recommended for most use cases)**
```
Professional + Friendly = Approachable expertise
Bold + Persuasive = Powerful sales copy
Direct + Empathetic = Clear and caring
```

**3 Tones (Advanced)**
```
Professional + Persuasive + Urgent = High-converting B2B
Friendly + Inspirational + Conversational = Engaging lifestyle
Bold + Direct + Authoritative = Thought leadership
```

**4 Tones (Expert-level)**
```
Professional + Persuasive + Empathetic + Direct = Complex B2B sales
Friendly + Inspirational + Humorous + Conversational = Viral social content
```

⚠️ **Best Practice:** Start with 1-2 tones. Add more only when needed for nuanced messaging.

#### Creating a Tone Template

1. **Navigate to Tone Manager**
   - WordPress Admin → Claude AI → Settings → General
   - Or from Copywriting Studio

2. **Select Tones**
   - Choose 1-4 tones from dropdown
   - See live preview of blend

3. **Name Your Template**
   - e.g., "SaaS Landing Pages"
   - e.g., "Email Nurture Sequence"

4. **Save Template**
   - Available for all future generations
   - Can be edited or deleted

### Persona Creation

#### Persona Components

**Demographics**
- Age range
- Location/region
- Industry/profession
- Company size (B2B)
- Income level (B2C)

**Psychographics**
- Core values
- Pain points
- Goals and aspirations
- Challenges and frustrations
- Motivations

**Behavioral Traits**
- Decision-making style
- Information consumption habits
- Preferred communication channels
- Tech-savviness level

**Communication Preferences**
- Formality level
- Detail vs. overview
- Emotional vs. logical appeals
- Risk tolerance

#### Example Personas

**Persona 1: Tech-Savvy Marketing Manager**
```
Demographics:
- Age: 28-40
- Location: Urban, US/EU
- Industry: B2B SaaS
- Company: 50-500 employees

Psychographics:
- Values: Innovation, efficiency, data-driven decisions
- Pain Points: Limited resources, content bottlenecks
- Goals: Scale marketing, improve ROI
- Challenges: Keeping up with trends

Behaviors:
- Early adopter of new tools
- Consumes content via podcasts, LinkedIn
- Makes quick decisions with data backing
- High tech-savviness

Communication:
- Professional but not overly formal
- Wants specifics and proof points
- Responds to ROI and efficiency claims
- Appreciates directness
```

**Persona 2: Small Business Owner**
```
Demographics:
- Age: 35-55
- Location: Suburban/Rural
- Industry: Local services
- Company: 1-10 employees

Psychographics:
- Values: Reliability, personal service, community
- Pain Points: Time constraints, tech overwhelm
- Goals: Grow business sustainably
- Challenges: Marketing knowledge gaps

Behaviors:
- Cautious adopter
- Prefers simple, proven solutions
- Values relationships over transactions
- Moderate tech-savviness

Communication:
- Friendly and supportive
- Clear, jargon-free explanations
- Focus on practical benefits
- Builds trust through testimonials
```

---

## Snippet Library {#snippet-library}

### Accessing Snippet Library

**WordPress Admin → Claude AI → Snippets**

### Features

#### Organizing Snippets

1. **Folders**
   - Create: Click "New Folder"
   - Nest folders for deep organization
   - Examples: "Headlines", "CTAs", "Product Descriptions"

2. **Tags**
   - Add multiple tags per snippet
   - Filter by tag for quick access
   - Examples: "urgent", "b2b", "seasonal"

3. **Rating System**
   - Rate snippets 1-5 stars
   - Sort by rating to find top performers
   - Track what works best

#### Snippet Metadata

Each snippet stores:
- Content text
- Content type
- Tone(s) used
- Persona used
- Creation date
- Last modified
- Usage count
- Rating

#### Using Snippets

1. **Preview**
   - View the full prompt and generated output side by side
   - "Run Again in Studio" button opens the studio pre-loaded with your settings

2. **Run Again / Generate**
   - Sends the snippet to the Copywriting Studio with prompt, tone, persona, and model restored
   - For **KineticLaunch Prompts**: button shows as "▶ Generate" - opens studio with the prompt pre-loaded

3. **View Prompt** (KineticLaunch Prompts only)
   - Shows the full prompt brief before you decide to generate

4. **📧 Substack** (Substack Post type only)
   - Sends the generated content directly to your Substack publication draft queue
   - Requires Substack email configured in Settings → Integrations

5. **📋 Copy for LinkedIn** (LinkedIn Post type only)
   - Copies the generated content to clipboard as plain text (HTML stripped)
   - Ready to paste directly into LinkedIn

6. **Edit Snippet**
   - Modify prompt text, tags, or folder
   - Save changes

7. **Delete**
   - Permanently removes the snippet

### Best Practices

#### Naming Convention
```
Good: "Hero CTA - Free Trial - Urgent Tone"
Bad: "Button 1"

Good: "Blog Headline - AI Marketing - Professional"
Bad: "Headline"
```

#### Folder Structure Example
```
📁 Headlines
  📁 Blog Posts
  📁 Landing Pages
  📁 Email Subjects
📁 CTAs
  📁 Primary Buttons
  📁 Secondary Links
📁 Body Copy
  📁 Hero Sections
  📁 Feature Descriptions
  📁 About Us
```

#### Tagging Strategy
```
Content Type: headline, cta, paragraph
Industry: saas, ecommerce, agency
Urgency: urgent, evergreen
Audience: b2b, b2c, enterprise
Performance: high-converting, tested, draft
```

---

## Rewrite with Tone {#rewrite-with-tone}

### What It Does

Rewrite any post's content in a saved tone template - without losing your original. Available in the post editor meta box (Gutenberg and Classic Editor).

### How to Use

1. **Open any post** in the WordPress editor
2. **Scroll to the "Claude AI Copywriter" meta box** in the sidebar/below editor
3. **Select a tone template** from the "Rewrite with Tone" dropdown
4. **Click "Rewrite with Selected Tone"** - Claude rewrites your content preserving meaning, entities, structure, and approximate length
5. **Preview the result** in the scrollable textarea
6. **Accept & Apply** writes the rewritten content to both the editor and the database
7. **Cancel** collapses the preview without changes

### Pre-Rewrite Snapshots

Every rewrite automatically saves a WordPress revision of the original content *before* rewriting. If you don't like the result after applying:

- Click the **"Revert to pre-rewrite version"** link in the meta box
- This takes you directly to the WordPress revision restore screen
- One click restores your original content

### Tips

- Works with both Gutenberg and Classic Editor
- HTML formatting is preserved (headings, lists, links, etc.)
- Brand voice instructions from Settings → Brand Strategy are automatically injected
- Use the "Save as Template" button after tone analysis to create custom tone templates for rewriting

---

## Schema JSON-LD {#schema-json-ld}

### Generating Schema

1. In the **Copywriting Studio**, set Content Type to **"Schema Markup"**
2. Enter your prompt describing what the schema should cover
3. Click **Generate Copy** - Claude generates JSON-LD schema (FAQ, HowTo, Article, Product, Review)
4. Click the **"Copy Schema JSON-LD"** button to copy the full `<script type="application/ld+json">` block

### Auto-Inject via wp_head

If your SEO plugin doesn't handle JSON-LD schema, KineticCopy can inject it automatically:

1. Go to **Settings → General**
2. Enable **"Auto-inject schema markup in wp_head"**
3. When you save a draft post with schema_markup content type, KineticCopy stores the schema in post meta
4. On the frontend, the schema is output in `<head>` on singular pages (priority 5)

**Note:** If you already use Yoast, RankMath, or another SEO plugin for schema, leave this setting OFF to avoid duplicate markup.

---

## Brain - AI Chat Assistant {#brain-chat-assistant}

### What It Is

Brain is a conversational AI assistant that lives inside your WordPress admin. Unlike form-based AI plugins, Brain is a real chat interface that knows your site context, brand strategy, and current post - and can do web research while chatting.

### Opening Brain

Click the **animated BrainWave button** (bottom-right corner of any wp-admin page). On first open per session, Brain delivers a contextual greeting powered by Claude Haiku.

### What Brain Knows

- **Your current post** (title, excerpt, content preview)
- **Your recent posts** (titles and dates)
- **Your brand strategy** (from KineticBrand Sync or manual Brand Strategy settings)
- **Your site context** (from Site Intelligence Engine)
- **Web research** (toggle the research button or ask Brain to "research" something)

### Features

- **BrainWave animation** - The floating button shows three states: idle (gentle pulse), thinking (fast ripple during API calls), speaking (medium pulse when response arrives)
- **Web research** - Click the research toggle or use keywords like "research", "look up", "find out" in your message
- **Perplexity fact-checking** - If you add a Perplexity API key in Settings, Brain automatically fact-checks statistics and research claims in its responses
- **Session persistence** - Your conversation survives page navigation within the same browser session
- **Multiple sessions** - Save conversations and load previous ones

### Security

Brain includes multiple security layers: burst rate limiting (5 messages per minute), hourly cap (20/hour), injection detection (17+ attack patterns), and output leak filtering to prevent system prompt exposure.

---

## Content Analysis {#content-analysis}

### Running an Analysis

1. **Navigate to Analyzer**
   - WordPress Admin → Claude AI → Content Analysis

2. **Enter Page URL**
   - Must be a published page/post
   - Or paste content directly

3. **Click "Analyze"**
   - AI reviews your content
   - Generates detailed report

### Analysis Components

#### 1. Headline Effectiveness (0-100)
```
Checks:
- Clarity and specificity
- Emotional appeal
- Curiosity factor
- Length (50-60 characters ideal)
- Power words usage

Example Output:
Score: 75/100
Suggestion: "Add urgency with time-sensitive language"
Better: "Transform Your Marketing in 30 Days [Original: Transform Your Marketing]"
```

#### 2. Opening Hook Strength (0-100)
```
Checks:
- Grabs attention in first 3 seconds
- Addresses pain point or desire
- Creates curiosity gap
- Avoids clichés

Example Output:
Score: 60/100
Suggestion: "Start with a surprising statistic or question"
Better: "Did you know 73% of marketers waste time on manual tasks? [Original: Marketing is important...]"
```

#### 3. Clarity & Readability (0-100)
```
Checks:
- Sentence structure
- Jargon usage
- Flesch reading ease
- Paragraph length
- Active vs. passive voice

Example Output:
Score: 85/100
Suggestion: "Break up long paragraphs after 3-4 sentences"
```

#### 4. CTA Optimization (0-100)
```
Checks:
- Clear next step
- Action-oriented language
- Urgency or value proposition
- Visibility and placement
- Single vs. multiple CTAs

Example Output:
Score: 50/100
Suggestion: "Replace 'Learn More' with specific benefit: 'Get Your Free Template'"
```

#### 5. SEO Opportunities
```
Checks:
- Keyword presence
- Header hierarchy
- Meta description quality
- Internal linking
- Content depth

Example Output:
Opportunities:
- Add "AI copywriting tools" to H2
- Internal link to related post about content marketing
- Expand section 3 to 300+ words
```

#### 6. Tone Consistency (0-100)
```
Checks:
- Consistent voice throughout
- Matches brand guidelines
- Appropriate for audience
- Emotional resonance

Example Output:
Score: 90/100
Note: "Professional tone maintained throughout. Minor casual language in CTA could be more aligned."
```

### Interpreting Scores

| Score Range | Rating | Action |
|-------------|--------|--------|
| 90-100 | Excellent | Minor tweaks only |
| 75-89 | Good | Implement 1-2 key suggestions |
| 60-74 | Fair | Address major issues first |
| Below 60 | Needs Work | Consider rewrite using Studio |

### Taking Action

After analysis:

1. **Review Suggestions**
   - Prioritize by impact
   - Focus on scores below 75

2. **Use Copywriting Studio**
   - Generate improved versions
   - Compare against original

3. **Implement Changes**
   - Update your page
   - Re-analyze to measure improvement

4. **Track Performance**
   - Before/after analytics
   - Conversion rate changes

---

## Breakdance Integration {#breakdance-integration}

### Enabling Breakdance Integration

1. **Activate Feature**
   - WordPress Admin → Claude AI → Settings
   - Check "Enable Breakdance Integration"
   - Save settings

2. **Verify Installation**
   - Edit any page in Breakdance
   - Look for KineticCopy Content Generator in the element panel

### Using in Breakdance Builder

#### Method 1: Toolbar Button

1. **Open Breakdance Editor**
   - Edit any page/post

2. **Click KineticCopy Button**
   - Located in top toolbar
   - KineticCopy generate button

3. **Configure Generation**
   - Select content type
   - Choose tone and persona
   - Add context from page
   - Set constraints

4. **Generate & Insert**
   - AI creates variations
   - Select best option
   - Automatically inserted into active element

#### Method 2: Element Right-Click

1. **Right-Click Any Element**
   - Heading, Text, Button, etc.

2. **Select "Generate with KineticCopy"**
   - Context menu appears

3. **AI Pre-Fills Context**
   - Knows element type
   - Suggests appropriate tone
   - Considers page context

4. **Generate & Replace**
   - Replaces element content
   - Or adds as variation

#### Method 3: Dynamic Data

1. **Add Dynamic Data Field**
   - Select "KineticCopy" as source

2. **Configure Generation**
   - Set tone template
   - Define persona
   - Add generation rules

3. **Auto-Generate**
   - Content generates on page save
   - Updates based on rules

### Breakdance Workflow Examples

#### Example 1: Hero Section

```
1. Add Heading element
2. Right-click → "Generate with KineticCopy"
3. Content Type: Auto-detected (Headline)
4. Tone: Bold + Persuasive
5. Persona: Your target audience
6. Context: "SaaS product, project management, saves time"
7. Generate
8. Select: "Manage Projects 10x Faster with AI"
9. Insert
```

#### Example 2: Feature List

```
For each feature:
1. Add Text element
2. Toolbar → Claude AI
3. Content Type: Paragraph
4. Tone: Professional + Friendly
5. Persona: Same for consistency
6. Context: Specific feature details
7. Constraint: 2-3 sentences
8. Generate all at once
9. Maintain consistent voice
```

### Pro Tips for Breakdance

1. **Set Global Tone**
   - Save site tone template
   - Use for all generations
   - Maintains brand consistency

2. **Context is King**
   - More context = better output
   - Include page purpose
   - Mention specific benefits

3. **Batch Generate**
   - Do all headlines first
   - Then body copy
   - Then CTAs
   - Maintains consistency

4. **A/B Test Variations**
   - Generate 3 headlines
   - Create page variations in Breakdance
   - Track which performs best

---

## Integrations {#integrations}

### Substack Integration {#substack-integration}

Send Substack posts directly from the KineticCopy library to your Substack draft queue - no API key needed. This uses Substack's built-in email-to-post feature.

#### Setup

1. **Find your Substack email address**
   - Log in to your Substack publication dashboard
   - Go to Settings → Email → "Post by email"
   - Copy your publication's unique email address (format: `yourpublication@substack.com`)

2. **Add it to KineticCopy**
   - WordPress Admin → KineticCopy → Settings → Integrations tab
   - Paste the address in the "Substack Publication Email" field
   - Click "Save Email"

#### Sending a Post

1. In the **Snippet Library**, find a snippet of type "Substack Post"
2. Click the orange **📧 Substack** button on the card
3. The post is emailed to your Substack draft queue
4. Log into Substack - it appears as a draft, ready to review and publish

The snippet's tags become the post title. Generated content is sent as the body; if no generated content exists yet, the prompt text is sent instead.

> **Note:** Posts arrive as Substack drafts - you always review before publishing. HTML formatting is preserved.

---

### LinkedIn Integration {#linkedin-integration}

KineticCopy doesn't post to LinkedIn directly (LinkedIn's API requires OAuth app approval), but it makes copying LinkedIn content frictionless.

#### Copying a LinkedIn Post

1. In the **Snippet Library**, find a snippet of type "LinkedIn Post"
2. Click the blue **📋 Copy for LinkedIn** button on the card
3. The generated content is copied to your clipboard as plain text (HTML stripped)
4. Switch to LinkedIn and paste

> **Tip:** The button copies `generated_content` if it exists, otherwise falls back to `prompt_text`. Always generate your post in the studio first for best results.

---

### KineticLaunch Integration {#kineticcopy-kineticlaunch}

If you use KineticLaunch, you can push Copy Prompts from your content pipeline directly into KineticCopy's library. Each prompt is a complete, ready-to-run content brief generated by KineticLaunch for your specific project.

#### How Prompts Arrive

Prompts are pushed via the KineticLaunch "Send to KineticCopy" feature in your content calendar. They appear automatically in your KineticCopy Library under a folder named after your project, with the type badge "KineticLaunch Prompt."

#### Connecting KineticLaunch

In **KineticLaunch** (Settings → Integrations → KineticCopy):
- **Site URL:** your WordPress site URL
- **Username:** a WordPress user with Editor role or higher
- **Application Password:** generate one in WordPress Admin → Users → Your Profile → Application Passwords

#### Using a KineticLaunch Prompt

1. Go to the **Snippet Library** (WordPress Admin → KineticCopy → Snippets)
2. Filter by folder "KineticLaunch" or type "KineticLaunch Prompt"
3. Click **"View Prompt"** on any card to preview the full prompt brief
4. Click **"▶ Generate"** to send it to the Copywriting Studio with the prompt pre-loaded
5. In the studio, review the prompt (edit if needed), choose a tone, and click **Generate**
6. Your content is created and saved back to the library

> **Note:** KineticLaunch prompts are fully self-contained briefs - they already include your brand voice, target audience, and content angle. The studio uses the "General" content type when running them, which lets the prompt itself drive the output.

---

### Source Content Fields {#source-content-fields}

For certain content types, the studio shows an additional **source content** textarea where you paste existing material for the AI to work from.

| Content Type | Field Label | Required |
|---|---|---|
| Content Repurposing | "Content to Repurpose" | Yes |
| Testimonial / Review Format | "Raw Feedback to Polish" | Yes |
| Blog Post with Research | "Research Notes or Source Material" | Optional |

The field appears automatically when you select one of these content types in the studio. If the field is marked required and left empty, generation is blocked with a prompt to fill it in.

---

## Best Practices {#best-practices}

### Content Generation

1. **Start Broad, Then Refine**
   - Generate multiple variations
   - Select best
   - Edit for perfection

2. **Provide Context**
   - More details = better output
   - Include brand voice notes
   - Mention competitors to differentiate

3. **Use Constraints**
   - Character limits prevent bloat
   - Word counts ensure thoroughness
   - Format requirements guide structure

4. **Iterate**
   - First generation rarely perfect
   - Refine prompt
   - Regenerate
   - Compare versions

### Tone Blending

1. **Less is More**
   - 1-2 tones for most content
   - 3-4 only for complex needs

2. **Test Combinations**
   - Try different blends
   - Save what works
   - Delete what doesn't

3. **Consistency Across Pages**
   - Use same tone template
   - Build brand voice
   - Train audience expectations

### Persona Usage

1. **Create 2-3 Core Personas**
   - Don't over-segment
   - Focus on most valuable audiences
   - Update quarterly

2. **Be Specific**
   - Generic personas = generic copy
   - Include real pain points
   - Use actual customer language

3. **Test Persona Targeting**
   - Same content, different personas
   - A/B test results
   - Refine based on data

### Snippet Management

1. **Save Immediately**
   - Don't lose good copy
   - Add tags while fresh
   - Rate promptly

2. **Regular Cleanup**
   - Archive unused snippets
   - Delete duplicates
   - Update outdated content

3. **Version Control**
   - Save variations separately
   - Note which is "current"
   - Track performance

### Security & Privacy

1. **Protect Your API Key**
   - Never share in screenshots
   - Don't commit to version control
   - Rotate if compromised

2. **Review Generated Content**
   - AI can be wrong
   - Fact-check claims
   - Ensure brand alignment

3. **Sensitive Information**
   - Don't include in prompts:
     - Customer data
     - Private strategies
     - Confidential information

### Performance Optimization

1. **Cache Analysis Results**
   - Default: 24 hours
   - Increase for stable content
   - Clear when making changes

2. **Batch Generations**
   - Generate multiple at once
   - Saves API calls
   - Maintains consistency

3. **Monitor Usage**
   - Check API usage in Anthropic console
   - Set budget alerts
   - Optimize prompts for efficiency

---

## Troubleshooting {#troubleshooting}

### Common Issues

#### Issue 1: "API Key Invalid" Error

**Causes:**
- Typo in API key
- Key has been revoked
- Incorrect key format

**Solutions:**
1. Copy key again from console.anthropic.com
2. Ensure entire key copied (starts with `sk-ant-api03-`)
3. Check for extra spaces
4. Generate new key if needed

---

#### Issue 2: No Content Generated

**Causes:**
- Rate limit exceeded
- Network connectivity
- Prompt too vague

**Solutions:**
1. Wait 60 seconds and retry
2. Check internet connection
3. Add more context to prompt
4. Simplify constraints

---

#### Issue 3: Generic/Poor Quality Output

**Causes:**
- Insufficient context
- Wrong tone selection
- Persona not specific enough

**Solutions:**
1. Add more details to prompt
2. Include specific examples
3. Refine persona with real customer data
4. Try different tone combinations

---

#### Issue 4: Breakdance Button Not Showing

**Causes:**
- Integration not enabled
- Breakdance not installed/active
- Cache issue

**Solutions:**
1. Settings → Enable Breakdance Integration
2. Ensure Breakdance plugin active
3. Clear WordPress cache
4. Hard refresh browser (Ctrl+Shift+R)

---

#### Issue 5: Slow Generation

**Causes:**
- Large prompt
- API server load
- Complex tone blending

**Solutions:**
1. Reduce prompt length
2. Generate during off-peak hours
3. Use 1-2 tones instead of 3-4
4. Check server response time in console

---

#### Issue 6: Content Analysis Fails

**Causes:**
- Page not published
- URL incorrect
- Content too short

**Solutions:**
1. Ensure page is published
2. Copy full URL with https://
3. Add more content (minimum 100 words)
4. Try "Paste Content" instead of URL

---

### Getting Help

1. **Check Documentation**
   - Review this guide
   - Check INSTALLATION.md
   - Read README.md

2. **Enable Debug Mode**
   - Settings → Security → Debug Logging
   - Reproduce issue
   - Check logs in wp-content/debug.log

3. **Contact Support**
   - Include WordPress version
   - Include PHP version
   - Include error messages
   - Include steps to reproduce

---

## FAQ {#faq}

### General Questions

**Q: Is my content private?**
A: Content sent to Claude API is processed by Anthropic. They do not train on your data. See: https://www.anthropic.com/legal/privacy

**Q: Can I use with other page builders?**
A: KineticCopy works with any WordPress theme and page builder. Core features (Studio, Library, Brain, Rewrite with Tone, post meta box) live in the WordPress admin and work everywhere - Gutenberg, Classic Editor, Elementor, Divi, Bricks, or any other builder. Breakdance gets a bonus native custom element for in-builder generation.

**Q: Does it work with WooCommerce?**
A: Yes! Generate product descriptions in Copywriting Studio, then copy to products.

**Q: Can multiple users share one API key?**
A: Yes, the plugin uses one API key for all site users. Control access via role permissions.

**Q: Will it work in my language?**
A: Claude supports 10+ languages. Quality varies by language. Best for English, French, German, Spanish.

### Pricing & Billing

**Q: How much does Claude API cost?**
A: Pay-as-you-go pricing. Typical costs:
- Headline: $0.001-0.003
- Paragraph: $0.01-0.03
- Blog post: $0.05-0.15

Current rates: https://www.anthropic.com/pricing

**Q: How many generations can I do?**
A: No plugin limit. Limited only by your API budget with Anthropic.

**Q: Is there a monthly subscription?**
A: No plugin subscription. Only pay for API usage with Anthropic.

### Technical Questions

**Q: Can I run this on localhost?**
A: Yes, but requires internet connection for API calls.

**Q: Does it slow down my site?**
A: No impact on frontend. Admin panel has minimal overhead. API calls happen on-demand.

**Q: Can I customize the UI?**
A: Kinetic branding uses CSS variables. Override in your theme to customize colors.

**Q: Is it multisite compatible?**
A: Yes. Each site needs its own API key unless using network-wide configuration.

### Content Questions

**Q: Can it write entire blog posts?**
A: Yes, select "Blog Post" content type. Provide outline for best results.

**Q: Does it check for plagiarism?**
A: AI generates original content, but always review and edit. Run through plagiarism checker if concerned.

**Q: Can it match my existing brand voice?**
A: Yes! Create persona from existing content, use consistent tone templates, provide brand guidelines in context.

**Q: Will Google penalize AI content?**
A: Google doesn't penalize AI content specifically. Focus on quality, accuracy, and user value.

---

## Keyboard Shortcuts

| Shortcut | Action |
|----------|--------|
| `Ctrl/Cmd + Enter` | Generate content |
| `Ctrl/Cmd + S` | Save snippet |
| `Ctrl/Cmd + C` | Copy to clipboard |
| `Esc` | Close modal |

---

## Glossary

**API Key** - Authentication credential from Anthropic that allows plugin to access Claude AI

**Content Type** - Format of generated content (headline, CTA, paragraph, etc.)

**Persona** - Detailed profile of target audience used to personalize messaging

**Snippet** - Saved piece of generated content stored in library for reuse

**Tone** - Writing style applied to content (professional, friendly, bold, etc.)

**Tone Blending** - Combining multiple tones for nuanced messaging (e.g., professional + friendly)

**Token** - Unit of text processed by AI (roughly 0.75 words). Billing is per token.

**Variation** - One of multiple generated options for same prompt

---

## About the Kinetic Ecosystem

KineticCopy is part of the **Kinetic Framework** - a suite of AI-powered tools for brand building and content creation. The products are designed to work together, but each works independently too.

### The Kinetic Product Suite

#### KineticBrand - Brand Strategy Platform
**URL:** branding.kineticbrain.ai

KineticBrand is where you build the complete brand strategy that KineticCopy draws from. It guides you through 8 structured phases - from AI-powered market discovery and competitor research, through positioning, identity, voice, and visuals - and outputs a full brand strategy document.

**How it connects to KineticCopy:**
1. Complete your brand build (or any phase) in KineticBrand
2. Generate a Brand Context API key in KineticBrand → Connected Platforms
3. In KineticCopy → Settings → Brand Strategy → KineticBrand Sync, paste the key + Project ID
4. All brand fields populate instantly - tone of voice, audience, positioning, values, vocabulary

KineticBrand sync is **optional**. KineticCopy works fully without it; you can fill in all Brand Strategy fields manually.

---

#### KineticPrompt - AI Prompt Engineering Tool
**URL:** kineticprompt.lovable.app

KineticPrompt is a guided prompt builder that helps you craft highly effective AI prompts on the first try - avoiding back-and-forth iteration and wasted credits.

**How it connects to KineticCopy:**
- Use KineticPrompt's **Studio** to craft detailed, structured prompts for complex copy tasks before bringing them into KineticCopy's Copywriting Studio
- KineticPrompt's **Marketing mode** (Kinetic Studio) generates prompts with your brand context already injected - the resulting prompts pair perfectly with KineticCopy's tone + persona system
- Use KineticPrompt to experiment with prompt variations, then save the best-performing ones for reuse in KineticCopy

**Tip:** If KineticCopy's output quality isn't quite right, try running your request through KineticPrompt first to build a richer, more structured prompt, then paste it into KineticCopy's context field.

---

### Other Kinetic Products

- **KineticBrand** - AI brand strategy platform (branding.kineticbrain.ai)
- **KineticPrompt** - Guided prompt engineering tool (kineticprompt.lovable.app)
- **BackdropKit** - WordPress background and visual enhancement plugin
- **KineticLearning** - AI-era marketing courses (coming soon)

### Brand Colors

The plugin uses Kinetic's signature design system:
- **Kinetic Blue** (#4B73FF) - Primary actions
- **Kinetic Pink** (#FF66F4) - Highlights
- **Kinetic Gold** (#e8d98e) - Accents
- **Kinetic Orange** (#FE7B02) - Calls to action

### Support Kinetic

- Website: [Coming Soon]
- Documentation: Included in plugin
- Community: [Coming Soon]

---

## Version History

**Version 1.7.4** (April 8, 2026) - UX Polish
- KineticLaunch prompt cards: "▶ Generate" label, "View Prompt" button before generation
- Studio correctly maps KineticLaunch prompt type to General when loaded via Run Again
- USER-GUIDE updated with Substack, LinkedIn, KineticLaunch, and source content documentation

**Version 1.7.3** (April 8, 2026) - Integrations & Gap Fixes
- Substack email-to-post integration: 📧 Send button on Substack Post library cards
- LinkedIn clipboard button: 📋 Copy for LinkedIn on LinkedIn Post library cards
- Source content fields: conditional textarea for Content Repurposing (required), Testimonial Format (required), Blog Post with Research (optional)
- KineticLaunch prompt import: type badge, studio exclusion, sanitization fix
- Send to KineticCopy: fixed prompt label display and content sanitization

**Version 1.5.0** (March 21, 2026) - Studio Power-Ups
- 4 new default personas, optgroup dropdown, branded-only filter
- Rewrite-with-Tone with preview, accept/cancel, pre-rewrite revision snapshots
- `--kc-*` design token system, branded page headers
- Schema copy button + auto_inject_schema setting

**Version 1.4.1** (March 21, 2026) - Foundation Fixes
- Configurable supported post types, default tone template
- AEO/GEO default ON, JSON-LD schema generation
- Content Library with folders, edit modal, prompt/output separation

**Version 1.4.0** (March 21, 2026) - Brain Upgrade
- Brain v1.4.0: BrainWave animation, contextual greeting, Perplexity fact-check
- KineticBrand context injection, injection detection, output leak filter

**Version 1.2.0 - 1.2.3** (December 2024) - Retrospective Tone + Fixes
- Tone analysis, AIO/GEO, fact-checking, multi-tone selection
- API timeout, debug mode, and key save fixes

**Version 1.0.0** (December 2024) - Initial Release
- Core copywriting features, Breakdance integration, snippet library
- Content analysis, tone blending, persona management, AES-256 encryption

---

## Credits

**Developed by:** Kinetic Framework Team
**AI Partner:** Anthropic (Claude)
**Powered by:** WordPress, PHP, JavaScript
**Design System:** Kinetic Framework

---

## Legal

**License:** GPL v2 or later
**Privacy:** See Anthropic Privacy Policy
**Terms:** See Anthropic Terms of Service

---

**Thank you for using Claude AI Copywriter!**

Transform your content creation workflow with the power of AI, backed by the professional design and security of the Kinetic Framework.

For updates and support, keep this guide handy and refer to the inline documentation within the plugin.

*Part of the Kinetic Framework - Building better content, faster.*
