claude-presentation-master 6.1.0 → 7.2.0

package/README.md

@@ -12,394 +12,307 @@
 **7 Presentation Types • Expert Methodologies • QA Validation • Auto-Remediation**
 
 [Install Now](#installation) •
-[See It Work](#quick-start) •
-[Presentation Types](#7-presentation-types) •
-[Expert Knowledge](#the-knowledge-base)
+[Quick Start](#-30-second-demo) •
+[Graphics & Images](#-graphics--images) •
+[Knowledge Base](#the-knowledge-base)
 
 </div>
 
 ---
 
-## What's New in v4.0.0 — True Knowledge-Driven Architecture
-
-**The Knowledge Base now DRIVES everything at runtime — no more hardcoded specs.**
-
-### Breaking Changes
-- `PresentationEngineV2` now requires Knowledge Base YAML at runtime
-- All design specs loaded from KB, not constants in code
-
-### New Features
-- **📚 Runtime KB Loading** — The 6,300+ line YAML knowledge base is parsed at runtime, not duplicated in code
-- **🎯 H3 Action Title Extraction** — Markdown H3 headings become slide titles (McKinsey "so what" principle)
-- **📊 Tables Preserved Correctly** — Tables stay as tables, never mangled into metric cards
-- **🚫 No Orphan Slides** — Minimum 3 bullets per slide, balanced distribution
-- **✅ 95+ Quality Threshold** — Engine fails if quality score below 95/100
-
-### Knowledge Base Integration
-- Word limits from `presentation_types.{type}.validation_rules.words_per_slide`
-- Bullet limits from `presentation_types.{type}.validation_rules.bullets_per_slide`
-- Theme from `presentation_types.{type}.color_palette`
-- Experts from `presentation_types.{type}.primary_experts`
-- Scoring weights from `presentation_types.{type}.scoring_weights`
-
-### 7 Specialized Presentation Types
-| Type | Theme | Words/Slide | Key Experts |
-|------|-------|-------------|-------------|
-| `ted_keynote` | Dark | 1-15 | Duarte, Reynolds, Anderson |
-| `sales_pitch` | Modern | 10-30 | Cialdini, Heath |
-| `consulting_deck` | McKinsey | 40-80 | Minto, McKinsey, BCG |
-| `investment_banking` | McKinsey | 60-120 | Wall Street Prep |
-| `investor_pitch` | Startup | 5-30 | Sequoia, YC |
-| `technical_presentation` | Dark | 40-100 | Tufte, C4 Model |
-| `all_hands` | Minimal | 15-40 | Internal Comms |
+## What This Tool Does
 
----
-
-## ⭐ Found This Useful?
-
-If this library saves you time (even just once), **please star the repo**. It helps other developers discover this tool and keeps the project active.
-
-<div align="center">
+Claude Presentation Master transforms your content (Markdown, text, JSON, YAML) into professional presentations using a comprehensive **knowledge base of expert methodologies** from McKinsey, BCG, Nancy Duarte, Edward Tufte, and more.
 
-[![GitHub stars](https://img.shields.io/github/stars/Stuinfla/claude-presentation-master?style=social)](https://github.com/Stuinfla/claude-presentation-master)
+### The Complete Pipeline
 
-**[⭐ Star on GitHub](https://github.com/Stuinfla/claude-presentation-master)** — Takes 2 seconds, helps a lot
-
-</div>
+```
+Your Content (Markdown, text, etc.)
+        ↓
+  Content Analysis (detects presentation type)
+        ↓
+  Slide Generation (KB-driven structure)
+        ↓
+  Image Assignment (local → Unsplash → placeholder)
+        ↓
+  7-Dimension QA Scoring
+        ↓
+  Auto-Fix Issues (iterates until 95+)
+        ↓
+  Output: HTML (Reveal.js) + PowerPoint
+```
 
 ---
 
-## 🚀 Why Developers Love This
+## 🖼️ Graphics & Images
 
-<table>
-<tr>
-<td width="50%">
+### How Images Work (No API Keys Required)
 
-### ⚡️ Zero Cost Forever
-No API keys. No subscriptions. Runs 100% locally. MIT license.
+The tool uses a **3-tier image fallback system** that works completely free:
 
-### 🛡️ Fact-Checked Output
-Built-in hallucination detector ensures every claim is sourced from your input. Zero made-up statistics.
+| Priority | Source | API Key Needed? | How It Works |
+|----------|--------|-----------------|--------------|
+| 1st | **Your Local Images** | No | Put images in same folder as your content |
+| 2nd | **Unsplash Source** | No | Keyword-matched photos from Unsplash |
+| 3rd | **Picsum.photos** | No | Professional placeholder images |
 
-</td>
-<td width="50%">
+### Option 1: Use Your Own Images (Best Quality)
 
-### 🎯 Auto-Remediation to 95/100
-Automatically fixes quality issues until professional-grade threshold is met. No manual formatting needed.
+Place images in the same directory as your content file:
 
-### 🏦 Investment Banking Ready
-Football field charts, waterfall visualizations, comps tables — all auto-generated with proper formatting.
-
-</td>
-</tr>
-</table>
-
----
-
-## The Scenario
+```
+my-presentation/
+├── content.md           # Your presentation content
+├── images/              # OR put in 'images' subfolder
+│   ├── hero.jpg
+│   ├── team.png
+│   └── product-demo.gif
+├── screenshots/         # OR 'screenshots' subfolder
+│   └── app-ui.png
+└── assets/              # OR 'assets' subfolder
+    └── logo.svg
+```
 
-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
+**The CLI auto-detects images** in:
+- Same directory as input file
+- `images/` subfolder
+- `screenshots/` subfolder
+- `assets/` subfolder
 
-Now you need slides.
+Supported formats: `.jpg`, `.jpeg`, `.png`, `.gif`, `.webp`, `.svg`
 
-**What usually happens:**
+### Option 2: Automatic Free Images (No Work Required)
 
-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.
+If you don't provide images, the tool automatically fetches relevant photos:
 
-**What happens with this library:**
+**Unsplash Source (Free, No API Key)**
+```
+https://source.unsplash.com/800x600/?technology,business
+```
+- Matches keywords from your slide content
+- High-quality photos
+- No registration needed
+- No rate limits for basic use
 
+**Picsum.photos (Always Available)**
 ```
-Your Claude project context
-         ↓
-   One command
-         ↓
-Professional presentation (HTML or PowerPoint)
-Ready to present. Ready to send to clients.
+https://picsum.photos/800/600
 ```
+- Professional placeholder images
+- Seeded for consistency (same content = same image)
+- Zero configuration
 
----
+### Optional: Enhanced Unsplash (More Control)
 
-## 7 Presentation Types
+If you want more control over images, you can optionally set an Unsplash API key:
 
-The engine automatically detects your content and applies the right expert methodology:
+```bash
+# Optional - get a free key from https://unsplash.com/developers
+export UNSPLASH_ACCESS_KEY="your-key-here"
 
-| Type | Expert Methodology | Visual Style | Best For |
-|------|-------------------|--------------|----------|
-| **TED Keynote** | Nancy Duarte (Sparkline) | Bold, minimal, black backgrounds | Conference talks, inspiration |
-| **Sales Pitch** | Robert Cialdini (Persuasion) | Trust blue, success green | Closing deals, demos |
-| **Consulting Deck** | Barbara Minto (Pyramid Principle) | McKinsey blue, action titles | Strategy, recommendations |
-| **Investment Banking** | Analyst Academy | Navy + gold, serif fonts | M&A, valuations, pitchbooks |
-| **Investor Pitch** | Sequoia/YC frameworks | Clean, startup purple | Fundraising, board decks |
-| **Technical Presentation** | Edward Tufte (Data-ink) | Dark mode, Space Grotesk | Architecture, engineering |
-| **All Hands Meeting** | Internal comms best practices | Corporate blue, win green | Company updates, celebrations |
+# Then generate as normal
+npx claude-presentation-master generate content.md
+```
 
-### Investment Banking Specialty Charts
+**Without the key, images still work** — they just use Unsplash Source (simpler API).
 
-For IB presentations, the engine generates industry-standard visualizations:
+### What About AI-Generated Images?
 
-```typescript
-// Football Field Valuation Chart
-engine.addFootballFieldChart(slide, {
-  title: 'Valuation Summary',
-  methodologies: [
-    { name: 'DCF', low: 42, mid: 48, high: 55 },
-    { name: 'Comps', low: 38, mid: 45, high: 52 },
-    { name: 'Precedents', low: 44, mid: 50, high: 58 }
-  ],
-  currentPrice: 46
-});
+This tool does **not** generate AI images because:
+1. AI image APIs cost money
+2. They require API keys
+3. Stock photos are often better for presentations
 
-// Waterfall Chart
-engine.addWaterfallChart(slide, {
-  title: 'Enterprise Value Bridge',
-  startLabel: 'Equity Value',
-  startValue: 850000,
-  steps: [
-    { label: 'Plus: Debt', value: 250000 },
-    { label: 'Less: Cash', value: -150000 },
-    { label: 'EV', value: 950000, isTotal: true }
-  ]
-});
-
-// Sources & Uses Table
-engine.addSourcesUsesTable(slide, {
-  title: 'Transaction Financing',
-  sources: [
-    { label: 'Senior Debt', amount: 500000 },
-    { label: 'Equity', amount: 300000 }
-  ],
-  uses: [
-    { label: 'Purchase Price', amount: 750000 },
-    { label: 'Fees & Expenses', amount: 50000 }
-  ]
-});
-
-// Comparable Companies Table
-engine.addCompsTable(slide, {
-  title: 'Trading Comparables',
-  columns: ['EV/Revenue', 'EV/EBITDA', 'P/E'],
-  companies: [
-    { name: 'Company A', values: [3.2, 12.5, 18.3] },
-    { name: 'Company B', values: [2.8, 10.2, 15.7] },
-    { name: 'Target Co', values: [2.5, 9.8, 14.2], highlight: true }
-  ],
-  medianRow: true
-});
-```
+If you want AI-generated images, create them separately and put them in your `images/` folder.
 
 ---
 
-## Professional Typography
+## 🧠 The Knowledge Base
+
+This isn't a template library. It's a **73,000+ token expert system** containing:
+
+### Presentation Experts Encoded
+
+| Expert | Methodology | Used For |
+|--------|-------------|----------|
+| **Nancy Duarte** | Sparkline structure, STAR moments | TED-style keynotes |
+| **Barbara Minto** | Pyramid Principle, SCQA | Consulting decks |
+| **Edward Tufte** | Data-ink ratio, chartjunk elimination | Technical presentations |
+| **Garr Reynolds** | Simplicity, restraint | Minimal designs |
+| **Carmine Gallo** | Rule of Three, 18-minute rule | TED talks |
+| **Robert Cialdini** | Persuasion principles | Sales pitches |
+| **Chris Anderson** | TED formula | Keynotes |
+| **McKinsey/BCG** | Action titles, one-message-per-slide | Business decks |
+
+### What the KB Controls
+
+**Every decision** comes from the knowledge base:
+
+```yaml
+# Word limits per presentation type
+ted_keynote:
+  words_per_slide: { min: 1, max: 15 }
+
+consulting_deck:
+  words_per_slide: { min: 40, max: 80 }
+
+# Slide structure rules
+allowed_elements:
+  keynote:
+    - title
+    - big_idea
+    - single_stat
+    - full_image
+    - quote
+
+# Expert-specific rules
+experts:
+  duarte:
+    sparkline_required: true
+    star_moment_placement: [3, 7, 11]
+
+  minto:
+    action_titles_required: true
+    scqa_structure: true
+```
 
-Each presentation type loads appropriate Google Fonts (zero cost):
+### 7 Presentation Types (Auto-Detected)
 
-| Type | Heading Font | Body Font | Personality |
-|------|-------------|-----------|-------------|
-| TED Keynote | DM Sans | DM Sans | Modern, bold |
-| Sales Pitch | Poppins | Poppins | Friendly, approachable |
-| Consulting | IBM Plex Sans | IBM Plex Sans | Clean, corporate |
-| Investment Banking | Libre Baskerville | IBM Plex Sans | Classic, authoritative |
-| Investor Pitch | DM Sans | Source Sans Pro | Startup, modern |
-| Technical | Space Grotesk | Source Sans Pro | Precision, engineering |
-| All Hands | Source Sans Pro | Source Sans Pro | Clear, professional |
+| Type | Auto-Detection Keywords | Primary Experts |
+|------|-------------------------|-----------------|
+| `ted_keynote` | "TED", "inspire", "keynote" | Duarte, Reynolds, Anderson |
+| `sales_pitch` | "sales", "demo", "prospect" | Cialdini, Heath |
+| `consulting_deck` | "strategy", "recommendation" | Minto, McKinsey, BCG |
+| `investment_banking` | "M&A", "DCF", "valuation" | Wall Street Prep |
+| `investor_pitch` | "Series A", "raise", "investor" | Sequoia, YC |
+| `technical_presentation` | "API", "architecture", "system" | Tufte, C4 Model |
+| `all_hands` | "company update", "quarterly" | Internal Comms |
 
 ---
 
-## Quality Assurance System
+## 📊 7-Dimension Quality Scoring
 
-### Bulletproof QA Pipeline
+Every presentation is scored across 7 dimensions. The tool **iterates until 95+**:
 
-Every presentation goes through a rigorous validation pipeline:
+| Dimension | Weight | What It Measures |
+|-----------|--------|------------------|
+| **Layout** | 15% | Whitespace (40%+ required), balance, structure |
+| **Contrast** | 15% | WCAG 4.5:1 compliance, readability |
+| **Graphics** | 10% | Image presence, placement, relevance |
+| **Content** | 20% | Word limits, bullet count, structure |
+| **Clarity** | 15% | One message per slide, key message focus |
+| **Effectiveness** | 15% | Expert methodology compliance |
+| **Consistency** | 10% | Style uniformity, title casing |
+
+### Iterative Auto-Fix
 
 ```
-Content Analysis → Slide Generation → QA Validation → Auto-Remediation → Final Output
-                                           ↓
-                           [Loops until 95/100 threshold met]
+Generate → Score (85/100) → Auto-Fix Issues → Regenerate → Score (92/100) → Auto-Fix → Score (97/100) → ✅ Done
 ```
 
-### What Gets Validated
-
-| Category | Checks |
-|----------|--------|
-| **Content** | Word count per slide, bullet count, one-idea-per-slide |
-| **Visual** | Whitespace %, font consistency, color count |
-| **Structure** | Title slide present, conclusion slide, logical flow |
-| **Expert Rules** | Glance test (3-second rule), Rule of Three, Pyramid structure |
-| **Accessibility** | WCAG contrast ratios, minimum font sizes |
-| **Hallucination** | Every fact must be traceable to source content |
-
-### Hallucination Detection
-
-The engine includes a **zero-tolerance hallucination detector**:
-
-```typescript
-// The engine checks every statistic, quote, and claim
-const factCheck = await hallucinationDetector.checkForHallucinations(
-  slides,
-  originalContent,
-  contentAnalysis
-);
-
-// If unverified facts are found, they're automatically flagged and removed
-if (!factCheck.passed) {
-  slides = hallucinationDetector.remediate(slides, factCheck);
-  console.log(`Removed ${factCheck.issues.length} unverified claims`);
-}
-```
+The engine will iterate up to 5 times (configurable) to reach your target score.
 
 ---
 
 ## Installation
 
-### Option 1: npx (Quick One-Off — No Install Needed)
-
-Run directly without installing anything. Perfect for trying it out or one-off presentations:
+### Option 1: npx (No Install — Just Run)
 
 ```bash
-# Generate a presentation instantly (downloads temporarily, runs, cleans up)
+# Generate a keynote presentation instantly
 npx claude-presentation-master generate notes.md -m keynote -f html
 
 # Generate a consulting deck as PowerPoint
 npx claude-presentation-master generate strategy.md --type consulting_deck -f pptx
 
-# See all options
-npx claude-presentation-master --help
+# Both formats
+npx claude-presentation-master generate content.md -f html,pptx
 ```
 
-**When to use npx:**
-- Quick one-off presentation
-- Trying out the tool before installing
-- CI/CD pipelines where you don't want permanent installs
-- Sharing a command that "just works" for anyone
-
----
-
-### Option 2: npm install (For Regular Use)
-
-Install once, use anytime with the short `cpm` command:
+### Option 2: Global Install (Short Command)
 
 ```bash
-# Install globally (recommended for regular use)
 npm install -g claude-presentation-master
 
-# Now use the short command anywhere
-cpm generate notes.md -m keynote -f html
-cpm generate strategy.md --type investment_banking -f pptx
+# Now use the short 'cpm' command anywhere
+cpm generate notes.md -m keynote
 cpm info
 ```
 
-**Or install as a project dependency:**
-
-```bash
-# In your project directory
-npm install claude-presentation-master
-
-# Use programmatically in your code (see below)
-```
-
-**When to use npm install:**
-- You create presentations regularly
-- You want the short `cpm` command
-- You're building it into a Claude Code workflow
-- You want to use the TypeScript API in your code
-
----
-
-### Optional: Visual Testing
-
-For Playwright-based visual regression testing (not required for generation):
-
-```bash
-npx playwright install chromium
-```
-
-**No API keys. No subscriptions. Zero cost.**
-
 ---
 
 ## ⚡ 30-Second Demo
 
-Try this right now — literally 30 seconds:
-
 ```bash
 # Create a test file
-echo "# My Big Idea
-
-This will change everything.
+echo "# Our Big Opportunity
 
 ## The Problem
-People waste hours formatting slides instead of working on content.
-
-## The Solution
-Automated presentation generation with expert methodology built in." > test.md
-
-# Generate presentation (no install needed)
-npx claude-presentation-master generate test.md -m keynote -f html -o ./demo
-
-# Open demo/my-big-idea.html in your browser
-```
-
-**That's it.** You just created a professional TED-style presentation in 30 seconds.
-
----
-
-## Example Slides
+Enterprise teams waste 40% of time on manual data entry.
+$50B market. Growing 23% annually.
 
-<div align="center">
+## Our Solution
+AI-powered automation that learns from your workflow.
+Currently serving 150 enterprise customers.
 
-### Keynote Style (TED-inspired)
-![Keynote Example](assets/screenshots/example-keynote.png)
-*Bold statements with dramatic contrast — designed for inspiration*
+## Traction
+- \$2.4M ARR (up from \$800K last year)
+- 94% customer retention
+- NPS score of 72
 
-### Sales Pitch
-![Sales Example](assets/screenshots/example-sales.png)
-*Persuasive metrics with trust-building colors — designed to close deals*
+## The Ask
+Raising \$15M to expand into Europe." > pitch.md
 
-### Consulting Deck (McKinsey-style)
-![Consulting Example](assets/screenshots/example-consulting.png)
-*Action titles with supporting data — designed for executive decisions*
+# Generate presentation (auto-detects as investor_pitch)
+npx claude-presentation-master generate pitch.md -m keynote -f html -o ./demo
 
-</div>
+# Open demo/our-big-opportunity.html in your browser
+```
 
 ---
 
-## Quick Start
-
-### From the Command Line (npx)
-
-```bash
-# One-liner: Generate keynote from markdown (no install needed)
-npx claude-presentation-master generate notes.md -m keynote -f html
-
-# Generate consulting deck
-npx claude-presentation-master generate strategy.md --type consulting_deck -f pptx
+## CLI Reference
 
-# Generate IB pitchbook with both formats
-npx claude-presentation-master generate deal.md --type investment_banking -f html,pptx -o ./output
 ```
-
-### From the Command Line (after npm install -g)
-
-```bash
-# TED-style keynote presentation
-cpm generate keynote-talk.md --mode keynote --format html
-
-# Consulting strategy deck
-cpm generate strategy.md --mode business --format pptx
-
-# Investment banking pitchbook
-cpm generate deal-memo.md --type investment_banking --format pptx
-
-# Generate both formats
-cpm generate quarterly-review.md --mode business --format html,pptx
+USAGE:
+  npx claude-presentation-master <command> [options]
+  cpm <command> [options]
+
+COMMANDS:
+  generate <input>    Generate presentation from input file
+  validate <file>     Validate existing HTML presentation
+  info                Show package information
+
+OPTIONS:
+  -o, --output <dir>      Output directory (default: ./output)
+  -m, --mode <mode>       keynote (6-25 words) or business (40-80 words)
+  -f, --format <fmt>      html, pptx, or html,pptx
+  --type <type>           Presentation type (auto-detected if omitted)
+  -t, --theme <name>      Theme: default, consulting-classic, modern-tech, minimal
+  --title <title>         Presentation title
+  --author <name>         Author name
+  --min-score <num>       Minimum QA score (default: 95)
+  --max-iterations <num>  Max auto-fix iterations (default: 5)
+  --no-iterative          Disable iterative QA (single pass)
+  --skip-qa               Skip QA (NOT recommended)
+
+EXAMPLES:
+  # TED-style keynote
+  cpm generate talk.md -m keynote -f html
+
+  # McKinsey-style consulting deck
+  cpm generate strategy.md -m business --type consulting_deck -f pptx
+
+  # Investment banking pitchbook
+  cpm generate deal.md --type investment_banking -f pptx
+
+  # High quality bar (98+)
+  cpm generate content.md --min-score 98 --max-iterations 10
 ```
 
-### From Your Code
+---
+
+## Programmatic API
 
 ```typescript
 import { PresentationEngine } from 'claude-presentation-master';
@@ -407,168 +320,89 @@ import { PresentationEngine } from 'claude-presentation-master';
 const engine = new PresentationEngine();
 
 const result = await engine.generate({
-  content: `
-# Series A Pitch
-
-## The Problem
-Enterprise teams waste 40% of time on manual data entry.
-$50B market. Growing 23% annually.
-
-## Our Solution
-AI-powered automation that learns from your workflow.
-Currently serving 150 enterprise customers.
-
-## Traction
-- $2.4M ARR (up from $800K last year)
-- 94% customer retention
-- NPS score of 72
-
-## The Ask
-Raising $15M to expand into Europe and build enterprise sales team.
-  `,
+  content: markdownContent,
   contentType: 'markdown',
   title: 'Series A Pitch',
   mode: 'keynote',
   format: ['html', 'pptx'],
-  author: 'Founder Name'
+
+  // Optional
+  presentationType: 'investor_pitch',  // auto-detected if omitted
+  qaThreshold: 95,
+  maxIterations: 5,
+  author: 'Your Name'
 });
 
-// Guaranteed 95/100 quality or higher
+// Results
 console.log(`Score: ${result.score}/100`);
-console.log(`Grade: ${result.metadata.grade}`);
+console.log(`Slides: ${result.metadata.slideCount}`);
 
 // Save outputs
 fs.writeFileSync('pitch.html', result.outputs.html);
 fs.writeFileSync('pitch.pptx', result.outputs.pptx);
 ```
 
-### Specifying Presentation Type
-
-```typescript
-// Let the engine auto-detect (recommended)
-const result = await engine.generate({
-  content: dealMemo,
-  mode: 'business',
-  format: ['pptx']
-});
-// Engine detects "investment_banking" from content keywords
-
-// Or specify explicitly
-const result = await engine.generate({
-  content: techSpec,
-  mode: 'keynote',
-  presentationType: 'technical_presentation',
-  format: ['html']
-});
-```
-
 ---
 
-## The Knowledge Base
-
-This isn't a template library. It's a **complete expert system** — 6,300+ lines of encoded expertise.
-
-### What's Inside
-
-**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
-
-**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
-
-**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
-
-**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
-
-**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
-
-**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
-
-**From Robert Cialdini (Influence):**
-- Social Proof — Show who else succeeded
-- Scarcity — Limited time, limited availability
-- Authority — Credentials and expertise
-- Reciprocity — Give value first
-
----
-
-## Two Modes × Seven Types
-
-### Presentation Modes
+## Output Formats
 
-**Keynote Mode** — For inspiring and persuading
-- 6-15 words per slide (like Steve Jobs)
-- 40%+ whitespace
-- One idea per slide
-- Emotional narrative structure
-- Big visuals, minimal text
+### HTML (Reveal.js)
 
-**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
+- Modern, web-native slides
+- Share via URL
+- Works on any device
+- Keyboard shortcuts: `S` (speaker notes), `F` (fullscreen)
+- Embedded CSS with presentation-type theming
 
-### Presentation Types (Auto-Detected)
+### PowerPoint (PPTX)
 
-| Keyword Triggers | Detected Type |
-|-----------------|---------------|
-| "TED", "keynote", "inspire" | `ted_keynote` |
-| "sales", "demo", "prospect" | `sales_pitch` |
-| "strategy", "recommendation", "McKinsey" | `consulting_deck` |
-| "M&A", "valuation", "DCF", "pitchbook" | `investment_banking` |
-| "Series A", "raise", "investor" | `investor_pitch` |
-| "API", "architecture", "system design" | `technical_presentation` |
-| "all hands", "company update", "quarterly" | `all_hands` |
+- Opens in Microsoft PowerPoint
+- Fully editable
+- Send to clients
+- Print to PDF
+- Includes IB specialty charts (football field, waterfall, comps)
 
 ---
 
-## Output Formats
+## Investment Banking Features
 
-### HTML Presentations (Reveal.js)
+For IB presentations, the engine generates industry-standard charts:
 
-Modern, web-native slides:
-- Share via URL — just send a link
-- Works on any device — desktop, tablet, phone
-- Keyboard shortcuts: `S` for speaker notes, `F` for fullscreen
-- Embedded CSS with presentation-type-specific theming
-- Glass morphism effects, smooth transitions
+```typescript
+// Football Field Valuation
+engine.addFootballFieldChart(slide, {
+  title: 'Valuation Summary',
+  methodologies: [
+    { name: 'DCF', low: 42, mid: 48, high: 55 },
+    { name: 'Comps', low: 38, mid: 45, high: 52 }
+  ],
+  currentPrice: 46
+});
 
-### PowerPoint (PPTX)
+// Waterfall Chart
+engine.addWaterfallChart(slide, {
+  title: 'Enterprise Value Bridge',
+  startValue: 850000,
+  steps: [
+    { label: 'Plus: Debt', value: 250000 },
+    { label: 'Less: Cash', value: -150000 }
+  ]
+});
 
-Traditional format:
-- Opens in Microsoft PowerPoint
-- Fully editable
-- Send to clients who expect PPTX
-- Print to PDF for handouts
-- Includes IB specialty charts (football field, waterfall, etc.)
+// Comparable Companies Table
+engine.addCompsTable(slide, {
+  columns: ['EV/Revenue', 'EV/EBITDA', 'P/E'],
+  companies: [
+    { name: 'Company A', values: [3.2, 12.5, 18.3] },
+    { name: 'Target Co', values: [2.5, 9.8, 14.2], highlight: true }
+  ]
+});
+```
 
 ---
 
 ## Quality Scores
 
-Every presentation gets a quality score:
-
 | Score | Grade | Status |
 |-------|-------|--------|
 | 97-100 | A+ | Exceptional |
@@ -576,66 +410,45 @@ Every presentation gets a quality score:
 | 90-92 | A- | Very Good |
 | 85-89 | B+ | Good |
 | 80-84 | B | Acceptable |
-| 75-79 | B- | Needs Work |
-| < 75 | C or below | Blocked (auto-remediation applied) |
+| < 80 | C | Auto-remediation applied |
 
 **Default threshold: 95/100**
 
-The engine will automatically remediate issues (up to 5 iterations) until the threshold is met. If it can't reach 95, it delivers the best result with a detailed report of remaining issues.
-
 ---
 
-## Zero Cost Guarantee
-
-| Component | Cost | Notes |
-|-----------|------|-------|
-| NPM Package | FREE | MIT License |
-| Dependencies | FREE | pptxgenjs, reveal.js, marked, etc. |
-| Fonts | FREE | Google Fonts CDN |
-| QA Validation | FREE | Built-in validators |
-| Visual Testing | FREE | Playwright (optional) |
-| API Keys | NONE | Runs 100% locally |
+## Themes
 
-**No subscriptions. No usage limits. No API costs.**
+| Theme | Look | Best For |
+|-------|------|----------|
+| `default` | Dark executive | General use |
+| `consulting-classic` | Cream + navy | McKinsey/BCG style |
+| `modern-tech` | Light + teal | Startups |
+| `minimal` | Maximum whitespace | Design-focused |
+| `dark-executive` | Dark mode | Screen presentations |
+| `investment-banking` | Navy + gold | Finance |
 
 ---
 
 ## FAQ
 
 **Does this require an API key?**
-No. Everything runs locally on your machine.
+No. Everything runs 100% locally. Images use free services (Unsplash Source, Picsum.photos).
 
 **What's the difference between mode and type?**
-- **Mode** (`keynote` or `business`) controls word counts and visual density
-- **Type** (e.g., `investment_banking`) selects the expert methodology and theming
+- **Mode** (`keynote`/`business`): Controls word count and visual density
+- **Type** (e.g., `consulting_deck`): Selects expert methodology and theming
 
-**Can I customize the output?**
-Yes. HTML is just HTML. PPTX opens in PowerPoint. Edit freely.
+**How do I add custom images?**
+Put them in the same directory as your input file (or in `images/`, `screenshots/`, `assets/` subfolders). The CLI auto-detects them.
 
-**What if I don't like the auto-detected type?**
-Specify it explicitly: `presentationType: 'consulting_deck'`
-
-**Does it work with Claude Code?**
-Yes — that's exactly what it's designed for.
-
-**What about images?**
-Every slide automatically gets a contextual background image from Unsplash (free, no API key required). Images are at 40% opacity with a cinematic dark overlay to ensure text readability. The image keywords are selected based on slide type and content.
+**What if Unsplash is slow or down?**
+The tool automatically falls back to Picsum.photos placeholders.
 
 **Can I lower the quality threshold?**
-Yes, but not recommended: `qaThreshold: 80`
-
----
-
-## Themes
+Yes, but not recommended: `--min-score 80`
 
-| Theme | Look | Best For |
-|-------|------|----------|
-| `default` | Dark executive | General use |
-| `consulting-classic` | Cream + navy | McKinsey/BCG style |
-| `modern-tech` | Light + teal | Startups |
-| `minimal` | Maximum whitespace | Design-focused |
-| `dark-executive` | Dark mode | Screen presentations |
-| `investment-banking` | Navy + gold | Finance |
+**Does it work with Claude Code?**
+Yes — that's exactly what it's designed for.
 
 ---
 
@@ -645,46 +458,23 @@ Yes, but not recommended: `qaThreshold: 80`
 Title • Big Idea • Single Statement • Full Image • Big Number • Quote • CTA • Thank You
 
 **Business Mode:**
-Title • Agenda • Bullet Points • Two Column • Three Column • Metrics Grid • Timeline • Process Flow • Comparison • Case Study • Section Divider • Thank You
+Title • Agenda • Bullet Points • Two Column • Three Column • Metrics Grid • Timeline • Process Flow • Comparison • Case Study • Section Divider
 
-**Investment Banking (PPTX):**
-Football Field Chart • Waterfall Chart • Sources & Uses Table • Comparable Companies Table
+**Investment Banking:**
+Football Field Chart • Waterfall Chart • Sources & Uses • Comparable Companies Table
 
 ---
 
-## API Reference
-
-### PresentationEngine
-
-```typescript
-const engine = new PresentationEngine();
-
-const result = await engine.generate({
-  // Required
-  content: string,           // Your source content
-  title: string,             // Presentation title
-  mode: 'keynote' | 'business',
-  format: ('html' | 'pptx')[],
-
-  // Optional
-  contentType?: 'markdown' | 'text' | 'html',
-  presentationType?: PresentationType,  // Auto-detected if omitted
-  author?: string,
-  theme?: string,
-  qaThreshold?: number,      // Default: 95
-});
+## Zero Cost Guarantee
 
-// Result
-interface PresentationResult {
-  outputs: {
-    html?: string,
-    pptx?: Buffer
-  },
-  score: number,             // Quality score 0-100
-  qaResults: QAResults,      // Detailed validation results
-  metadata: PresentationMetadata
-}
-```
+| Component | Cost | Notes |
+|-----------|------|-------|
+| NPM Package | FREE | MIT License |
+| Dependencies | FREE | reveal.js, pptxgenjs, etc. |
+| Fonts | FREE | Google Fonts CDN |
+| Images | FREE | Unsplash Source, Picsum |
+| QA Validation | FREE | Built-in |
+| API Keys | NONE | Runs 100% locally |
 
 ---
 
@@ -702,72 +492,18 @@ Questions? [stuart@isovision.ai](mailto:stuart@isovision.ai)
 
 ---
 
-## Who's Using This
-
-<table>
-<tr>
-<td width="50%">
-
-### Built For
-- **Startup founders** creating investor pitch decks
-- **Consultants** building client deliverables
-- **Product managers** making quarterly reviews
-- **Engineers** documenting technical architectures
-- **Anyone** who's tired of fighting with slides
-
-</td>
-<td width="50%">
-
-### What Users Say
-
-> "Saved me 3 hours on our Series A deck. The IB charts alone are worth it."
-> — *Founder, B2B SaaS Startup*
-
-> "Finally, presentations that don't look like they were made by a bot."
-> — *Senior Consultant*
-
-</td>
-</tr>
-</table>
-
-**Using this in production?** [Share your experience →](https://github.com/Stuinfla/claude-presentation-master/discussions)
-
----
-
-## Contributing
-
-Contributions welcome! Here's how to help:
-
-1. **Report bugs** via [GitHub Issues](https://github.com/Stuinfla/claude-presentation-master/issues)
-2. **Suggest features** in [Discussions](https://github.com/Stuinfla/claude-presentation-master/discussions)
-3. **Submit PRs** for bug fixes or new presentation types
-4. **Share examples** of presentations you've created
-
----
-
 <div align="center">
 
 ## Stop Fighting With Slides. Start Presenting.
 
-**You've wasted enough time manually formatting PowerPoint slides.**
-
-This library generates professional presentations from your content in seconds.
-Zero cost. Zero API keys. Zero manual formatting.
-
 ```bash
 npx claude-presentation-master generate your-content.md -m keynote -f html
 ```
 
-### [→ Try It Now](#-30-second-demo) | [⭐ Star on GitHub](https://github.com/Stuinfla/claude-presentation-master)
-
----
-
 **Built on methodologies from:**
-McKinsey • BCG • Bain • Nancy Duarte • Garr Reynolds • Carmine Gallo
+McKinsey • BCG • Nancy Duarte • Garr Reynolds • Carmine Gallo
 Chris Anderson • Barbara Minto • Edward Tufte • Robert Cialdini
 
 **100% Free • Zero API Keys • Runs Locally • MIT License**
 
-Questions? [stuart@isovision.ai](mailto:stuart@isovision.ai)
-
 </div>