# KineticCopy - AI Copywriting for WordPress & Breakdance

**Version:** 1.6.0
**Requires WordPress:** 6.0+
**Requires PHP:** 8.0+
**License:** GPL v2 or later

## Overview

KineticCopy (Claude AI Copywriter) brings Anthropic's Claude AI directly into your WordPress backend - a full copywriting studio, content library, tone analysis, in-editor rewriting, and a conversational AI assistant (Brain) that knows your site and brand. Works with any WordPress theme and page builder; includes a native Breakdance builder custom element as a bonus.

## Key Features

### Copywriting Studio
- Tone blending (up to 4 simultaneous tones, 24 presets)
- Audience persona targeting (7 global defaults + custom)
- 43 content types (headline, CTA, blog post, SEO blog, thought leadership, how-to guide, LinkedIn post, newsletter, FAQ, about page, case study, white paper, schema markup, and more)
- AEO/GEO optimization for AI search engines
- JSON-LD schema generation with auto-inject via `wp_head`
- Character/word count constraints
- Research integration (Google, Bing, Brave, DuckDuckGo)

### Content Library
- Save prompts + generated output separately
- Folder organization with rename/delete
- Tags, ratings (1-5 stars), search
- Grid/list view toggle
- Edit modal for prompt text, type, folder, tags

### Brain - AI Chat Assistant (v1.4.0)
- Conversational AI inside wp-admin (the flagship differentiator)
- BrainWave animated FAB with idle/thinking/speaking states
- Contextual greeting powered by Haiku (once per session)
- Site-aware: knows current post, recent posts, brand strategy
- Web research on demand (Perplexity fact-checking optional)
- KineticBrand context injection (positioning, voice, personality)
- Burst rate limiting (5/60s) + hourly cap (20/hr)
- Injection detection (17+ patterns) + output leak filter

### Post Editor Integration
- Tone analysis on any post (Gutenberg + Classic)
- Save detected tones as reusable templates
- **Rewrite with Tone** - rewrite post content in any saved tone template
- Preview panel with Accept & Apply / Cancel
- Pre-rewrite WP revision snapshots with one-click revert
- Default tone template fallback (site-wide setting)

### Breakdance Integration (native element)
- Native custom element in Breakdance builder (`claude_content_generator`)
- Generate button + output panel with prompt, content type, word count controls
- Copy-to-clipboard for generated content
- Settings toggle to enable/disable

### Universal Compatibility
- Works with any WordPress theme and page builder (Gutenberg, Classic Editor, Elementor, Divi, Bricks, GeneratePress, Kadence, etc.)
- Core features live in the WordPress admin - not tied to any single framework
- Breakdance gets the bonus native custom element for in-builder generation

### KineticLaunch Calendar Sync (bidirectional)
- Calendar brief push from KineticLaunch (campaign phase, channel, tone, keywords, hashtags)
- Long-form draft generation with Claude Sonnet, result pushed back via callback
- Bidirectional status sync - WP post status changes sync to Launch calendar
- Copy prompt import from Launch marketing strategy into snippet library
- All endpoints authenticated via shared webhook secret

### Brand Strategy & KineticBrand Sync
- Paste KineticBrand API key + Project ID to sync all brand fields
- Brand name, tagline, positioning, audience, voice, values, vocabulary auto-populate
- Works fully without KineticBrand - fill fields manually

### Settings & Security
- AES-256 encrypted API key storage
- Configurable supported post types
- Role-based access control
- `show_branded_personas_only` filter
- `auto_inject_schema` toggle
- `--kc-*` CSS design token system

## Plugin File Structure

```
claude-ai-copywriter/
├── claude-ai-copywriter.php          # Main plugin file (v1.6.0)
├── uninstall.php                      # Cleanup on uninstall
├── README.txt                         # WordPress.org format readme
├── README.md                          # This file
├── CHANGELOG.md                       # Full version history
├── INTEGRATION-STATUS.md              # Build completion status
├── USER-GUIDE.md                      # Comprehensive user guide
├── BUILD-INSTRUCTIONS.txt             # ZIP packaging instructions
├── TEST-PACKAGING.md                  # Test deployment checklist
├── .htaccess                          # Security configuration
│
├── includes/                          # Core functionality
│   ├── class-activator.php            # DB schema, migrations, default personas
│   ├── class-deactivator.php
│   ├── class-loader.php
│   ├── class-encryption.php           # AES-256 encryption
│   ├── class-claude-api.php           # Anthropic API + rewrite_with_tone()
│   ├── class-content-analyzer.php     # 6-metric content scoring
│   ├── class-tone-manager.php         # Tone CRUD + 24 presets
│   ├── class-persona-manager.php      # Persona CRUD + 7 global defaults
│   ├── class-snippet-manager.php      # Library management
│   ├── class-research-engine.php      # Multi-API web search
│   ├── class-site-intelligence.php    # Site context engine
│   ├── class-chat-assistant.php       # Brain v1.4.0 chat
│   └── class-post-meta-box.php        # Post editor meta box
│
├── admin/                             # Admin interface
│   ├── class-admin.php                # 20+ AJAX handlers, asset enqueue
│   ├── class-settings-page.php        # 6-tab settings
│   ├── class-copywriting-studio.php   # Studio data prep
│   ├── class-dashboard-widget.php     # Dashboard widget
│   └── partials/
│       ├── settings-display.php       # Settings UI (6 tabs)
│       ├── studio-display.php         # Copywriting Studio UI
│       ├── library-display.php        # Merged Content Library
│       ├── post-meta-box-display.php  # Post editor meta box UI
│       ├── kc-page-header.php         # Branded page header partial
│       ├── chat-window.php            # Brain chat panel
│       ├── widget-display.php         # Dashboard widget
│       └── analysis-display.php       # Content analysis UI
```
```
│
├── integrations/                      # Third-party integrations
│   ├── class-breakdance-integration.php  # Breakdance element + wiring
│   └── class-kineticbrand-integration.php # KineticBrand Sync
│
├── assets/
│   ├── css/
│   │   ├── admin.css                  # Main admin + --kc-* tokens
│   │   ├── chat-assistant.css         # Brain UI + BrainWave animations
│   │   ├── breakdance-integration.css
│   │   └── dashboard-widget.css
│   ├── js/
│   │   ├── admin.js                   # Settings + general admin
│   │   ├── copywriting-studio.js      # Studio generation + persona dropdown
│   │   ├── post-meta-box.js           # Tone analysis + rewrite handlers
│   │   ├── chat-assistant.js          # Brain UI + BrainWave states
│   │   ├── breakdance-integration.js  # Breakdance builder integration
│   │   └── site-intelligence.js       # Site intelligence dashboard
│   └── images/
│       └── icon-256x256.png
│
└── languages/                         # Translation files
```

## Installation

1. Download or build `kineticcopy-v1.6.0.zip`
2. WordPress Admin → Plugins → Add New → Upload Plugin
3. Install and Activate
4. Navigate to **Claude Copywriter → Settings**
5. Enter your Anthropic API key (get one at https://console.anthropic.com/)
6. Click **Save Key** then **Test Key**
7. Configure role permissions, supported post types, and brand strategy

## Changelog

See `CHANGELOG.md` for full version history. Current version: **1.6.0** (2026-04-08).

## Credits

- Built with [Anthropic's Claude API](https://www.anthropic.com/)
- Part of the [Kinetic Ecosystem](https://kineticbrain.ai)
- Designed for [Breakdance](https://breakdance.com/) (works with any theme)

## License

GPL v2 or later.
