# PowerPoint Playbook

How to turn the Qvantum brand into a deck. This is the bridge between the brand reference and the `qvantum-powerpoint` skill.

## Golden rules
1. **Generate from the official `.potx`** — never rebuild the theme by hand. Every slide then inherits the real palette, fonts and the Q logo.
2. **One idea per slide.** Big **Regular** headline, minimal copy, lots of white space (see [layout-principles.md](layout-principles.md)).
3. **Lead with off-black `#232222` + off-white/beige.** Let **photography** carry the colour. Accent colours *sparingly* (one accent thing per slide).
4. **Type:** headlines/statements = Host Grotesk **Regular**; section titles/sub-heads/labels = **SemiBold** (labels UPPERCASE + tracked). See [typography.md](typography.md).
5. **Real photos only**, sourced locally from SharePoint downloads (see [imagery.md](imagery.md)). Strong, clean, modern-architecture / engineering close-up shots.

## Choosing a layout (the 18 template layouts)
| Need | Layout | Notes |
|------|--------|-------|
| Cover / section opener | `Main_slide_off-white`, `Main_slide_white` | Left text column + full-height image right. |
| Headline + sub-head | `Main_hl_sub_hl_light`, `1_Main_hl_sub_hl_light` | Clean statement at top. |
| Big statement / quote | `Paragraph_slide` | One large Regular sentence low on the slide. |
| Three points / pillars | `Tripple_messages_light`, `Tripple_messages_dark` | Title + 3 text columns. |
| Two-column compare / status | `Dual_information`, `Dual_information_white` | Title + two header/body pairs. |
| One big image + caption | `Image_large_beige`, `Image_large_white` | Square image left + header/body right. |
| Full-bleed photo | `Image_full_page` | Edge-to-edge image + small text overlay. |
| Data / chart | `Chart` | Native chart placeholder + side note. |
| Minimal statement | `Dark_clean`, `Beige_clean`, `White_clean` | Title-only on a coloured ground. |
| Closing | `End_slide`, `1_End_slide` | Branded close (no placeholders). |

(Exact placeholder indices for each layout: see the skill's `reference/layouts.md`.)

## Build mechanics
The `qvantum-powerpoint` skill ships `scripts/build_deck.py`, which:
- patches the `.potx` so python-pptx can open it, and swaps the theme font to **Host Grotesk**;
- **strips the template's 10 example/"tips" slides**, then adds your slides from named layouts;
- fills placeholders by index from a **JSON deck spec** (per-run weight/size/colour/tracking), inserts photos into picture placeholders (auto-downscaled), and sets footers.

Render-to-image QA on this Mac (no LibreOffice/Keynote): **Microsoft PowerPoint → PDF via AppleScript → `pdftoppm` → PNG**, then look at each slide.

See the skill's `SKILL.md` and `reference/deck-spec.md` for the spec format and the end-to-end workflow.
