claude-presentation-master 1.0.0 → 1.0.2

package/README.md

@@ -2,762 +2,361 @@
 
 <div align="center">
 
-![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)
-![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-green.svg)
+![NPM Version](https://img.shields.io/npm/v/claude-presentation-master)
+![Downloads](https://img.shields.io/npm/dm/claude-presentation-master)
 ![License](https://img.shields.io/badge/license-MIT-brightgreen.svg)
-![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)
 
-**Generate world-class presentations using expert methodologies from the world's best presentation coaches.**
+### Turn your Claude projects into polished presentations — instantly.
 
-[Installation](#installation) •
-[Quick Start](#quick-start) •
-[Documentation](#documentation) •
-[Examples](#examples) •
-[API Reference](#api-reference)
+You've been working in Claude on a business project. Strategy docs, research, analysis, plans.
+Now someone asks for a presentation. **This is usually where things get painful.**
 
-</div>
-
----
-
-## What is Claude Presentation Master?
-
-Claude Presentation Master is a TypeScript/Node.js library that transforms your content into professionally designed presentations. Unlike simple slide generators, it applies proven methodologies from world-renowned presentation experts:
+Not anymore.
 
-- **Nancy Duarte** (Slide:ology, Resonate) - Sparkline narrative structure, STAR moments
-- **Garr Reynolds** (Presentation Zen) - Signal-to-noise ratio, visual simplicity
-- **Carmine Gallo** (Talk Like TED) - Rule of Three, emotional connection
-- **Chris Anderson** (TED Talks) - One powerful idea per presentation
-- **Barbara Minto** (McKinsey) - Pyramid Principle, SCQA structure
+[Install Now](#installation) •
+[See It Work](#quick-start) •
+[What's Inside](#the-knowledge-base)
 
-The library enforces quality through **real visual validation** using Playwright, ensuring your presentations meet a 95/100 minimum quality score before they're considered complete.
-
-### Key Differentiators
-
-| Feature | Other Tools | Claude Presentation Master |
-|---------|-------------|---------------------------|
-| Quality Control | None or basic linting | Real visual QA with Playwright screenshots |
-| Expert Methods | Generic templates | 40+ expert methodologies encoded |
-| Word Limits | User must count | Automatically enforced per mode |
-| Layout Validation | None | Whitespace %, balance, contrast measured |
-| Accessibility | Often ignored | WCAG AA compliance built-in |
-| API Dependency | Usually required | **Works 100% offline** |
+</div>
 
 ---
 
-## Installation
+## The Scenario
 
-```bash
-# npm
-npm install claude-presentation-master
+You're deep in a Claude Code session. You've built something real:
+- A product strategy
+- A quarterly business review
+- An investor pitch
+- A project plan
+- A competitive analysis
 
-# yarn
-yarn add claude-presentation-master
+Now you need slides.
 
-# pnpm
-pnpm add claude-presentation-master
-```
+**What usually happens:**
 
-### Post-Installation
+You ask Claude to make a presentation. You get walls of text, generic bullet points, and amateur formatting. You spend the next two hours manually fixing everything in PowerPoint. Or you give up and just build it from scratch.
 
-The first time you run visual QA, Playwright will download browser binaries:
+**What happens with this library:**
 
-```bash
-npx playwright install chromium
+```
+Your Claude project context
+         ↓
+   One command
+         ↓
+Professional presentation (HTML or PowerPoint)
+Ready to present. Ready to send to clients.
 ```
 
 ---
 
-## Quick Start
-
-### Option 1: CLI (Command Line)
+## Why This Works
 
-```bash
-# Generate a keynote-style presentation
-cpm generate my-content.md --mode keynote --format html,pptx
+Claude is brilliant at research, analysis, and strategy. But presentations? Not so much.
 
-# Validate an existing presentation
-cpm validate presentation.html --mode keynote
+That's because Claude wasn't trained on what actually makes presentations work:
+- McKinsey consultants don't use bullet points — they use action titles
+- TED speakers don't dump information — they follow the Sparkline narrative arc
+- Steve Jobs averaged 10 words per slide — not 100
+- Investment bankers structure decks with the Pyramid Principle — answer first, support second
 
-# See all options
-cpm --help
-```
+**We spent months building a knowledge base that knows all of this.**
 
-### Option 2: Programmatic API
+We scoured the internet for everything ever written about making great presentations:
 
-```typescript
-import { generate } from 'claude-presentation-master';
-import { writeFileSync } from 'fs';
+| Source | What We Extracted |
+|--------|-------------------|
+| **600+ consulting decks** | McKinsey, BCG, Bain slide structures and standards |
+| **Nancy Duarte** | Sparkline narrative, STAR moments, Glance Test |
+| **Garr Reynolds** | Presentation Zen, signal-to-noise ratio |
+| **Carmine Gallo** | TED talk patterns, Rule of Three, 18-minute rule |
+| **Barbara Minto** | Pyramid Principle, SCQA framework, MECE logic |
+| **Edward Tufte** | Data-ink ratio, chartjunk elimination |
+| **Cole Nussbaumer Knaflic** | Storytelling with Data principles |
+| **10M+ views of YouTube content** | Analyst Academy, PowerPoint School, and more |
 
-const result = await generate({
-  content: `
-# Revolutionizing Customer Experience
-
-## The Problem
-Today's customers expect instant, personalized service.
-Yet 73% report frustration with current support systems.
+All of it — **6,300+ lines of expert knowledge** — encoded into an agentic vector database.
 
-## Our Solution
-AI-powered support that understands context and delivers
-human-quality responses in seconds, not hours.
-
-## The Results
-- 90% faster resolution times
-- 4.8/5 customer satisfaction
-- 60% cost reduction
-
-## Next Steps
-Join our pilot program and transform your customer experience.
-  `,
-  contentType: 'markdown',
-  mode: 'keynote',
-  format: ['html', 'pptx'],
-  title: 'Customer Experience Revolution',
-  author: 'Your Name',
-  qaThreshold: 95
-});
-
-// Check the quality score
-console.log(`Quality Score: ${result.score}/100`);
-console.log(`Slide Count: ${result.metadata.slideCount}`);
-console.log(`Frameworks Applied: ${result.metadata.frameworks.join(', ')}`);
-
-// Save the outputs
-if (result.outputs.html) {
-  writeFileSync('presentation.html', result.outputs.html);
-}
-if (result.outputs.pptx) {
-  writeFileSync('presentation.pptx', result.outputs.pptx);
-}
-```
+**Now Claude doesn't have to figure out presentations. The knowledge base already knows.**
 
 ---
 
-## How It Works
-
-### The Pipeline
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                    YOUR CONTENT (Markdown/JSON/YAML)            │
-└─────────────────────────────────────────────────────────────────┘
-                                │
-                                ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                      1. CONTENT ANALYSIS                        │
-│  • Extract SCQA structure (Situation, Complication, Question,   │
-│    Answer) using Barbara Minto's Pyramid Principle              │
-│  • Identify Sparkline narrative arc (What Is vs What Could Be)  │
-│  • Find STAR moments (Something They'll Always Remember)        │
-│  • Extract key messages (max 3 - Rule of Three)                 │
-│  • Generate action titles (McKinsey style)                      │
-└─────────────────────────────────────────────────────────────────┘
-                                │
-                                ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                      2. SLIDE GENERATION                        │
-│  • Select appropriate slide types based on content              │
-│  • Apply mode constraints (keynote: 6-25 words, business: 40-80)│
-│  • Structure narrative flow with proper pacing                  │
-│  • Add section dividers, transitions, and closing               │
-└─────────────────────────────────────────────────────────────────┘
-                                │
-                                ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                      3. OUTPUT GENERATION                       │
-│  • HTML: Reveal.js with animations, Chart.js, Mermaid           │
-│  • PPTX: PptxGenJS with proper positioning and styling          │
-│  • Apply theme colors, typography, and visual hierarchy         │
-└─────────────────────────────────────────────────────────────────┘
-                                │
-                                ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                      4. QA VALIDATION                           │
-│  • Screenshot each slide with Playwright                        │
-│  • Calculate whitespace percentage (target: 35%+ keynote)       │
-│  • Measure layout balance (center of mass analysis)             │
-│  • Check contrast ratios (WCAG 4.5:1 minimum)                   │
-│  • Validate expert principle compliance                         │
-│  • Generate 0-100 score with detailed breakdown                 │
-└─────────────────────────────────────────────────────────────────┘
-                                │
-                                ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                    5. THRESHOLD ENFORCEMENT                     │
-│  • Score >= 95: ✅ Return presentation                          │
-│  • Score < 95: ❌ Throw QAFailureError with improvement list    │
-└─────────────────────────────────────────────────────────────────┘
-```
+## What You Actually Get
 
-### The Knowledge Base
+### Two Output Formats
 
-The package includes a 6,300+ line knowledge base (`presentation-knowledge.yaml`) containing:
+**HTML Presentations (Reveal.js)**
 
-- **40+ Expert Methodologies**: Encoded principles from presentation masters
-- **Framework Selector**: Automatically chooses the best framework for your audience
-- **Slide Type Definitions**: 20+ slide types with constraints and templates
-- **QA Scoring Rubric**: Detailed validation rules with point values
-- **Mode Configurations**: Keynote vs Business rules and limits
+Modern, web-native slides that run in any browser:
 
-This knowledge base powers every decision the engine makes, ensuring expert-level quality without requiring AI API calls.
+- Share via URL — just send a link
+- Works on any device — desktop, tablet, phone
+- Animations and transitions built-in
+- Speaker notes with `S` key
+- Fullscreen with `F` key
+- Looks like a polished online version of PowerPoint
 
----
+*Best for: Tech audiences, conferences, product demos, anything you want to share online*
 
-## Presentation Modes
+**PowerPoint (PPTX)**
 
-### Keynote Mode
+Traditional format that opens in Microsoft PowerPoint:
 
-Optimized for **high-impact presentations** like TED talks, product launches, and keynotes.
+- Edit further if needed
+- Send to clients who expect PPTX
+- Print to PDF for handouts
+- Works offline
 
-| Constraint | Value |
-|------------|-------|
-| Words per slide | 6-25 maximum |
-| Whitespace | 35%+ of slide area |
-| Ideas per slide | Exactly 1 |
-| Bullet points | Avoided (use single statements) |
-| Reading time | < 3 seconds per slide |
+*Best for: Board decks, client deliverables, corporate environments*
 
-**Best for**: Conferences, product launches, investor pitches, inspirational talks
+### Two Presentation Modes
 
-### Business Mode
+**Keynote Mode** — For inspiring and persuading
 
-Optimized for **information-rich presentations** like board meetings, strategy reviews, and training.
+- 6-15 words per slide (like Steve Jobs)
+- 40%+ whitespace
+- One idea per slide
+- Emotional narrative structure
+- Big visuals, minimal text
 
-| Constraint | Value |
-|------------|-------|
-| Words per slide | 40-80 |
-| Whitespace | 25%+ of slide area |
-| Ideas per slide | 1-2 maximum |
-| Bullet points | Up to 5 per slide |
-| Data density | Medium to high |
+*Use for: Product launches, investor pitches, conference talks, TED-style presentations*
 
-**Best for**: Board meetings, quarterly reviews, training sessions, documentation
+**Business Mode** — For informing and documenting
 
----
+- 40-80 words per slide
+- Action titles (full sentences that state conclusions)
+- Data with callouts
+- Structured with Pyramid Principle
+- Charts, tables, metrics grids
 
-## Slide Types
-
-### Universal Slides (Both Modes)
-
-| Type | Description | Use Case |
-|------|-------------|----------|
-| `title` | Opening slide with title and subtitle | Always first |
-| `section-divider` | Section break with dark background | Between major sections |
-| `quote` | Blockquote with attribution | Expert quotes, testimonials |
-| `big-number` | Large statistic with context | Dramatic data points |
-| `cta` | Call to action | Near the end |
-| `thank-you` | Closing slide | Always last |
-
-### Keynote-Specific Slides
-
-| Type | Description | Use Case |
-|------|-------------|----------|
-| `big-idea` | Single powerful statement, large text | Core message delivery |
-| `single-statement` | One sentence, centered | Key points |
-| `full-image` | Full-bleed image with text overlay | Emotional impact |
-
-### Business-Specific Slides
-
-| Type | Description | Use Case |
-|------|-------------|----------|
-| `agenda` | Numbered list of topics | After title slide |
-| `bullet-points` | Title with bullet list | Detailed information |
-| `two-column` | Split layout (text + image/data) | Comparison, illustration |
-| `three-column` | Three equal columns | Feature comparison |
-| `comparison` | Side-by-side with divider | Before/after, pros/cons |
-| `timeline` | Chronological events | History, roadmap |
-| `process` | Step-by-step flow with arrows | Workflows, procedures |
-| `metrics-grid` | KPI dashboard layout | Performance data |
-| `screenshot` | Product screenshot with caption | Demo, walkthrough |
-| `screenshot-left` | Screenshot on left, text on right | Feature explanation |
-| `screenshot-right` | Text on left, screenshot on right | Feature explanation |
-| `social-proof` | Customer testimonials | Trust building |
-| `case-study` | Challenge/Solution/Results | Customer success |
-| `pricing` | Pricing table | Sales presentations |
-| `team` | Team member grid | About us |
-| `features` | Feature list with icons | Product overview |
+*Use for: Board meetings, strategy reviews, consulting deliverables, quarterly reports*
 
 ---
 
-## Themes
+## Installation
 
-```typescript
-type ThemeName =
-  | 'default'         // Clean, professional
-  | 'light-corporate' // Traditional business
-  | 'modern-tech'     // Contemporary tech look
-  | 'minimal'         // Maximum whitespace, B&W
-  | 'warm'            // Earthy, approachable
-  | 'creative';       // Bold, artistic
+```bash
+npm install claude-presentation-master
+npx playwright install chromium
 ```
 
-### Theme Preview
-
-| Theme | Primary | Accent | Best For |
-|-------|---------|--------|----------|
-| `default` | Dark navy | Coral red | General use |
-| `light-corporate` | Slate blue | Ocean blue | Enterprise, finance |
-| `modern-tech` | Deep navy | Electric pink | Startups, tech |
-| `minimal` | Pure black | Black | Design, luxury |
-| `warm` | Brown | Orange | Food, hospitality |
-| `creative` | Purple | Pink | Marketing, design |
+That's it. You're ready.
 
 ---
 
-## QA Scoring System
-
-Every presentation is validated against a 100-point rubric:
-
-### Score Breakdown
-
-| Category | Weight | What's Checked |
-|----------|--------|----------------|
-| **Visual Quality** | 35% | Whitespace %, layout balance, contrast ratio, font count, color count |
-| **Content Quality** | 30% | Word limits, action titles, glance test, signal-to-noise, one idea rule |
-| **Expert Compliance** | 25% | Duarte, Reynolds, Gallo, Anderson principles |
-| **Accessibility** | 10% | WCAG level, contrast issues, font sizes, color-blind safety |
-
-### Grading Scale
+## Quick Start
 
-| Score | Grade | Status |
-|-------|-------|--------|
-| 95-100 | A+ | ✅ Excellent - Ready to present |
-| 90-94 | A | ⚠️ Good - Minor improvements suggested |
-| 85-89 | A- | ⚠️ Acceptable - Several issues to address |
-| 80-84 | B+ | ❌ Below standard - Significant issues |
-| < 80 | B or lower | ❌ Fails - Major redesign needed |
+### From the Command Line
 
-### Threshold Enforcement
+```bash
+# Turn your markdown notes into a keynote-style HTML presentation
+cpm generate project-notes.md --mode keynote --format html
 
-By default, the library **rejects presentations scoring below 95**:
+# Create a consulting-style PowerPoint deck
+cpm generate strategy.md --mode business --format pptx
 
-```typescript
-try {
-  const result = await generate(config);
-} catch (error) {
-  if (error instanceof QAFailureError) {
-    console.log(`Score: ${error.score}/100`);
-    console.log(`Threshold: ${error.threshold}`);
-    console.log('Issues to fix:');
-    error.getIssues().forEach(issue => console.log(`  - ${issue}`));
-  }
-}
+# Generate both formats at once
+cpm generate quarterly-review.md --mode business --format html,pptx
 ```
 
-You can lower the threshold (not recommended):
+### From Your Code
 
 ```typescript
-const result = await generate({
-  ...config,
-  qaThreshold: 80  // Accept lower quality (NOT RECOMMENDED)
-});
-```
-
----
-
-## Media Providers
-
-All media features work **without API keys**.
-
-### Images
+import { generate } from 'claude-presentation-master';
 
-```typescript
-import { createDefaultImageProvider } from 'claude-presentation-master';
-
-// Default: Uses placeholder images (picsum.photos)
-const provider = createDefaultImageProvider();
-
-// With local images
-const provider = createDefaultImageProvider({
-  localImages: {
-    'team-photo': './images/team.jpg',
-    'product-screenshot': './images/product.png',
-    'logo': './images/logo.svg'
-  }
-});
+const result = await generate({
+  content: `
+# Q4 Strategy Update
 
-// With Unsplash (optional API key for better rate limits)
-const provider = createDefaultImageProvider({
-  unsplashKey: process.env.UNSPLASH_ACCESS_KEY  // Optional
-});
-```
+## Where We Are
+Revenue up 23% YoY. Market share down 2 points.
 
-**Image Provider Priority:**
-1. Local images (exact match)
-2. Unsplash API (if key provided)
-3. Unsplash Source (no key needed)
-4. Placeholder (always works)
+## The Challenge
+Three new competitors launched in Q3.
+Customer acquisition costs up 40%.
 
-### Charts
+## What We're Doing
+1. Launch enterprise tier in Q2
+2. Expand into adjacent markets
+3. Shift to product-led growth
 
-```typescript
-import { createDefaultChartProvider } from 'claude-presentation-master';
-
-const chartProvider = createDefaultChartProvider();
-
-// Generate a chart
-const chart = await chartProvider.generateChart({
-  type: 'bar',
-  data: {
-    labels: ['Q1', 'Q2', 'Q3', 'Q4'],
-    datasets: [{
-      label: 'Revenue ($M)',
-      data: [10, 15, 22, 31]
-    }]
-  },
-  title: 'Quarterly Revenue Growth',
-  palette: 'professional'  // 'default' | 'professional' | 'vibrant' | 'monochrome'
+## Expected Result
+Market share leadership within 18 months.
+  `,
+  contentType: 'markdown',
+  mode: 'business',
+  format: ['html', 'pptx'],
+  title: 'Q4 Strategy Update'
 });
 
-// chart.html - For HTML output (Chart.js canvas)
-// chart.imageUrl - For PPTX output (QuickChart.io URL)
-```
-
-**Supported Chart Types:**
-- `bar` - Bar chart
-- `line` - Line chart
-- `pie` - Pie chart
-- `doughnut` - Doughnut chart
-- `radar` - Radar chart
-- `polarArea` - Polar area chart
-- `scatter` - Scatter plot
-- `bubble` - Bubble chart
-
-### Diagrams (Mermaid)
-
-```typescript
-const chartProvider = createDefaultChartProvider();
-
-// Generate flowchart
-const flowchart = chartProvider.generateFlowchart([
-  { id: 'A', label: 'Start', next: ['B'] },
-  { id: 'B', label: 'Process', next: ['C', 'D'] },
-  { id: 'C', label: 'Option 1', next: ['E'] },
-  { id: 'D', label: 'Option 2', next: ['E'] },
-  { id: 'E', label: 'End' }
-]);
-
-// Generate timeline
-const timeline = chartProvider.generateTimeline([
-  { date: '2020', title: 'Company Founded' },
-  { date: '2021', title: 'Series A' },
-  { date: '2022', title: 'Product Launch' },
-  { date: '2023', title: '1M Users' }
-]);
+// result.outputs.html — Complete HTML presentation
+// result.outputs.pptx — PowerPoint file buffer
+// result.score — Quality score (must be 95+ to pass)
 ```
 
 ---
 
-## API Reference
+## The Knowledge Base
 
-### `generate(config)`
+This isn't a template library. It's a **complete expert system** for presentations.
 
-Generate a presentation from content.
-
-```typescript
-async function generate(config: PresentationConfig): Promise<PresentationResult>
-```
+### What's Encoded
 
-**Parameters:**
+**From McKinsey, BCG, Bain:**
+- Pyramid Principle — Lead with the answer
+- SCQA Framework — Situation → Complication → Question → Answer
+- Action Titles — "Revenue grew 23%" not "Revenue Analysis"
+- One Message Per Slide — Every slide has exactly one job
+- Chart Callouts — Always tell the audience what to see
 
-```typescript
-interface PresentationConfig {
-  // Required
-  content: string;                    // Your content
-  contentType: 'markdown' | 'json' | 'yaml' | 'text';
-  mode: 'keynote' | 'business';
-  format: ('html' | 'pptx')[];
-  title: string;
-
-  // Optional
-  theme?: ThemeName;                  // Default: 'default'
-  author?: string;
-  subject?: string;
-  qaThreshold?: number;               // Default: 95
-  skipQA?: boolean;                   // Default: false (NOT RECOMMENDED)
-  minify?: boolean;                   // Minify HTML output
-  customCSS?: string;                 // Additional CSS
-  customTemplates?: Record<string, string>;  // Handlebars overrides
-}
-```
+**From Nancy Duarte (Slide:ology, Resonate):**
+- Sparkline Structure — Alternate between "what is" and "what could be"
+- STAR Moments — Something They'll Always Remember
+- Glance Test — Understand it in 3 seconds or less
+- Signal-to-Noise — Maximize meaning, eliminate clutter
 
-**Returns:**
+**From Garr Reynolds (Presentation Zen):**
+- Simplicity — When in doubt, leave it out
+- Restraint — Resist the urge to add
+- Visual over Verbal — Show, don't tell
 
-```typescript
-interface PresentationResult {
-  outputs: {
-    html?: string;      // Reveal.js HTML
-    pptx?: Buffer;      // PowerPoint file
-  };
-  qaResults: QAResults; // Detailed QA breakdown
-  score: number;        // 0-100 quality score
-  metadata: {
-    title: string;
-    author: string;
-    generatedAt: string;
-    mode: 'keynote' | 'business';
-    slideCount: number;
-    wordCount: number;
-    avgWordsPerSlide: number;
-    estimatedDuration: number;  // Minutes
-    frameworks: string[];       // Applied expert frameworks
-  };
-}
-```
+**From Carmine Gallo (Talk Like TED):**
+- Rule of Three — Human memory works in threes
+- 18-Minute Rule — Optimal presentation length
+- Emotional Connection — Touch hearts before minds
 
-### `validate(presentation, options)`
+**From Edward Tufte:**
+- Data-Ink Ratio — Every drop of ink should represent data
+- Chartjunk Elimination — No 3D effects, no decorative gridlines
+- Graphical Integrity — Never distort data for visual effect
 
-Validate an existing HTML presentation.
+**From Barbara Minto (The Pyramid Principle):**
+- Top-Down Communication — Conclusion first, support second
+- MECE Grouping — Mutually Exclusive, Collectively Exhaustive
+- Vertical Logic — Each level supports the one above
 
-```typescript
-async function validate(
-  presentation: string | Buffer,
-  options?: {
-    mode?: 'keynote' | 'business';
-    threshold?: number;
-    strictMode?: boolean;
-  }
-): Promise<QAResults & { score: number }>
-```
+### Design System
 
-### Error Classes
+Complete color palettes tested for accessibility:
+- **Consulting Classic** — Cream background, navy text (McKinsey/BCG look)
+- **Executive Professional** — Warm gray, sophisticated
+- **Modern Tech** — Light with teal accents
+- **Dark Executive** — Dark mode for screens
 
-```typescript
-// Thrown when configuration is invalid
-class ValidationError extends Error {
-  errors: string[];
-}
-
-// Thrown when QA score is below threshold
-class QAFailureError extends Error {
-  score: number;
-  threshold: number;
-  qaResults: QAResults;
-
-  getIssues(): string[];  // List of issues to fix
-}
-```
+Typography rules:
+- Keynote: 54-72px titles, max 2 fonts
+- Business: 18-22px action titles, 11-14px body
+- Accessibility: 18pt minimum, 30pt+ for projection
 
 ---
 
-## CLI Reference
+## Quality Validation
 
-```
-Claude Presentation Master v1.0.0
-
-USAGE:
-  cpm <command> [options]
-
-COMMANDS:
-  generate <input>    Generate presentation from input file
-  validate <file>     Validate an existing HTML presentation
-  info                Show package information
-
-OPTIONS:
-  -o, --output <dir>  Output directory (default: ./output)
-  -m, --mode <mode>   keynote or business (default: keynote)
-  -f, --format <fmt>  html, pptx, or html,pptx (default: html)
-  -t, --theme <name>  Theme name
-  --title <title>     Presentation title
-  --author <name>     Author name
-  --threshold <num>   QA threshold 0-100 (default: 95)
-  --skip-qa           Skip QA (NOT recommended)
-  -h, --help          Show help
-  -v, --version       Show version
-
-EXAMPLES:
-  cpm generate deck.md -m keynote -f html,pptx
-  cpm generate report.yaml -m business -o ./slides
-  cpm validate presentation.html --threshold 90
-```
-
----
+Every presentation passes through real visual QA using Playwright:
 
-## Examples
+| Check | What's Measured |
+|-------|-----------------|
+| **Whitespace** | Percentage of empty space (40%+ for keynote, 25%+ for business) |
+| **Balance** | Center of mass — is the layout visually balanced? |
+| **Contrast** | WCAG 4.5:1 minimum for text readability |
+| **Word Count** | Enforced limits per slide type |
+| **Font Count** | Maximum 2 font families |
+| **Color Count** | Maximum 5 colors |
 
-### Example 1: Investor Pitch (Keynote Mode)
+**Presentations must score 95/100 or higher.** If they don't, you get a specific list of what to fix.
 
-```typescript
-const result = await generate({
-  content: `
-# Acme AI - Revolutionizing Customer Support
+---
 
-## The $400B Problem
-Companies spend $400 billion annually on customer support.
-Yet 67% of customers prefer self-service over speaking to a representative.
+## The Difference
 
-## Our Solution
-Acme AI delivers human-quality support responses in under 3 seconds,
-handling 80% of inquiries without human intervention.
+| Without This Library | With This Library |
+|---------------------|-------------------|
+| Ask Claude for slides, get bullet point soup | Structured presentation following expert frameworks |
+| Manually fix formatting for hours | Production-ready output in seconds |
+| Hope it looks professional | 95/100 quality bar enforced |
+| Generic templates | 6,300+ lines of encoded expertise |
+| Text only | HTML or PowerPoint output |
+| No validation | Real visual QA with screenshots |
 
-## Traction
-- 50+ enterprise customers
-- $5M ARR (300% YoY growth)
-- 95% customer retention
+---
 
-## The Team
-Former leaders from Google, Amazon, and Salesforce
-with 50+ years combined experience in AI and customer success.
+## Use Cases
 
-## The Ask
-$20M Series B to expand into European markets
-and launch our enterprise platform.
-  `,
-  contentType: 'markdown',
-  mode: 'keynote',
-  format: ['html', 'pptx'],
-  title: 'Acme AI - Series B',
-  theme: 'modern-tech'
-});
-```
+**You're building a product strategy in Claude**
+→ Generate an investor pitch deck in keynote mode
 
-### Example 2: Quarterly Business Review (Business Mode)
+**You've analyzed Q4 performance**
+→ Create a board presentation in business mode
 
-```typescript
-const result = await generate({
-  content: `
-# Q4 2024 Business Review
-
-## Executive Summary
-Q4 exceeded targets across all key metrics.
-Revenue grew 25% QoQ while maintaining profitability.
-
-## Financial Performance
-- Revenue: $12.5M (+25% QoQ)
-- Gross Margin: 72% (+3pp)
-- Operating Expenses: $8.2M (-5%)
-- Net Income: $1.8M (first profitable quarter)
-
-## Customer Metrics
-- New Customers: 127 (+40%)
-- Churn Rate: 2.1% (-0.5pp)
-- NPS Score: 72 (+8 points)
-- Average Contract Value: $45,000 (+15%)
-
-## Product Updates
-1. Launched AI Assistant v2.0
-2. Released mobile app for iOS and Android
-3. Added 15 new integrations
-4. Improved API response time by 40%
-
-## Challenges
-- Hiring senior engineers remains difficult
-- Supply chain issues delayed hardware launch
-- Competitor launched similar feature
-
-## Q1 2025 Priorities
-1. Launch enterprise tier
-2. Expand sales team by 5 reps
-3. Open European data center
-4. Achieve SOC 2 Type II certification
-  `,
-  contentType: 'markdown',
-  mode: 'business',
-  format: ['html', 'pptx'],
-  title: 'Q4 2024 Business Review',
-  theme: 'light-corporate'
-});
-```
+**You're planning a product launch**
+→ Build a TED-style keynote for the all-hands
 
-### Example 3: With Custom Templates
+**You've done competitive research**
+→ Turn it into a consulting-style strategy deck
 
-```typescript
-const result = await generate({
-  content: myContent,
-  contentType: 'markdown',
-  mode: 'keynote',
-  format: ['html'],
-  title: 'Custom Presentation',
-  customTemplates: {
-    'title': `
-      <section class="slide slide-title custom-title">
-        <div class="slide-content">
-          <div class="logo">YOUR LOGO</div>
-          <h1>{{title}}</h1>
-          <p class="subtitle">{{subtitle}}</p>
-          <p class="date">{{date}}</p>
-        </div>
-      </section>
-    `
-  },
-  customCSS: `
-    .custom-title {
-      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
-    }
-    .custom-title h1 {
-      color: white;
-    }
-  `
-});
-```
+**You have meeting notes that need to become a presentation**
+→ One command, done
 
 ---
 
-## Troubleshooting
-
-### "QA score below threshold"
+## Themes
 
-Your presentation didn't meet the 95/100 quality bar. Check the error for specific issues:
+| Theme | Look | Best For |
+|-------|------|----------|
+| `default` | Clean, professional | General use |
+| `consulting-classic` | Cream, navy | McKinsey/BCG style |
+| `modern-tech` | Light, teal accents | Startups, tech |
+| `minimal` | Maximum whitespace | Design-focused |
+| `dark-executive` | Dark mode | Screen presentations |
 
-```typescript
-catch (error) {
-  if (error instanceof QAFailureError) {
-    console.log('Issues to fix:');
-    error.getIssues().forEach(issue => {
-      console.log(`  - ${issue}`);
-    });
-  }
-}
-```
-
-Common fixes:
-- Reduce word count per slide (keynote: max 25, business: max 80)
-- Increase whitespace (remove clutter)
-- Ensure proper contrast (4.5:1 minimum)
-- Use only 1-2 font families
-- Limit colors to 5 or fewer
+---
 
-### "Playwright browsers not found"
+## Slide Types
 
-Run the Playwright installation:
+**Keynote Mode:**
+Big Idea • Single Statement • Full Image • Big Number • Quote
 
-```bash
-npx playwright install chromium
-```
+**Business Mode:**
+Agenda • Bullet Points • Two Column • Three Column • Metrics Grid • Timeline • Process Flow • Comparison • Case Study • Pricing Table
 
-### "Module not found"
+---
 
-Ensure you've built the package:
+## FAQ
 
-```bash
-npm run build
-```
+**Does this require an API key?**
+No. The knowledge base is bundled with the package. Works 100% offline.
 
----
+**Can I edit the output?**
+Yes. HTML is just HTML. PPTX opens in PowerPoint for further editing.
 
-## Contributing
+**What if I don't like the result?**
+Adjust your input content or lower the quality threshold (not recommended).
 
-See [CONTRIBUTING.md](./docs/CONTRIBUTING.md) for development setup and guidelines.
+**Does it work with Claude Code?**
+Yes — that's exactly what it's designed for. Generate presentations from your project context.
 
 ---
 
 ## License
 
-MIT License - see [LICENSE](./LICENSE) for details.
+MIT — free to use, modify, and distribute.
 
 ---
 
 ## Author
 
-**Stuart Kerr**
-<stuart@isovision.ai>
-[Isovision.ai](https://isovision.ai)
+**Stuart Kerr** — [Isovision.ai](https://isovision.ai)
 
 ---
 
 <div align="center">
 
-**Built with expert methodologies from the world's best presentation coaches.**
+**Stop fighting with slides. Start presenting.**
+
+```bash
+npm install claude-presentation-master
+```
 
-Nancy Duarte • Garr Reynolds • Carmine Gallo • Chris Anderson • Barbara Minto
+Built on methodologies from McKinsey • BCG • Bain • Nancy Duarte • Garr Reynolds
+Carmine Gallo • Chris Anderson • Barbara Minto • Edward Tufte
 
 </div>