AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
feat(ai-image): introduce hero_page + open up text_policy for design and decorative roles
hugohe34888dfa96a00
diff --git a/skills/ppt-master/references/image-generator.md b/skills/ppt-master/references/image-generator.mdindex 8f105d1f..b65c4327 100644--- a/skills/ppt-master/references/image-generator.md+++ b/skills/ppt-master/references/image-generator.md@@ -8,18 +8,26 @@ Role definition for the **AI image generation path**: convert each `Acquire Via:----## 1. Core Principle — All AI Images Are Local Inserts+## 1. Core Principle — Maximize AI Image Capability in Service of the Deck-**Hard rule**: AI-generated images in PPT Master are **local visual blocks** embedded inside SVG pages (left-half illustration, hero banner, background under text, accent spot). They are **not** standalone full-page outputs.+**Hard rule**: AI images exist to serve the deck's communication goal. Default boundaries (`page_role: local`, `text_policy: none`) are starting points, not ceilings. Promote to `hero_page` or `embedded` when doing so makes the page work better — provided the deck's rendering and palette lock hold.-| What this means |-|---|-| Every prompt must produce art that **survives being cropped into a sub-region** of a 16:9 slide |-| Reserve 12-20% inner padding on all sides so content doesn't slam into the container edge |-| Don't ask the model to fill 100% of the canvas with content — leave breathing room |-| The surrounding SVG carries the page's headline / body / labels — your image's job is to **anchor visuals**, not to be the page |+**Two page roles**:-**Escape hatch — full-page AI image (rare, ≤5% of pages)**: when the user explicitly requests "this page is one large image" (typical: cover, chapter divider), mark the item `"page_role": "full_page"` in `image_prompts.json`. Default is `"page_role": "local"`. Do not promote a page to `full_page` without an explicit user instruction.+| `page_role` | Image's job | SVG above |+|---|---|---|+| `local` (default) | A region block on an SVG page; carries visual, not content. Reserve 12-20% inner padding so content survives container cropping | Carries headline / body / labels |+| `hero_page` | Image is the page's main voice — cover, chapter divider, mood transition, data hero, closing quote | Minimal overlay only (page number, brand bar, chapter mark); may be empty when the image already carries equivalent design elements |++**Two text roles inside the image** (orthogonal to `page_role`):++| Role | Example | Prompt treatment |+|---|---|---|+| Decorative | "GROWTH" as background lettering, retro stamp, scattered alphabet texture | Describe artistic direction; spelling is not critical; let the model improvise |+| Design-title | Cover main title, chapter heading | Name the font family (must echo deck's SVG typography); content must be accurate |+| Content (never inside the image) | Body copy, data points, bullet lists, long quotes | Route to SVG |++**Hard rule — deck-wide coherence still holds**: every AI image shares the deck's locked rendering and palette regardless of `page_role` or `text_policy`. `hero_page` is not permission to switch rendering for one slide.---@@ -100,8 +108,8 @@ Then `read_file` the **single resolved** rendering file and the **single resolveFor each `Acquire Via: ai` row in `design_spec.md §VIII`:1. **Determine type** by matching the row's `Purpose` against types `_index.md` auto-selection table (cover background → `background`; product launch hero → `hero`; methodology visualization → `framework`; etc.) The narrative-shorthand `Type` column in §VIII (Background/Photography/Illustration/Diagram/Decorative) is a hint, not the type's final value — `Purpose` is authoritative for picking among the 9 internal-composition types.-2. **Determine `text_policy`** — read from the row directly if Strategist filled it; otherwise default by type: `background` → `none`; `typography` → `embedded`; everything else → `none` unless the deck rendering is `sketch-notes` / `ink-notes` and Purpose explicitly calls for hand-lettered keywords. The Strategist-supplied value (when present) always wins.-3. **Determine `page_role`** — read from the row directly; default `local`. Only `full_page` if explicitly set.+2. **Determine `text_policy`** — Strategist's value (when present) wins. Otherwise judge per-image: default `none` (image carries no text, SVG overlays labels); upgrade to `embedded` when the page would communicate better with in-image text — covers / chapter dividers with a designed title, typography pieces, infographics with internal labels, sketch-notes with hand-lettered words, posters with decorative lettering. Do not put body copy, data points, or long quotes inside the image.+3. **Determine `page_role`** — Strategist's value (when present) wins. Otherwise default `local`. Upgrade to `hero_page` when the page's job is "image speaks louder than text" — cover, chapter divider, mood transition, data hero, closing quote.4. `read_file references/image-type-templates/<type>.md` (only if not already read — types are commonly reused across images in one deck)5. **Assemble the prompt** by combining:- The rendering's style paragraph (from Step 2)@@ -132,7 +140,7 @@ Every assembled prompt follows this paragraph structure. **Write prose, not tag[Hard rules — see §5].```-**Word budget**: 150-250 words for `text_policy: none` images, 180-300 words for `text_policy: embedded` images.+**Word budget**: 150-250 words for `text_policy: none`; 180-300 words for `text_policy: embedded`. `hero_page` items skew toward the upper end of their bracket — the image carries more design weight.**Forbidden — tag-soup prompts**:@@ -168,10 +176,20 @@ Exception: when the chosen rendering is `corporate-photo`, photorealism is inten| `text_policy` | What the image contains | Append to prompt ||---|---|---|-| `none` (default for most images) | **Zero** text, letters, numbers, labels | "NO text of any kind. No letters, numbers, signs, watermarks, labels, or written symbols anywhere in the image. Clean negative space ready for SVG text overlay." |-| `embedded` (rare — sketch-notes, ink-notes, infographic with hand-lettered keywords) | A small number of short keyword labels rendered as part of the artwork | "Minimal hand-lettered keywords only — 1-5 short words total, each ≤2 words. Use English for keywords (most models render English text reliably; CJK characters are often malformed). No long sentences, no paragraphs, no numbers." |+| `none` (default) | Zero text, letters, numbers, labels | "NO text of any kind. No letters, numbers, signs, watermarks, labels, or written symbols anywhere in the image. Clean negative space ready for SVG text overlay." |+| `embedded` | Text is part of the artwork — decorative lettering, designed title, hand-lettered keywords, infographic labels | See "Embedded prompt construction" below |++**Embedded prompt construction**: name the text role explicitly so the model knows how to treat it.++| Text role | Prompt phrasing |+|---|---|+| Decorative | "decorative '{WORD}' lettering as a background element, {style describing artistic treatment — 3D extruded retro, neon glow, hand-painted brush, scattered alphabet texture, etc.}" — let the model improvise; spelling is not critical |+| Design-title | "main title text '{exact words}', rendered in {font family — clean sans-serif / serif editorial / hand-written / geometric display} echoing the deck's body typography" — content must be accurate |+| Hand-lettered keyword set | "1-5 short hand-lettered keywords in English: '{w1}', '{w2}', '{w3}' — woven into the composition as sketch-notes annotations" |++**Font family must echo the deck**: when Strategist locked `deck_typography` in `spec_lock.md`, use that family. Otherwise pick a family compatible with the chosen rendering (vector-illustration / flat → clean sans-serif; editorial → serif; sketch-notes / ink-notes → hand-written; 3d-isometric / digital-dashboard → geometric display).-**CJK warning**: most image models cannot render Chinese characters correctly. For `text_policy: embedded` on a CJK-language deck, either (a) use English keywords, or (b) accept that the model will produce garbled-looking glyphs and the user must regenerate or fix manually.+**CJK warning**: most image models cannot render Chinese characters correctly. For embedded text on a CJK-language deck, either (a) use English equivalents in the image and leave Chinese to SVG overlays, or (b) accept malformed glyphs and regenerate manually.### 5.4 No brand names or trademarks in the subject@@ -224,15 +242,15 @@ Write `project/images/image_prompts.json` with this shape:| `color_scheme` | yes | `design_spec.md §III` | HEX triplet from Strategist || `items[].filename` | yes | `§VIII` resource list | Output filename with extension || `items[].type` | yes | Step 3 per-image | One of: `background`, `hero`, `portrait`, `typography`, `infographic`, `flowchart`, `framework`, `matrix`, `cycle`, `funnel`, `pyramid`, `comparison`, `timeline`, `map`, `scene` |-| `items[].page_role` | yes | Step 3 per-image | `local` (default) or `full_page` (escape hatch only) |-| `items[].text_policy` | yes | Step 3 per-image | `none` (default for most) or `embedded` (rare) |+| `items[].page_role` | yes | Step 3 per-image | `local` (default — region block on SVG page) or `hero_page` (image is page's main voice; SVG overlay minimal or empty) |+| `items[].text_policy` | yes | Step 3 per-image | `none` (default — no text in image) or `embedded` (image contains decorative lettering, designed title, or hand-lettered keywords) || `items[].aspect_ratio` | yes | Container sizing | Passed to `image_gen.py --aspect_ratio` || `items[].prompt` | yes | §4 assembly | The full assembled paragraph || `items[].image_size` | no | Container sizing | `512px` / `1K` / `2K` / `4K` || `items[].alt_text` | no | Accessibility | Short caption || `items[].status` | yes | CLI manages | `Pending` initially; CLI updates to `Generated` / `Failed` / `Needs-Manual` |-> Existing manifests without `deck_rendering` / `deck_palette` / `type` / `page_role` / `text_policy` remain valid — older items default to `page_role: local`, `text_policy: embedded` for backward compatibility.+> Existing manifests without `deck_rendering` / `deck_palette` / `type` / `page_role` / `text_policy` remain valid — older items default to `page_role: local`, `text_policy: none`. Legacy `page_role: full_page` (pre-2026-05-15) is read as `hero_page`.---@@ -371,13 +389,14 @@ If Path A's backend fails twice in a row:| Purpose | Default Inference (assembled from rendering + palette + type) ||---------|---------------------------------------------------------------|-| Cover background | `type: background`, `text_policy: none` — abstract atmospheric block matching deck rendering, generous center negative space |-| Chapter divider background | `type: background`, `text_policy: none` — slightly more structured than cover (geometric anchor permitted) |-| Methodology / framework illustration | `type: framework`, `text_policy: none` — central node + radiating satellites, no labels (SVG carries names) |-| Process / workflow illustration | `type: flowchart`, `text_policy: none` — sequential blocks with arrows |+| Cover | `type: background` or `hero`; `page_role: hero_page` when the cover is image-led; `text_policy: embedded` when title is part of the design, else `none` |+| Chapter divider | `type: background`; `page_role: hero_page` typical; `text_policy: embedded` when chapter title is part of the design |+| Methodology / framework illustration | `type: framework`, `text_policy: none` — SVG carries node labels |+| Process / workflow illustration | `type: flowchart`, `text_policy: none` — SVG carries step labels || Before/After or two-option page | `type: comparison`, `text_policy: none` or `embedded` || Team / lifestyle photo | `type: scene`, `text_policy: none`, rendering should be `corporate-photo` or `warm-scene` |-| Big-number / hero quote block | `type: typography` or `hero`, `text_policy: embedded` (the number/keyword is the visual) |+| Big-number / hero quote block | `type: typography` or `hero`; `page_role: hero_page` typical; `text_policy: embedded` (the number/quote is the visual) |+| Mood transition / atmosphere | `type: scene` or `background`; `page_role: hero_page`; `text_policy: none` (or decorative lettering if the mood calls for it) |### When Images Are Unsatisfactory@@ -410,4 +429,5 @@ Diagnose the failure category, adjust the **one specific dimension** responsible- Tag-soup prompts (keyword lists separated by commas without a coherent visual scene)- Globbing `image-renderings/*.md` or any subdirectory — read only the chosen file- Placing an image without updating its `image_prompts.json` `status` and the resource list status-- Promoting a page to `page_role: full_page` without explicit user instruction+- Switching rendering or palette for a single image — `hero_page` is not an exception to deck-wide coherence+- Embedding body copy, data points, bullet lists, or long quotes inside an image — those route to SVGdiff --git a/skills/ppt-master/references/image-type-templates/_index.md b/skills/ppt-master/references/image-type-templates/_index.mdindex b7e4d160..55cace04 100644--- a/skills/ppt-master/references/image-type-templates/_index.md+++ b/skills/ppt-master/references/image-type-templates/_index.md@@ -4,7 +4,7 @@ A **type** describes what the image's **internal composition** looks like — it> **Type vs PPT page layout — important**: type describes the composition *inside* the AI image block. The PPT slide's overall layout (where the image sits, how SVG text wraps around it) is a separate decision made by Strategist and Executor. Type only governs what's inside the rectangle the model paints.>-> **All types produce local blocks**: every type's container guidance assumes the image will be embedded inside a slide (left half, right column, hero band, accent corner). Full-page imagery is an escape hatch — see [`image-generator.md`](../image-generator.md) §1.+> **Type is orthogonal to `page_role`**: every type's container guidance assumes `page_role: local` (region block on an SVG page). When promoted to `page_role: hero_page`, the same type's composition fills the slide with SVG kept minimal above. See [`image-generator.md`](../image-generator.md) §1.---@@ -36,25 +36,25 @@ Each type has its own file with: composition skeleton (LAYOUT / ELEMENTS / NEGATFor each row in `design_spec.md §VIII Image Resource List`, match `Purpose` against this table.-| `Purpose` keyword | Type | Default `text_policy` |+| `Purpose` keyword | Type | Suggested `text_policy` ||---|---|---|-| Cover background / chapter background / divider bg | `background` | `none` |-| Product reveal / hero / headline visual | `hero` | `none` (or `embedded` for headline-as-image) |+| Cover background / chapter background / divider bg | `background` | `none`, or `embedded` (decorative lettering / designed title) when cover/divider is image-led |+| Product reveal / hero / headline visual | `hero` | `none`, or `embedded` when the headline itself is the visual || Team headshot / speaker bio / founder profile / testimonial | `portrait` | `none` |-| Big number / KPI single visual / quote | `typography` | `embedded` |-| Data summary / metrics rundown / step list | `infographic` | `none` (labels in SVG) or `embedded` (keywords in image) |-| Process / workflow / pipeline / steps with arrows | `flowchart` | `none` |-| Methodology / model / framework / architecture diagram | `framework` | `none` |-| 2×2 quadrant / SWOT / BCG / Eisenhower / Ansoff | `matrix` | `none` |+| Big number / KPI single visual / quote | `typography` | `embedded` — the text is the visual |+| Data summary / metrics rundown / step list | `infographic` | `none` (labels via SVG) or `embedded` (keywords inside the image) |+| Process / workflow / pipeline / steps with arrows | `flowchart` | `none` (SVG carries step labels) |+| Methodology / model / framework / architecture diagram | `framework` | `none` (SVG carries node labels) |+| 2×2 quadrant / SWOT / BCG / Eisenhower / Ansoff | `matrix` | `none`, or `embedded` for axis labels when intentional || Closed-loop process / PDCA / flywheel / continuous improvement | `cycle` | `none` || Conversion funnel / sales pipeline / hiring funnel | `funnel` | `none` || Hierarchy / Maslow / value stack / capability layer | `pyramid` | `none` |-| Comparison / Before-After / A/B / VS | `comparison` | `none` |-| History / evolution / roadmap / timeline | `timeline` | `none` |+| Comparison / Before-After / A/B / VS | `comparison` | `none` or `embedded` |+| History / evolution / roadmap / timeline | `timeline` | `none` (SVG carries milestone labels) || Offices / market presence / regions / supply chain / geography | `map` | `none` |-| Team / lifestyle / story / scenario / case | `scene` | `none` |+| Team / lifestyle / story / scenario / case | `scene` | `none`, or `embedded` for decorative atmosphere lettering |-> When `Purpose` mentions text-rich keywords ("with caption", "labeled", "annotated"), bias toward `embedded` text-policy. When unsure, default to `none` — SVG text overlay is more flexible than image-embedded text.+> Suggested values; per-image judgment wins. Pick `embedded` when in-image text serves the goal (decorative lettering, designed title, hand-lettered keywords, infographic labels). Pick `none` when SVG text is more flexible or the page just needs imagery. Body copy / data points / long quotes never go inside the image regardless of type.---@@ -64,7 +64,7 @@ The Resource List's `Dimensions` column is authoritative. If absent, use these d| Type | Default container | Aspect ratio ||---|---|---|-| background | 1280×720 full-bleed (still mark `page_role: local` — SVG text overlays on top) | 16:9 |+| background | 1280×720 full-bleed; `page_role: local` when SVG text overlays on top, `page_role: hero_page` when image alone is the page | 16:9 || hero | 800×600 or 1280×720 | 4:3 / 16:9 || portrait | 400×500 or 600×800 | 4:5 / 3:4 || typography | 800×500 | 16:10 |diff --git a/skills/ppt-master/references/image-type-templates/background.md b/skills/ppt-master/references/image-type-templates/background.mdindex 2672a130..84990998 100644--- a/skills/ppt-master/references/image-type-templates/background.md+++ b/skills/ppt-master/references/image-type-templates/background.md@@ -35,23 +35,26 @@ Atmospheric backdrop with **no central subject**. The image's job is to set tone| Half-page background (image left, text right) | 600×720 | ~0.83 | Calm zone on the text-adjacent edge || Hero band background | 1200×400 | 3:1 | Calm zone in the center band |-> Backgrounds are nearly always used full-bleed within a slide — but `page_role` stays `local` because SVG text overlays the image. Only use `page_role: full_page` when the user explicitly wants no SVG content on top.+> `page_role`: default `local` when SVG title overlays the background. Promote to `hero_page` when the background alone is the page (cover with no overlay, mood transition, image-led chapter divider).---## 3. Text-policy variants-### `text_policy: none` (essentially always)+### `text_policy: none` (default)-Backgrounds are atmospheric — adding text to a background defeats its purpose. **Always use `text_policy: none`** for this type unless there is a very specific reason otherwise.+Backgrounds are atmospheric — for most uses, keep text out and let SVG handle overlay copy.Sample fragment:> NO text of any kind anywhere in the image — no letters, numbers, signs, watermarks, labels, or written symbols. The image is pure atmosphere; SVG text overlay will be added externally.-### `text_policy: embedded` (rare)+### `text_policy: embedded` (decorative or designed lettering)-Only when the user explicitly wants a "headline-on-textured-bg" effect — but in PPT Master this is almost always better as `typography` type or as `hero` type. Re-evaluate the type choice before using embedded text policy on background.+When the background's mood is enhanced by lettering — large decorative word in the bleed, retro stamp, scattered alphabet texture, or a designed cover title that's part of the artwork. Name the text role explicitly in the prompt:++- Decorative lettering: "large decorative 'GROWTH' lettering in 3D extruded retro style as background element; spelling not critical"+- Designed cover title: "main title text '{exact words}' rendered in {font family echoing deck's body typography}; content must be accurate"---diff --git a/skills/ppt-master/references/image-type-templates/cycle.md b/skills/ppt-master/references/image-type-templates/cycle.mdindex 5c2326f1..5cb67bd9 100644--- a/skills/ppt-master/references/image-type-templates/cycle.md+++ b/skills/ppt-master/references/image-type-templates/cycle.md@@ -50,9 +50,9 @@ Sample fragment:> NO text, letters, numbers, or step labels in the image. Each step node contains only one simple iconic symbol; SVG text overlay will add step names externally.-### 3.2 `text_policy: embedded` (occasional)+### 3.2 `text_policy: embedded` (when step names are part of the design)-Use when the user wants a fully self-contained cycle diagram. Keep step names to single English words ("PLAN", "DO", "CHECK", "ACT").+Self-contained cycle diagram with step names typeset into the artwork. Keep step names to single English words ("PLAN", "DO", "CHECK", "ACT") in a font family echoing the deck's body typography.---diff --git a/skills/ppt-master/references/image-type-templates/framework.md b/skills/ppt-master/references/image-type-templates/framework.mdindex 89d1c098..6b7c8ec5 100644--- a/skills/ppt-master/references/image-type-templates/framework.md+++ b/skills/ppt-master/references/image-type-templates/framework.md@@ -62,7 +62,7 @@ Three valid sub-structures. Pick one per image; do not mix.| Square half-page (most common) | 700×700 | 1:1 | Hub & spokes ✓✓ / Matrix ✓✓ || Portrait half-page | 600×800 | 3:4 | Layered stack ✓✓ || Landscape banner | 1200×500 | 2.4:1 | Hub & spokes (flattened) ✓ / Matrix (1×N) ✓ |-| Full-bleed (page_role: full_page only) | 1280×720 | 16:9 | All three work — but require explicit user request |+| Full-bleed (page_role: hero_page only) | 1280×720 | 16:9 | All three work — image becomes the page |Inner padding: 15-18% on all sides. Framework imagery suffers most when satellites/cells push against the canvas edge.diff --git a/skills/ppt-master/references/image-type-templates/funnel.md b/skills/ppt-master/references/image-type-templates/funnel.mdindex 826330fc..8635f6e5 100644--- a/skills/ppt-master/references/image-type-templates/funnel.md+++ b/skills/ppt-master/references/image-type-templates/funnel.md@@ -51,9 +51,9 @@ Sample fragment:> NO text, letters, numbers, or stage labels in the image. Each band contains only one simple iconic symbol; SVG text overlay will add stage names externally.-### 3.2 `text_policy: embedded` (occasional)+### 3.2 `text_policy: embedded` (when stage names are part of the design)-Use when the user wants a fully self-contained funnel diagram. Keep band names to single English words ("AWARE", "LIKE", "BUY", "REFER"). High failure risk on 5+ band funnels.+Self-contained funnel diagram where band names are typeset into the artwork. Keep band names to single English words ("AWARE", "LIKE", "BUY", "REFER") in a font family echoing the deck's body typography. High failure risk on 5+ band funnels — stay at 3-4 bands when going embedded.---diff --git a/skills/ppt-master/references/image-type-templates/hero.md b/skills/ppt-master/references/image-type-templates/hero.mdindex b6de1a0f..e8850af6 100644--- a/skills/ppt-master/references/image-type-templates/hero.md+++ b/skills/ppt-master/references/image-type-templates/hero.md@@ -44,9 +44,9 @@ Single dominant subject occupying 60-70% of the canvas. The hero image *anchors*The hero subject is the visual; any title or label comes from SVG overlay.-### `text_policy: embedded` (occasional)+### `text_policy: embedded` (when the hero needs in-image text)-The hero subject itself includes a short embedded keyword (e.g. a product name on a package, a single hand-lettered word as part of the subject). Use sparingly — usually `typography` type is a better choice for headline-as-image.+The hero subject itself includes text — product name on packaging, a hand-lettered word as part of the subject, a designed title floating beside the figure. Specify font family in the prompt to echo the deck's body typography. If the headline *is* the entire visual, switch to `typography` type.---diff --git a/skills/ppt-master/references/image-type-templates/map.md b/skills/ppt-master/references/image-type-templates/map.mdindex cffa4ae7..0f91b999 100644--- a/skills/ppt-master/references/image-type-templates/map.md+++ b/skills/ppt-master/references/image-type-templates/map.md@@ -51,9 +51,9 @@ Sample fragment:> NO text, letters, numbers, country names, city names, or marker labels in the image. Markers are dots/pins only; SVG text overlay will add all labels externally.-### 3.2 `text_policy: embedded` (rare)+### 3.2 `text_policy: embedded` (when place names belong in the artwork)-Use only when the user wants a fully self-contained reference map. High failure risk — image models often misspell place names or place them on wrong coordinates. Recommend `none` and SVG overlay instead.+Self-contained reference map where place names are typeset into the design. High failure risk — image models often misspell place names or place them at wrong coordinates. Prefer `none` + SVG overlay unless the design language genuinely requires in-image labels (vintage cartography, atlas-style poster).---diff --git a/skills/ppt-master/references/image-type-templates/matrix.md b/skills/ppt-master/references/image-type-templates/matrix.mdindex bd18828a..342837ea 100644--- a/skills/ppt-master/references/image-type-templates/matrix.md+++ b/skills/ppt-master/references/image-type-templates/matrix.md@@ -52,9 +52,9 @@ Sample fragment:> NO text, letters, numbers, axis labels, or quadrant names in the image. Each quadrant contains a simple iconic symbol only; SVG text overlay will add axis labels and quadrant names externally.-### 3.2 `text_policy: embedded` (rare)+### 3.2 `text_policy: embedded` (when axis labels are part of the design)-Use only when the user explicitly wants the axis labels baked into the image. Keep labels to single English words ("HIGH", "LOW", "GROW", "HOLD") and accept higher risk of typo/glyph errors.+When the matrix's identity comes from its in-image lettering — a stylized SWOT poster with the four letters as visuals, a designer-matrix where axis labels are typeset into the artwork. Keep labels to single English words ("HIGH", "LOW", "GROW", "HOLD"). Specify the font family in the prompt to echo the deck's body typography.---diff --git a/skills/ppt-master/references/image-type-templates/pyramid.md b/skills/ppt-master/references/image-type-templates/pyramid.mdindex 60d40846..1bae460a 100644--- a/skills/ppt-master/references/image-type-templates/pyramid.md+++ b/skills/ppt-master/references/image-type-templates/pyramid.md@@ -50,9 +50,9 @@ Sample fragment:> NO text, letters, numbers, or tier labels in the image. Each tier contains only one simple iconic symbol; SVG text overlay will add tier names externally.-### 3.2 `text_policy: embedded` (occasional)+### 3.2 `text_policy: embedded` (when tier names are part of the design)-Use when the user wants a fully self-contained pyramid. Keep tier names to single English words. High failure risk on 5+ tier pyramids.+Self-contained pyramid with tier names typeset into the artwork. Keep tier names to single English words in a font family echoing the deck's body typography. High failure risk on 5+ tier pyramids — stay at 3-4 tiers when going embedded.---diff --git a/skills/ppt-master/references/image-type-templates/scene.md b/skills/ppt-master/references/image-type-templates/scene.mdindex eddf8709..94e68418 100644--- a/skills/ppt-master/references/image-type-templates/scene.md+++ b/skills/ppt-master/references/image-type-templates/scene.md@@ -40,13 +40,15 @@ Atmospheric environment with narrative — a moment, a place, a situation render## 3. Text-policy variants-### `text_policy: none` (essentially always)+### `text_policy: none` (default)-Scenes are visual narratives — text would interrupt. Use `text_policy: none`.+Scenes are visual narratives — most read better with text routed to SVG overlay.-### `text_policy: embedded` (very rare)+### `text_policy: embedded` (decorative atmosphere or diegetic text)-Only when the scene includes a tiny diegetic text (a sign in the scene, a label on a book) — these often fail to render correctly. Usually better as `text_policy: none`.+Two valid cases:+- Decorative atmosphere lettering — a large stylized word in the bleed serving as visual mood ("WANDER", "QUIET"). Describe artistic treatment; spelling is not critical.+- Diegetic text — a sign in the scene, a label on a book. Often fails to render correctly; only use when essential to the narrative.---diff --git a/skills/ppt-master/references/image-type-templates/typography.md b/skills/ppt-master/references/image-type-templates/typography.mdindex 8f708cd4..7ad2d74b 100644--- a/skills/ppt-master/references/image-type-templates/typography.md+++ b/skills/ppt-master/references/image-type-templates/typography.md@@ -69,7 +69,9 @@ typography type is the **one type where embedded text is the entire point**. AlwSample fragment:-> The image's central content is the hand-lettered (or appropriately styled) word "GROWTH" — rendered as a large confident headline occupying about 50% of the canvas height. Text is in English only (most models render CJK characters poorly). No other text or labels in the image — just the single headline word.+> The image's central content is the hand-lettered (or appropriately styled) word "GROWTH" — rendered as a large confident headline occupying about 50% of the canvas height, in {font family echoing deck's body typography}. Text is in English only (most models render CJK characters poorly). No other text or labels in the image — just the single headline word.++**Font family in prompt**: name the family so the lettering coheres with the deck's SVG typography. Read `spec_lock.md deck_typography` if present; otherwise infer from rendering (vector-illustration / flat → clean sans-serif; editorial → serif; sketch-notes / ink-notes → hand-written; 3d-isometric / digital-dashboard → geometric display).### `text_policy: none` (essentially never)diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex 6bad0571..3e7ee986 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -381,6 +381,34 @@ After auto-selecting, cross-check `image-palettes/_index.md` compatibility matriImage_Generator reads these two fields and applies them deck-wide. If both are absent (legacy decks), Image_Generator falls back to inferring them from `d. Style` and `e. Color` — quality is acceptable but not optimal. Always lock both when C is selected.+#### hero_page suggestion (same confirmation turn)++After the user picks a candidate, scan the outline for pages where the image speaks louder than text — covers, chapter dividers, mood transitions, single-number data heroes, closing quotes, brand summaries. Surface a suggestion list:++```+Suggested hero pages (image as page's main voice; SVG overlay minimal):+ Slide 1 — Cover (image-led)+ Slide 8 — Chapter divider: "Market Forces"+ Slide 17 — Data hero: the 73% number+ Slide 24 — Closing+Confirm, edit, or reply "all local" to skip.+```++User confirmation rules:+- Accept all / pick subset / add others / reject all+- Result is recorded as `page_role: hero_page` on the matching `ai` rows in the resource list+- Density is judgment-based — image-heavy brand decks may use more, data/teaching decks fewer. No fixed quota.++#### Typography hint for in-image text++When any hero_page or other `text_policy: embedded` row exists, also record a font family hint in `spec_lock.md` so Image_Generator's prompts echo the deck's SVG typography:++```+- deck_typography: clean sans-serif # or: serif editorial / hand-written / geometric display+```++Family-name granularity is enough — actual font choice happens in Executor's SVG; the hint exists so the AI image's lettering doesn't clash with the deck.+**When selection includes B**, you must run `python3 scripts/analyze_images.py <project_path>/images` before outputting the spec, and integrate scan results into the image resource list.**When B / C / D / E is selected**, add an image resource list to the spec:@@ -396,8 +424,8 @@ Image_Generator reads these two fields and applies them deck-wide. If both are a| **Acquire Via** | `ai` / `web` / `user` / `placeholder` — drives Step 5 dispatch || Status | Initial status must be `Pending`, `Existing`, or `Placeholder`; see [`svg-image-embedding.md`](svg-image-embedding.md) for the full status enum || **Reference** | Free-form **intent description** (NOT a search query); feeds Image_Generator (ai) or Image_Searcher (web) |-| `text_policy` (optional, `ai` rows only) | `none` (default — image carries no text, SVG overlays labels) or `embedded` (rare — image contains 1-5 short English keywords as part of the artwork; sketch-notes / ink-notes / typography type only). Leave blank for default. |-| `page_role` (optional, `ai` rows only) | `local` (default — image is a block embedded in an SVG page) or `full_page` (escape hatch — image fills the whole slide, no SVG overlay). Only set `full_page` when the user explicitly requests it. Use sparingly (≤5% of pages) — mixing PNG-pages with SVG-pages causes visual drift. |+| `text_policy` (optional, `ai` rows only) | `none` (default — no text in image, SVG overlays labels) or `embedded` (image contains decorative lettering, a designed title, or hand-lettered keywords as part of the artwork). Leave blank for default. Long body / data / lists never go inside the image. |+| `page_role` (optional, `ai` rows only) | `local` (default — image is a region block on an SVG page) or `hero_page` (image is the page's main voice; SVG overlay minimal or empty). Set per the hero_page suggestion confirmed in h.5. Same rendering and palette as the rest of the deck regardless. |**No-crop flag (exception only)**: most images are croppable — Executor defaults to `preserveAspectRatio="xMidYMid slice"`. When an image must NOT lose pixels (data screenshots, charts, certificates, contracts, dense diagrams), append `no-crop` to its `spec_lock.md images` entry. Executor will then size the container to the native ratio and use `meet`. Don't tag the rest.diff --git a/skills/ppt-master/templates/design_spec_reference.md b/skills/ppt-master/templates/design_spec_reference.mdindex e87baa54..356350d6 100644--- a/skills/ppt-master/templates/design_spec_reference.md+++ b/skills/ppt-master/templates/design_spec_reference.md@@ -260,13 +260,13 @@ Catalog read: 71 templates**text_policy** (`ai` rows only; leave blank for default):-- *blank / `none`* — image carries no text; SVG overlays labels (recommended default for most rows)-- `embedded` — image contains 1-5 short English keywords as part of the artwork (rare; sketch-notes / ink-notes / typography only; CJK characters fail in most models)+- *blank / `none`* — image carries no text; SVG overlays labels+- `embedded` — image contains in-artwork text: decorative lettering, a designed title, or hand-lettered keywords. Body copy / data points / long quotes never go inside the image regardless. English text renders most reliably; CJK characters fail in most models**page_role** (`ai` rows only; leave blank for default):-- *blank / `local`* — image is a block embedded in an SVG page (the universal default)-- `full_page` — escape hatch: image fills the entire slide with no SVG overlay. Only when user explicitly requests this; use sparingly (≤5% of pages) — PNG-pages mixed with SVG-pages cause style drift+- *blank / `local`* — image is a region block on an SVG page+- `hero_page` — image is the page's main voice; SVG overlay is minimal or empty. Use on covers, chapter dividers, mood transitions, single-number data heroes, closing quotes. Same rendering and palette as the rest of the deck regardless**Reference grammar** (`ai` rows): write **subject + intent + composition** only. Do NOT repeat style words ("flat design", "modern") or HEX values — both are already locked deck-wide by `design_spec §III AI Image Strategy` (rendering + palette) and `§III Color Scheme` (HEX triplet). Image_Generator's prompt assembler injects them.