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(illustration): make AI assets composable across slide layouts
hugohe3c6cef40666d4
diff --git a/docs/roadmap.md b/docs/roadmap.mdindex 22143452..cb747df7 100644--- a/docs/roadmap.md+++ b/docs/roadmap.md@@ -52,7 +52,7 @@ A presentation is four layers: what is on the slide, how it is arranged, how it| 3D models, OLE objects | Not planned | Both need the host application or a recent Office build on the opening machine and fall back to a still preview elsewhere — the cross-renderer problem this project avoids by design. Inserting one by hand takes seconds. Objects already present in a source deck are preserved unchanged || Ink & camera feeds (Cameo) | Not planned | Hand-drawn annotation and live camera objects are presenter-session surfaces rather than generated design content, and both depend on recent Office builds. Such parts already present in a source deck pass through source-preserving routes as untouched package structure |-*Illustration* is deliberately absent from this table. It is a composite result — an image, an SVG, or a group of shapes — not a seventh carrier, and listing it beside *Images* would reintroduce the category confusion this layering removes.+*Illustration* is deliberately absent from this table. It is a composable result—an image, transparent slice, SVG, or group of shapes—not a seventh carrier. It may combine with any other suitable page carrier; listing it beside *Images* would reintroduce the category confusion this layering removes.### Layer 2 — Composition@@ -60,6 +60,7 @@ A presentation is four layers: what is on the slide, how it is arranged, how it|---|---|---|| Background | Systematized | Solid and gradient page backgrounds export as PowerPoint-native slide backgrounds; the picture case is signal-driven || Layering & grouping | Systematized | Explicit z-order and group contracts, including registered base/subject layer pairs |+| Illustration composition | Systematized | Planned per page as a coherent element family; when generation is available, compatible assets may be batch-generated on keyed sheets, strictly alpha-sliced, then reused as fixed title/corner chrome or recomposed as anchors, supporting figures, and accents alongside text, shapes, photos, and lettering || Grid, alignment, whitespace | Systematized | Shared composition contract plus composition-geometry vocabulary carried by each visual style || Palette | Systematized | Declared HEX values are the truth source for named semantic roles; reusable role anchors stay stable deck-wide, while contextual derivatives and sparse page-local accents remain available || Typography | Systematized | One deck-wide size anchor per structural role, with bounded `±2px` per-occurrence adjustment and a sparse non-structural Hero/Display exception |@@ -103,7 +104,7 @@ A presentation is four layers: what is on the slide, how it is arranged, how itActively underway or up next — no committed timeline.-- **Calibrate the recently landed systems on real decks** — multi-deck intake, the material-divergence field, the spot-illustration system, and structured template creation have all shipped; what they need now is real-usage signal, not more mechanism. No pre-emptive thresholds or quotas.+- **Calibrate the recently landed systems on real decks** — multi-deck intake, the material-divergence field, the composable-illustration system, and structured template creation have all shipped; what they need now is real-usage signal, not more mechanism. No pre-emptive thresholds or quotas.- **Prompt slimming** — compress per-role prompt token footprint and improve cache hit rate without sacrificing quality. This is the indirect cost/speed lever; the boundary with quality-sacrificing speedups is drawn under Non-goals.---@@ -126,7 +127,7 @@ One line per month. Full detail lives in the [release notes](https://github.com/| 2026-03 | **Native PPTX route takes shape** — the SVG → DrawingML chain becomes usable; chart/layout template indexes ship || 2026-04 | **Pipeline at scale** — topic-only generation, 70 chart templates + three icon libraries, the `spec_lock` cross-page consistency contract, per-element animation and narration/video export || 2026-05 | **Visual editing + AI-image systematization** — Live Preview with deterministic in-place editing (built on [@WodenJay](https://github.com/WodenJay)'s [PR #85](https://github.com/hugohe3/ppt-master/pull/85)), template workspaces from PPTX, the rendering × palette × type image system, and the legacy raster LaTeX renderer |-| 2026-06 | **Mode & visual-style dual catalogs + intake expansion** — 5 narrative modes × 18 visual styles (+ `custom`), content-faithful beautify profile, multi-deck intake, spot-illustration pipeline, web-image quality gates, source-conversion fidelity gains (caption recognition from [@suay1113](https://github.com/suay1113)'s [PR #191](https://github.com/hugohe3/ppt-master/pull/191), hyperlink preservation distilled from [@ZhaoZuohong](https://github.com/ZhaoZuohong)'s [PR #155](https://github.com/hugohe3/ppt-master/pull/155)) |+| 2026-06 | **Mode & visual-style dual catalogs + intake expansion** — 5 narrative modes × 18 visual styles (+ `custom`), content-faithful beautify profile, multi-deck intake, composable-illustration pipeline, web-image quality gates, source-conversion fidelity gains (caption recognition from [@suay1113](https://github.com/suay1113)'s [PR #191](https://github.com/hugohe3/ppt-master/pull/191), hyperlink preservation distilled from [@ZhaoZuohong](https://github.com/ZhaoZuohong)'s [PR #155](https://github.com/hugohe3/ppt-master/pull/155)) || 2026-07 | **Positioning charter + native masters & layouts + token efficiency** ([v4.0.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.0.0)) — three-pass staged confirmation UI, real `p:sldMaster` / `p:sldLayout` export, `--native-charts-and-tables` opt-in, motion-export hardening, chart template library compacted || 2026-08 | **Template library + page-image reconstruction + native math and links** ([v4.5.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.5.0), [v4.6.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.6.0), [v4.7.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.7.0)) — brand / style / layout workspace library, visualizations split by information model with structure as a composition grammar, the Codex-supported `image-to-pptx` profile, video delivery carrying native animation sound, three editable whole-solution design directions, editable OMML formulas, native hyperlink authoring, and the four-layer coverage map |diff --git a/docs/technical-design.md b/docs/technical-design.mdindex 33fb3157..751aec98 100644--- a/docs/technical-design.md+++ b/docs/technical-design.md@@ -225,9 +225,10 @@ needed by the deck, but skips the separate Strategist planning/confirmationphase, first-page gate, and `finalize_svg.py`. The current agent follows everyexplicit user requirement and makes the remaining content, page, visual, andresource decisions automatically in one active context. It resolves a mode and-visual style, considers the complete carrier menu—images, icons, qualitative-Structure, native shapes, charts/tables, and formulas—then authors under the-shared SVG standards, runs any selected+visual style, considers the complete carrier menu—images, transparent+illustration/lettering assets, icons, qualitative Structure, native shapes,+charts/tables, and formulas—and may combine any suitable subset on a page. It+then authors under the shared SVG standards, runs any selectedcapability-specific preparation, passes one lockless final quality gate, anduses the same DrawingML converter and postflight. It writes no substitute planor resumable design history; context loss restarts the Quick run.@@ -640,7 +641,7 @@ Several architectural decisions shape this phase:**The Design Spec owns the image-execution path.** Final confirmation from either the UI or chat is first persisted as `AI Image Acquisition Path` in `design_spec.md §I`; Image_Generator selects API, host-native, or manual from that value and may not reopen the decision during execution. `image_gen.py --manifest` belongs only to API Path A. The current CLI still contains a defensive guard that reads UI `result.json` and blocks an accidental Path A call when that file explicitly records `host-native` or `manual`. That guard is not an authority source, does not cover chat-only confirmation, and cannot replace Design Spec routing. It is a remaining implementation mismatch in the upstream authority chain, not a normal consumer path.-**One coherent sheet per compatible visual family.** Related spots may share one AI illustration sheet when their cell shapes, detail, quality, and semantic needs are compatible. Decorative lettering is grouped by visual identity rather than an identical effect recipe: compatible marks share a sheet, genuinely different identities use separate sheets, and one family splits only when its element geometry or quality needs conflict. The prompt supplies role, placement context, relative visual weight, and energy; the model owns detailed effect composition inside the confirmed deck identity, with controlled glyph-native expression by default and strong or lettering-plus-illustration expression only after an explicit request or confirmed direction. Every sheet uses an explicit flat pure-red/green/blue chroma key whose active channel does not dominate its elements; the same HEX is passed to `slice_images.py --bg`, whose chroma path removes key spill and recovers partial effect alpha. `--strict-alpha` then rejects any nontransparent cell boundary or edge-crossing effect before writing derived files. Successful transparent slices join `images/`, then `analyze_images.py` refreshes their dimensions.+**One coherent sheet per compatible visual family.** AI sheets prepare transparent illustration or lettering elements rather than complete page layouts. A family may include repeated title/corner chrome, dominant anchors, supporting figures, and accents with different silhouettes and visual weights; compatible elements share a sheet and split only when cell geometry, detail, quality, or semantic needs conflict. SVG may combine the slices with backgrounds, native shapes, editable text, photos, other slices, and lettering on any suitable page, and one slice may recur across several pages. Decorative lettering remains grouped by visual identity, with controlled glyph-native expression by default and strong or lettering-plus-illustration expression only after an explicit request or confirmed direction. Every sheet uses an explicit flat pure-red/green/blue chroma key whose active channel does not dominate its elements; the same HEX is passed to `slice_images.py --bg`, whose chroma path removes key spill and recovers partial effect alpha. `--strict-alpha` then rejects any nontransparent cell boundary or edge-crossing effect before writing derived files. Successful transparent slices join `images/`, then `analyze_images.py` refreshes their dimensions.**Terminal status before Executor.** Rows that require acquisition must end in `Generated`, `Sourced`, or `Needs-Manual`; `Pending` and `Failed` are not allowed to leak into Executor. A `Needs-Manual` row can continue through SVG generation only as a known placeholder/dependency, and Step 7 re-checks required files before final export.diff --git a/docs/zh/roadmap.md b/docs/zh/roadmap.mdindex 2065e5b3..ce4797b5 100644--- a/docs/zh/roadmap.md+++ b/docs/zh/roadmap.md@@ -52,7 +52,7 @@| 3D 模型、OLE 对象 | 暂不考虑 | 两者都要求打开文件的机器装有宿主程序或较新版 Office,否则退化成一张静态预览图——正是本项目有意规避的跨渲染器问题。手动插入只要几秒。来源 deck 中已有的对象原样保留 || 墨迹与摄像头对象(Cameo) | 暂不考虑 | 手绘批注与实时摄像头对象属于演示现场的表面,不是生成的设计内容,且都依赖较新版 Office。来源 deck 中已有的此类 part 经源保留路线作为未改动的包结构透传 |-**插图**有意不列进这张表。它是复合结果——一张图片、一段 SVG,或一组形状——而不是第七种载体;把它与「图片」并列,会重新引入这套分层正要消除的维度混淆。+**插图**有意不列进这张表。它是可组合结果——一张图片、透明切片、一段 SVG,或一组形状——而不是第七种载体;它可以与页面上其他合适载体共同构图,把它与「图片」并列反而会重新引入这套分层正要消除的维度混淆。### 第二层 — 构图系统@@ -60,6 +60,7 @@|---|---|---|| 背景 | 系统化 | 纯色与渐变页面背景导出为 PowerPoint 原生底色;图片背景属信号驱动 || 层级与分组 | 系统化 | 显式 z-order 与分组契约,含 registered base / subject 图层对 |+| 插图构成 | 系统化 | 按页面规划为统一的元素家族;生图能力可用时,可在色键图纸中批量生成兼容素材、严格透明切片,再作为固定标题 / 四角装饰复用,或重组为主体锚点、辅助形象与点缀,并与文字、形状、照片、艺术字共同构图 || 网格、对齐、留白 | 系统化 | 共享构图合同,加由每种视觉风格各自承载的构图几何词汇 || 配色 | 系统化 | 声明的 HEX 是具名语义角色的真值来源;可复用角色锚点跨页保持稳定,仍可使用情境派生色与稀疏页内点缀 || 字体 | 系统化 | 每个结构角色一个跨页字号锚点,单次出现可在 `±2px` 内受限调整;稀疏非结构 Hero/Display 另有例外 |@@ -103,7 +104,7 @@明确在做或下一步要做,不承诺时间窗口。-- **在真实 deck 上校准新落地的体系** — 多 deck 合并 intake、材料发散度、插画体系、结构化模板创作均已上线;它们现在需要的是真实使用信号,而不是更多机制。不预先加机械阈值或配额。+- **在真实 deck 上校准新落地的体系** — 多 deck 合并 intake、材料发散度、可组合插画体系、结构化模板创作均已上线;它们现在需要的是真实使用信号,而不是更多机制。不预先加机械阈值或配额。- **Prompt 精简** — 在不降质量的前提下压缩各角色 prompt 的 token 占用、提升缓存命中率,带来间接的成本 / 速度改善。与「纯速度优化」的边界见下方「明确不做」。---@@ -126,7 +127,7 @@| 2026-03 | **原生 PPTX 路线成形** — SVG → DrawingML 链路可用;图表 / 版式模板索引上线 || 2026-04 | **管线规模化** — 仅凭主题生成、70 个图表模板 + 三套图标库、`spec_lock` 跨页一致性契约、逐元素动画与旁白 / 视频导出 || 2026-05 | **可视化编辑 + AI 图片体系化** — Live Preview 确定性原位编辑(基于 [@WodenJay](https://github.com/WodenJay) 的 [PR #85](https://github.com/hugohe3/ppt-master/pull/85))、从 PPTX 创建模板工作区、rendering × palette × type 图片体系、旧版栅格 LaTeX 渲染器 |-| 2026-06 | **mode 与 visual-style 双 catalog + intake 扩展** — 5 种叙事 mode × 18 种视觉风格(+ `custom`)、内容忠实的美化 profile、多 deck 合并 intake、插画切片管线、网络图片质量闸门、源转换保真提升(图注识别基于 [@suay1113](https://github.com/suay1113) 的 [PR #191](https://github.com/hugohe3/ppt-master/pull/191),超链接保留提炼自 [@ZhaoZuohong](https://github.com/ZhaoZuohong) 的 [PR #155](https://github.com/hugohe3/ppt-master/pull/155)) |+| 2026-06 | **mode 与 visual-style 双 catalog + intake 扩展** — 5 种叙事 mode × 18 种视觉风格(+ `custom`)、内容忠实的美化 profile、多 deck 合并 intake、可组合插画切片管线、网络图片质量闸门、源转换保真提升(图注识别基于 [@suay1113](https://github.com/suay1113) 的 [PR #191](https://github.com/hugohe3/ppt-master/pull/191),超链接保留提炼自 [@ZhaoZuohong](https://github.com/hugohe3/ppt-master/pull/155)) || 2026-07 | **定位章程 + 原生母版 / 版式 + token 效率**([v4.0.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.0.0))— 三段式分步确认 UI、真 `p:sldMaster` / `p:sldLayout` 导出、`--native-charts-and-tables` opt-in、动效导出加固、图表模板库压缩 || 2026-08 | **模板库 + 页面图重建 + 原生公式与链接**([v4.5.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.5.0)、[v4.6.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.6.0)、[v4.7.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.7.0))— brand / style / layout 工作区库、可视化按信息模型拆分且结构改为组合语法、Codex 支持的 `image-to-pptx` profile、带原生动画音效的视频交付、三条可编辑整体设计方向、可编辑 OMML 公式、原生超链接创作,以及四层能力覆盖地图 |diff --git a/docs/zh/technical-design.md b/docs/zh/technical-design.mdindex 9904b656..81e00321 100644--- a/docs/zh/technical-design.md+++ b/docs/zh/technical-design.md@@ -190,7 +190,7 @@ Executor 角色逐页生成演示文稿的视觉内容,输出为 SVG 文件。**第三阶段:工程化转换**后处理脚本将受支持的 SVG 向量元素转换为 DrawingML。文本和向量形状会保持为 PowerPoint 原生对象——可点击、可编辑、可改样式;位图资源则复制为 PPT picture media,而不是把整页压平成一张图片。-`quick-generate` 保留 deck 所需的来源理解与资源准备,但跳过独立的 Strategist 规划 / 确认阶段、首屏 gate 与 `finalize_svg.py`。当前 Agent 照做用户明确提出的要求,并在一次有效上下文中自动完成其余的内容、页结构、mode、visual style 与资源决策;图片、图标、定性 Structure、原生形状、图表 / 表格、公式和纯字体 / 几何都进入同一轮载体判断。随后仍按共享 SVG 规范创作,执行已选能力所需的准备,通过一次无锁最终质量门,并使用同一个 DrawingML 转换器与 postflight。它不写替代计划或可续接的设计历史;上下文丢失后重新运行 Quick。+`quick-generate` 保留 deck 所需的来源理解与资源准备,但跳过独立的 Strategist 规划 / 确认阶段、首屏 gate 与 `finalize_svg.py`。当前 Agent 照做用户明确提出的要求,并在一次有效上下文中自动完成其余的内容、页结构、mode、visual style 与资源决策;图片、透明插图 / 艺术字资源、图标、定性 Structure、原生形状、图表 / 表格、公式和纯字体 / 几何都进入同一轮载体判断,每页可以组合其中任意合适的子集。随后仍按共享 SVG 规范创作,执行已选能力所需的准备,通过一次无锁最终质量门,并使用同一个 DrawingML 转换器与 postflight。它不写替代计划或可续接的设计历史;上下文丢失后重新运行 Quick。---@@ -537,7 +537,7 @@ Generate 路由会在加载流程前选定一份运行时权威:[`workflows/ge**图片执行路径以 Design Spec 为权威。** UI 或聊天中的最终确认都先固化为 `design_spec.md §I` 的 `AI Image Acquisition Path`;Image_Generator 根据该值选择 API、host-native 或 manual,不能在执行阶段重新决定。`image_gen.py --manifest` 只属于 API Path A。当前 CLI 仍保留一个读取 UI `result.json` 的防误调用 guard,用于在该文件明确记录 `host-native` / `manual` 时阻止误跑 Path A;它不是权威来源,不覆盖 chat-only,也不能替代 Design Spec 的路线判断。这是当前代码与上游权威链尚未闭合的实现差异,不能当作正常消费路径。-**每个兼容视觉家族尽量共用一张 sheet。** 相关小插画在 cell 形状、细节、质量和语义需求兼容时可以共用 AI illustration sheet。艺术字按视觉身份而不是固定效果配方分组:兼容字标共用一张,真正不同的视觉身份分开生成;同一视觉家族只在元素几何或质量需求冲突时再拆。提示词提供表达角色、放置语境、相对视觉重量和能量感;模型在已确认的整套视觉身份内决定具体效果组合,默认采用克制的字形内生表达,只有用户明确要求或确认了强表现 / 艺术字加插画组合方向才提高强度或加入外部元素。每张 sheet 使用一个有效通道不主导元素色彩的显式纯红、纯绿或纯蓝键,并把同一 HEX 传给 `slice_images.py --bg`;chroma 路径会去除键色污染并恢复效果的半透明度,随后 `--strict-alpha` 在写入派生文件前拒绝任何未透明的 cell 边界或越界效果。成功切出的透明元素进入 `images/`,随后重跑 `analyze_images.py` 刷新尺寸。+**每个兼容视觉家族尽量共用一张 sheet。** AI sheet 准备的是透明插图或艺术字元素,而不是完整页面。一个家族可以同时包含重复使用的标题 / 四角装饰、大型视觉锚点、辅助人物和点缀元素;轮廓与视觉重量可以不同,只在 cell 几何、细节、质量或语义需求冲突时拆分。SVG 可以在任何合适的页面上把这些切片与背景、原生形状、可编辑文字、照片、其他切片和艺术字组合起来,同一元素也可以跨页复用。艺术字仍按视觉身份分组,默认采用克制的字形内生表达,只有用户明确要求或确认了强表现 / 艺术字加插画组合方向才提高强度或加入外部元素。每张 sheet 使用一个有效通道不主导元素色彩的显式纯红、纯绿或纯蓝键,并把同一 HEX 传给 `slice_images.py --bg`;chroma 路径会去除键色污染并恢复效果的半透明度,随后 `--strict-alpha` 在写入派生文件前拒绝任何未透明的 cell 边界或越界效果。成功切出的透明元素进入 `images/`,随后重跑 `analyze_images.py` 刷新尺寸。**Executor 前必须进入终态。** 需要获取的资源行必须落到 `Generated`、`Sourced` 或 `Needs-Manual`;`Pending` 和 `Failed` 不能漏进 Executor。`Needs-Manual` 可以作为已知占位 / 依赖继续进入 SVG 生成,但 Step 7 会在最终导出前重新检查必需文件是否已经存在。diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex ff2602d0..3c920c10 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -162,8 +162,9 @@ Before drawing each page, look up its entry in `page_rhythm` (key format `P<NN>`- **Main-agent ownership**: SVG generation must run in the main agent (not sub-agents) — pages share upstream context for cross-page visual continuity- **Generation rhythm**: P01 → first-page gate → uninterrupted remaining pages → final gate, in one context without batches or mid-run checker calls.- **Fact provenance**: when a §IX page lists `Fact IDs`, resolve each ID from `sources/*.facts.json` and keep the claim/value unchanged. Render a compact source footnote using the source name and a short URL/domain when space permits; when speaker notes are enabled, state the attribution naturally there too. When §IX says `Data class: scenario`, place a visible localized `Scenario data` / `情景数据` label adjacent to the affected KPI/chart and, when notes are enabled, state naturally there that the number is illustrative. Never attach an external fact ID to scenario data or let an unlabeled invented KPI look factual.+- **Default — compose compatible carriers by page job (may use any suitable subset)**: background paint, native shapes, editable text, prepared photos/scenes, transparent illustration slices, decorative lettering, icons, and visualizations may share one page. Use only prepared resources; choose their combination, visual weight, and z-order from the page message, hierarchy, and resolved style rather than isolating each carrier in its own block.- **Default — stage each page with the style's composition geometry (may override when the content genuinely calls for a plain grid)**: an SVG page is a canvas, not a DOM. Resolve the page-scale move from `spec_lock.md`: a preset uses that selected style's §1 `Composition geometry`; `custom` executes `visual_style_behavior` first, then uses §1 geometry only from exact `visual_style_references` that the behavior assigns a shape or composition job. Other bases contribute only their assigned job, and an unreferenced novel custom follows its behavior alone. Before defaulting to stacked rounded-rect cards or uniform equal columns, use that resolved geometry to stage the page's primary zone. Card grids are one option among many, not the house layout.-- **Default — vary a planned deck motif instead of cloning it (may omit where it has no page job)**: when §III `Theme` names a cross-page motif, use the current §IX `Layout` to preserve its recognizable contour, direction, material, or relationship while varying scale, crop, density, position, and content interaction by page role. Apply it only where it supports hierarchy or continuity; do not paste identical ornament or invent a second recurring identity.+- **Default — realize the planned motif system's reuse mode (may omit where it has no page job)**: when §III `Theme` names a cross-page motif or element family, exact repetition is valid for deliberate title/corner chrome; adaptive elements may vary scale, crop, density, position, and content interaction by page role. Preserve the named invariant, apply it only where it supports hierarchy or continuity, and do not invent a competing recurring identity.- **Inherited containers**: preserve meaningful template frames; restyle radius, fill, stroke, and depth from the active Design Spec and `spec_lock.md`. Selected Chart/Table reference adaptation is owned by [`executor-visualization.md`](./executor-visualization.md); preview effects never override project styling or structural roles.- **Reference — prefer semantic geometry over preset stacks**: for relationships such as ascending, converging, breaking through, or stacking, first seek a basic primitive, one exact preset, or a clear Boolean result. Only when none can faithfully express the relationship should one page-specific polygon/path replace a stack of generic arrows.- **Reference — create depth with restraint**: use rhythm, spacing, typography, accent bars, and subtle tints before shadows. Reserve lift for a few genuinely floating elements; keep peer grids, dividers, and ordinary body containers flat. When material layering itself is part of the resolved visual style, follow that style's hierarchy instead of flattening its body planes.diff --git a/skills/ppt-master/references/image-generator.md b/skills/ppt-master/references/image-generator.mdindex 89f5e422..055d2b15 100644--- a/skills/ppt-master/references/image-generator.md+++ b/skills/ppt-master/references/image-generator.md@@ -16,7 +16,7 @@ AI images exist to serve the deck's communication goal. Pick whatever combinatio| `page_role` | Use ||---|---|-| `local` | Image occupies a prepared SVG region. The AI composes inside that bitmap/container; it does not choose the page region or final SVG geometry |+| `local` | Image or transparent element is composed by SVG within the page. It may be boxed, unboxed, repeated as chrome, or become the page's dominant non-full-canvas visual; SVG owns final geometry and carrier combination || `hero_page` | Image is the page's main voice — cover, chapter divider, mood transition, single-number hero, closing quote. SVG above may be minimal or empty |**Two text policies** (orthogonal to page_role):@@ -153,7 +153,7 @@ Every assembled prompt follows this paragraph structure. **Write prose, not tag[Deck color behavior — state the core anchors and any context-justified tonal treatment, e.g. "secondary background #F8F9FA provides the breathing field, primary #1E3A5F carries main forms, accent #D4AF37 marks one emphasis; subtle lighter/darker material transitions remain in the same visual family"].[Composition — from the chosen type file or §4.1 no-type prose].[Image-specific subject — translated from the row's Reference intent into concrete visual nouns].-[Container note — "composed as a {W}x{H}px image for {page_role} use"; add composition cues only when the page actually needs them. SVG-overlay-reservation cues ("leave the lower band calm — SVG title overlays it", "keep the right third calmer for SVG text") are valid when `page_role: hero_page`, or when §VIII `Reference` / §IX `Layout` explicitly plans native labels, hotspots, lenses, or other SVG overlays inside a `local` image region. Otherwise a `local` image is a self-contained region block and reserves no interior overlay space].+[Container note — "composed as a {W}x{H}px image for {page_role} use"; add composition cues only when the page actually needs them. SVG-overlay-reservation cues ("leave the lower band calm — SVG title overlays it", "keep the right third calmer for SVG text") are valid when `page_role: hero_page`, or when §VIII `Reference` / §IX `Layout` explicitly plans native labels, hotspots, lenses, or other SVG overlays inside a `local` image region. Otherwise an opaque `local` image reserves no interior overlay space; a transparent illustration slice is generated as an isolated element and composed with other carriers by SVG].[Hard rules — see §5].```@@ -248,15 +248,17 @@ Example opening for a triptych hero:**When uncertain about field conventions**: read `sources/` before drafting the prompt.-### 4.3 Illustration sheets — one generation, many spot or lettering elements+### 4.3 Illustration sheets — one generation, many composable illustration or lettering elements-An Illustration Sheet can produce several small **spot illustrations** or-**decorative lettering elements** in one generation and preserve closely-matched rendering, deck-color treatment, and finish before slicing. A lettering-sheet is the batch form of stable Layer 1 artwork; it does not turn page copy-into an image.+An Illustration Sheet produces compatible transparent **illustration elements**+or **decorative lettering elements** with matched rendering, deck-color+treatment, and finish before slicing. Elements may differ in subject,+silhouette, visual weight, and page job, then combine with backgrounds, native+shapes, text, photos, other slices, or lettering on any suitable page. The sheet+generates assets; SVG authors the page composition. A lettering sheet remains+stable Layer 1 artwork and does not turn page copy into an image.-**Default — one sheet per compatible visual family (may override when separate generation serves the assets better)**: For lettering, group planned marks by a coherent visual identity, not an identical effect recipe. One sheet may vary material, lighting, intensity, or supporting ornament per mark when the family still reads as one deck-aligned system and each mark keeps its planned visual weight; use separate sheets for genuinely different identities, and split a family only when proportions, detail, quality, or semantic precision differ materially. Apply the same compatibility test to spot illustrations. Quantity alone neither requires nor forbids a sheet; a single hero/local image or standalone artistic word stays with the normal one-row-per-image flow (§4.1).+**Default — one sheet per compatible visual family (may override when separate generation serves the assets better)**: Group illustration elements or planned marks by a coherent visual identity, not an identical effect recipe. A family may vary subject, silhouette, material, lighting, intensity, and intended visual weight; recurring title/corner ornaments, dominant anchors, supporting figures, and small accents are examples rather than required roles. Split only when cell geometry, detail, quality, or semantic precision materially conflicts. Quantity alone neither requires nor forbids a sheet: a single transparent element may use a keyed `1x1` sheet, while a full-canvas or nontransparent image stays on the normal one-row path (§4.1).**Hard rule**: a sheet is a generation source, not a slide asset. In Default Generate, keep the sheet row out of `spec_lock.md images`; in Quick Generate, retain its generation-only status in active context and the operational manifest. The sheet is never referenced from SVG. Only sliced element rows are placed.@@ -269,7 +271,7 @@ into an image.- State the intended cell shape in the prompt: compact square object, tall portrait element, wide landscape vignette, or wide lettering mark. Do not let the model shrink every subject into a centered square sticker.- One **flat single-color chroma-key background** across the whole sheet. Choose and state one pure single-channel key (`#00FF00`, `#0000FF`, or `#FF0000`) whose active color does not dominate any element or supporting effect; it is a technical key, not part of the deck palette. Use that same untouched color in every gutter, keep it out of reflections and color spill, and keep paper grain, halftone, vignette, and every other texture inside the elements, never over the background.- Shared `deck_rendering` + `color_scheme` as always.-- **Spot sheet**: apply the §5.3 `none` cue; include no text, labels, or numbers.+- **Illustration sheet**: name each intended element and its page or recurring-reuse job; apply the §5.3 `none` cue and include no text, labels, or numbers.- **Lettering sheet**: put exactly one named stable string in each cell as the only text and quote every complete character sequence literally in the prompt. Give the shared visual family, communication role, placement/background relationship, relative visual weight, and intended energy, then follow §5.3's controlled artistic-authorship default. Keep artistry inside the glyph through its silhouette, stroke structure, material, texture, depth, and contour-bound light/shadow. Do not add literal topic motifs, scene fragments, icons, detached ribbons, particles, or other surrounding illustrations unless the approved treatment explicitly requests a lettering-plus-illustration lockup. Keep each complete mark and any approved glyph-bound effect inside its cell with clear key-only padding; include no scene, unrelated copy, labels, watermark, or mockup surface.- **Delivery floor, not an aesthetic ceiling**: when the chosen lettering treatment or its supporting effects need more footprint, enlarge the cell, change the grid, or use a larger/separate sheet. Do not weaken an approved treatment merely to fit a convenient crop; this geometry rule never raises the expression level selected under §5.3.@@ -281,19 +283,20 @@ cell_ratio = sheet_ratio * rows / colsUse that deliberately. On a wide sheet (`16:9`, `21:9`, `4:1`, `8:1`), `1xN` makes each cell tall/portrait because the width is divided by `N` while height is kept; `Nx1` makes each cell wide/landscape because height is divided by `N` while width is kept. A designed `MxN` grid is also valid when the resulting cell ratio matches the intended placements.-| Target spot shape | Sheet plan | Slice grid |+| Target element shape | Sheet plan | Slice grid ||---|---|---|| Compact objects / badges | `1:1` sheet | `2x2`, `2x3`, or `3x3` || Tall side accents / upright objects | wide or square sheet | `1xN`, or any `MxN` whose cells are portrait || Wide banners / horizontal vignettes | wide sheet | `Nx1`, or any `MxN` whose cells are landscape |+| Large page anchors / dominant cutouts | dedicated sheet matching the silhouette | `1x1` || Decorative words, phrases, or multi-line lettering lockups | wide sheet | `Nx1`, or any `MxN` whose cells fit the planned string shapes |Within one visual family, create separate sheets per shape family when mixed shapes cannot share a grid with enough room. Keep the family coherent through the same `deck_rendering` and `color_scheme`, not by forcing all cells into one square sheet or prescribing the same effect stack.**Resource contract — the sheet and its elements are different row kinds.** A sliced element can only be placed if it exists in the active placeable-resource authority: `spec_lock.md images` in Default Generate or the current agent's prepared resource decision in Quick Generate. Default Generate keeps both row kinds in §VIII under [`strategist-image.md`](./strategist-image.md); Quick Generate resolves the same distinction in active context and its operational manifest without creating planning artifacts:-- **Sheet row** — `Acquire Via: ai`, `Type: Illustration Sheet`, the intent prompt, named as the slice source with its intended cell shape and placement purpose (`Reference: landscape footer-vignette spot set`, or `decorative lettering set: exact strings = ...`). It is generated in Step 5 but **never placed on a slide** — keep it **out of** `spec_lock.md images`. Image_Generator resolves the exact `aspect_ratio`, grid, and slice command from this intent.-- **Element rows** — one per used element, `Acquire Via: slice`, filename matching a `--names` output, `Reference` naming the parent sheet + cell/element. These **are** placed — list every one in the active placeable-resource authority, normally with `crop=no-crop` (a tight-trimmed transparent spot should be fit, not cover-cropped). Their dimensions are filled in after slicing (the preparation pass re-runs `analyze_images.py`). Each row carries an owner-resolved layout recommendation; SVG authoring may realize it as a direct cutout or inside an appropriate container while preserving the resource and crop/content constraints.+- **Sheet row** — `Acquire Via: ai`, `Type: Illustration Sheet`, the intent prompt, named as the slice source with its intended cell shape and placement purpose (`Reference: reusable title/corner illustration family`, or `decorative lettering set: exact strings = ...`). It is generated in Step 5 but **never placed on a slide** — keep it **out of** `spec_lock.md images`. Image_Generator resolves the exact `aspect_ratio`, grid, and slice command from this intent.+- **Element rows** — one per used element, `Acquire Via: slice`, filename matching a `--names` output, `Reference` naming the parent sheet + cell/element. These **are** placed — list every one in the active placeable-resource authority, normally with `crop=no-crop` (a tight-trimmed transparent element should be fit, not cover-cropped). One row may serve several page compositions. Dimensions are filled in after slicing (the preparation pass re-runs `analyze_images.py`). Each row carries an owner-resolved layout recommendation; SVG authoring may realize it as a direct cutout or inside an appropriate container while preserving the resource and crop/content constraints.For traceability, add optional `slice_grid` and `slice_names` fields to the sheet item in `image_prompts.json` after choosing the geometry. `image_gen.py` validates, preserves, and displays these metadata fields; it does not run the separate slicing command.@@ -310,11 +313,11 @@ python3 scripts/slice_images.py <project>/images/illus_sheet.png --grid 2x3 \1. **High-contrast flat chroma key.** `image_gen.py` has no transparent-background mode, so choose pure green, blue, or red whose active channel does not dominate the intended element/effect colors, state its exact HEX in the prompt, and pass it unchanged to `--bg`. The pure-key path removes color spill while recovering partial alpha for antialiasing, shadow, and glow. Texture, reflections, or key-color spill over the field still defeat extraction; keep them inside the artwork and away from the chosen key. If the model returns one visually flat chroma field with bounded pixel drift, measure that drift and raise `--tolerance` only enough to absorb it; the complete-boundary `--strict-alpha` gate must still pass. Regenerate or enlarge the sheet rather than placing a non-strict slice when an effect actually reaches an edge; use `--inset` only when an isolated outer gutter needs it.2. **Clean invisible grid, or it cuts ugly.** State the exact row/column structure and cell shape without asking the model to draw the grid; `--trim` absorbs smaller placement variance. Fused cells, a scene background, or any flourish/effect crossing its cell makes the parent sheet unusable. Do not generate several sheets or read them back merely to choose a favorite; re-roll only after strict keying failure or user/live-preview feedback exposes an unusable slice, then slice the replacement sheet again.-3. **Generate only as large as needed.** Each cell is a fraction of the sheet. Pick the smallest sheet size that keeps each sliced cell at least **1.5-2x** the intended display size. `1K` is usually enough for small 80-160px decorative spots; use `2K` for medium 180-320px placements; reserve `4K` for large, cropped, or potentially enlarged elements.+3. **Generate only as large as needed.** Each cell is a fraction of the sheet. Pick the smallest sheet size that keeps each sliced cell at least **1.5-2x** the intended display size. `1K` is usually enough for small accents; use `2K` for medium placements; reserve `4K` for large, cropped, or potentially enlarged elements.-**Reference — sliced-asset placement is not a constraint**: A transparent slice may remain an unboxed cutout or enter a card, evidence frame, label, panel, or other suitable container. Decorative-lettering slices may combine with shapes or other slices, while ordinary titles/subtitles remain separate SVG text. The owner-resolved layout text is an expression recommendation; SVG authoring owns the actual geometry and treatment while preserving the resource role and crop/content constraints.+**Reference — sliced-asset placement is not a constraint**: A transparent slice may remain an unboxed cutout, enter a container, or combine with background fields, native shapes, text, photos, other slices, and decorative lettering. It may repeat unchanged as deliberate title/corner chrome or be recomposed by page. Ordinary editable copy remains separate SVG text. The owner-resolved layout text is an expression recommendation; SVG authoring owns geometry and treatment while preserving resource identity and crop/content constraints.-**Through-line — one family, many roles.** A sheet pays off more when its visual family recurs coherently: an illustration sheet may share a motif world with cover/divider anchors, while a lettering sheet can supply the deck's small set of matching artistic hooks. A large cover/divider scene is not a giant sheet cell—generate it as its own `hero_page` image sharing the sheet's `deck_rendering` and `color_scheme`. Plan either relationship only when it serves the deck, never as a quota.+**Through-line — one family, many page compositions.** Reuse a family wherever it improves hierarchy, rhythm, continuity, or visual character. Exact repetition is valid for stable title/corner chrome; anchors, supporting elements, and accents may instead vary in scale, position, pairing, and content interaction. A large transparent anchor composed by SVG remains `local` / `slice`; use `hero_page` only when one prepared bitmap owns the page composition. Plan either behavior by fit, never as a quota.---diff --git a/skills/ppt-master/references/image-layout-patterns.md b/skills/ppt-master/references/image-layout-patterns.mdindex 3bf98747..aadb416b 100644--- a/skills/ppt-master/references/image-layout-patterns.md+++ b/skills/ppt-master/references/image-layout-patterns.md@@ -68,7 +68,7 @@ Compact composition vocabulary for prepared images and illustrations. Use the pa- **#P1-10 · Slim image strip with large type** — place a narrow image strip beside oversized horizontal type.- **#P1-11 · Negative-space dominant** — keep the visual and copy compact so whitespace carries hierarchy.- **#P1-12 · Framed figure with caption** — float one image in whitespace with a restrained frame and native caption.-- **#P1-13 · Illustration as layout field** — let a large illustration or cutout set the page rhythm; place copy in its calm regions.+- **#P1-13 · Illustration as layout field** — let one or more transparent illustration elements, alone or combined with native shapes or images, set the page rhythm; place copy in the resulting calm regions.### 3.2 P2 · Image as Canvas with Native Overlay@@ -176,7 +176,7 @@ The following three patterns are topologically different and are not interchange### 5.2 A2 · Subject and Cutout Layers-- **#A2-01 · Transparent sticker or cutout** — use a prepared RGBA asset and preserve its open silhouette.+- **#A2-01 · Transparent illustration or cutout** — use a prepared RGBA asset and preserve its open silhouette; compose it freely or repeat it as planned page chrome.- **#A2-02 · Subject breaking out of a container** — register a prepared foreground subject across its frame boundary.- **#A2-03 · Registered reconstruction group** — align a clean base with one or more prepared transparent midground/subject/foreground layers in one coordinate system. Draw each member at its required z-order. Give every full-canvas member the same `x`, `y`, `width`, `height`, and aspect mapping; never trim or independently crop it. Several padded-bbox-disjoint objects may share one prepared plate while remaining separate nested-SVG picture crops.diff --git a/skills/ppt-master/references/strategist-image.md b/skills/ppt-master/references/strategist-image.mdindex 6862692e..6958f6fe 100644--- a/skills/ppt-master/references/strategist-image.md+++ b/skills/ppt-master/references/strategist-image.md@@ -12,11 +12,11 @@ Always-on Stage-2 rendering-candidate extension plus confirmed image elaborationBefore Stage 2, construct rendering candidates independently of the proposed source set. After confirmation, map the confirmed source set through [`strategist.md`](./strategist.md) §h and honor explicit `image_notes` roles; this module never adds a source. The confirmed non-`none` set is an allowed acquisition boundary, not coverage: use a suitable subset and leave irrelevant sources unused. Explicit must-use sources, assets, or page roles remain required. Asset inventory and judgment determine unconfirmed count, subject, placement, and composition without substituting an unconfirmed source.-For illustration, apply this precedence: confirmed `none` → explicit user intent → the locked visual style's `Illus.` propensity (`core` / `supportive` / `sparse`) → none. Propensity controls the lean, not the source or a page quota. When illustration is active, prefer one coherent motif family across hero/section anchors and local spots, but only when the confirmed assets can form that family.+For illustration, confirmed `none` stops and explicit user intent wins. Otherwise the locked visual style's `Illus.` propensity (`core` / `supportive` / `sparse`) tunes centrality and recurrence after the per-page composition scan; it never restricts eligible page types, element scale, or carrier combinations. When illustration is active, prefer one coherent family that can serve the actual page jobs, including recurring title/corner chrome, dominant anchors, supporting figures, and accents.**Context-first understanding for provided assets**: Do not visually scan `images/`. First infer identity, role, and crop / focus needs from source position and surrounding prose, captions / alt / titles, filename, user notes / confirmed `image_notes`, existing resource records, and CSV geometry. Inspect only one specific image when a remaining ambiguity would change selection, factual identity, page role, crop safety, or focal placement. Never inspect for inspiration, bulk-open the folder, or infer external facts / provenance from pixels. Record the result in §VIII. Leave an optional unresolved asset unused; route an unresolved must-use asset through failure recovery.-**Default — one coherent sheet per compatible visual family (may override when aspect, detail, quality, or semantic needs differ)**: for lettering, group exact strings by a shared visual identity rather than an identical effect recipe; compatible marks share a sheet, genuinely different identities use separate sheets, and one family splits only when its element needs conflict. Apply the same family test to AI-generated spots. For each sheet, plan one unplaced `ai` Illustration Sheet row plus one placed `slice` row per used element; only slice rows enter `spec_lock.md images`. State the communication role, placement/background relationship, relative visual weight, intended energy, visual family, and placement shape family without prescribing an effect stack. Use glyph-native expression by default; record a lettering-plus-illustration lockup only when the user explicitly requests it or the confirmed direction requires it. Lettering sheets use `text_policy: embedded`; authoritative title/chrome wording stays outside. [`image-generator.md`](./image-generator.md) §§4.3 and 5.3 own the controlled-default/high-expression boundary, artistic authorship, grid, key field, slicing, and execution details. Final Stage 2 chooses the AI execution path under `image-generator.md` §7; do not pre-empt or re-pick it here.+**Default — one coherent sheet per compatible visual family (may override when aspect, detail, quality, or semantic needs differ)**: group AI illustration elements or exact lettering strings by shared visual identity rather than an identical effect recipe; compatible elements share a sheet and split only when their geometry, detail, quality, or semantics conflict. For each sheet, plan one unplaced `ai` Illustration Sheet row plus one placed `slice` row per used element; only slice rows enter `spec_lock.md images`, and one element row may serve several §IX pages. State each element's communication job, placement/reuse relationship, relative visual weight, energy, family, and shape without prescribing an effect stack. Use glyph-native expression by default; record a lettering-plus-illustration lockup only when the user explicitly requests it or the confirmed direction requires it. Lettering sheets use `text_policy: embedded`; authoritative title/chrome wording stays outside. [`image-generator.md`](./image-generator.md) §§4.3 and 5.3 own the controlled-default/high-expression boundary, artistic authorship, grid, key field, slicing, and execution details. Final Stage 2 chooses the AI execution path under `image-generator.md` §7; do not pre-empt or re-pick it here.**Mandatory — materialize proactive lettering**: When confirmed image usageretains `ai`, the effective acquisition path has a callable Path A/B, and thediff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex f70bd16f..eeb94d63 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -279,7 +279,7 @@ owns SVG authoring under [`native-hyperlinks.md`](./native-hyperlinks.md).|---|---|---|| `none` | No images | Data reports or process documentation whose visual burden is fully served by charts / native SVG || `provided` | User-provided assets | Existing images carry factual, brand, product, or narrative authority |-| `ai` | AI-generated | Invented or deliberately stylized illustrations, backgrounds, metaphors, or a coherent spot family are needed |+| `ai` | AI-generated | Invented or deliberately stylized illustrations, backgrounds, metaphors, or a coherent composable illustration family are needed || `web` | Web-sourced | A named or evidence-bearing real-world subject must appear as itself || `placeholder` | Deferred | The image is required but will be supplied later |@@ -318,9 +318,12 @@ implementation parameters. Executor may adapt/decline thetwo non-literal suggestions while preserving content and intent; explicituser/template requirements bind.+**Reference — carriers compose, not compete**: Any page may combine a suitable subset of background paint, native shapes, editable text, photos/scenes, transparent illustration elements, decorative lettering, icons, and visualizations. Select only what improves communication and composition; outside explicit requirements, no carrier is mandatory or mutually exclusive.+| Capability | Opportunity signal | Design Spec handoff ||---|---|---|| Image composition | Image-as-canvas, editorial crop, collage, cutout, or meaningful focus / comparison / evidence units carry the page better than an adjacent rectangle | Propose a permitted source; when selected, apply the already-loaded [`strategist-image.md`](./strategist-image.md) resource contract plus the conditional image-layout references, record a concise §VIII `Layout pattern` suggestion, and describe page-level image/overlay relationships in §IX `Layout` / `Images` |+| Composable illustration family | One or more pages benefit from coherent reusable title/corner ornaments, dominant anchors, supporting figures, or accents that can mix with text, shapes, photos, or lettering | Apply [`strategist-image.md`](./strategist-image.md): plan transparent illustration elements by compatible family, record fixed reuse or adaptive variation in their §VIII `Reference`, and describe each used page's carrier relationships in §IX `Layout` / `Images` || Native paint / overlay | Gradient, translucency, scrim, vignette, or wash supports focus, hierarchy, depth, legibility, or image integration | Record purpose/layering in §IX `Layout`, plus `Images` when imagery participates; no new field or type/stops/opacity/coordinates—Executor chooses realization || Native shape / Merge Shapes | A literal Office symbol, a stock bent/curved relationship contour, or a compound silhouette, negative-space cutout, overlap-only region, or meaningful fragmentation strengthens the visual idea | Add an optional §IX `Native shape suggestion` with the semantic result plus a candidate preset/Connector family or Boolean operation/operands || AI decorative lettering asset | Any stable display string in the deck — cover hook, chapter word, place or product name, dish or exhibit name, year, hero number, pull quote, motif word — reads better with a material, dimensional, hand-rendered, or otherwise illustrative treatment than as ordinary text | Apply [`strategist-image.md`](./strategist-image.md): group exact strings by compatible visual family, state their role/context/relative visual weight/energy without fixing an effect recipe, plan one unplaced AI Illustration Sheet per family plus one transparent `slice` row per used mark, and keep subtitle/chrome/body as native text. A display wordmark and an editable page title may coexist |@@ -460,15 +463,16 @@ Lock the stable role set the deck needs, including recurring neutrals such as `s| Core + surrounding forces | center-radiating or hub-spoke || Wide visual + explanation | top-bottom split |-**Default — define one cross-page visual motif when it can carry identity or+**Default — define a cross-page visual motif system when it can carry identity ormeaning (may omit when restraint serves the deck better)**: after the complete-§IX roster and planned visual resources are known, choose or inherit one reusable-page-scale geometry or material gesture—such as a directional contour, opening,-line lattice, or oversized numeral. Fold its recognizable invariant and allowed-variation (scale, crop, density, position, content interaction) into the-existing §III `Theme`, and mention it only in §IX `Layout` blocks that use it.-Vary it by page role instead of copying one ornament; create no motif field or-lock row. This is a continuity Reference, not a decoration quota.+§IX roster and planned visual resources are known, choose or inherit a reusable+motif or coherent element family—such as title/corner ornaments, a directional+contour, opening, line lattice, or oversized numeral.+Fold its invariant and reuse mode into §III `Theme`: exact repetition is valid+for deliberate recurring chrome, while page-specific motifs may vary scale,+crop, density, position, and content interaction. Mention it only in §IX+`Layout` blocks that use it; create no motif field or lock row. This is a+continuity Reference, not a decoration quota.On PPT 16:9, start from a 1200×640 safe area with 40px outer margins, then adapt to content. Template workspaces may supply different geometry; when active, [`strategist-template.md`](./strategist-template.md) owns precedence.diff --git a/skills/ppt-master/references/visual-styles/_index.md b/skills/ppt-master/references/visual-styles/_index.mdindex 6a971910..52a8db3e 100644--- a/skills/ppt-master/references/visual-styles/_index.md+++ b/skills/ppt-master/references/visual-styles/_index.md@@ -14,7 +14,7 @@ Each style keeps its own authoritative file with: shape & decoration, typography> The **`visual_style` value is only ever a first-column `id`** (`swiss-minimal`, `editorial`, …). The "Paired rendering" column lists **image-rendering** names (`flat`, `minimalist-swiss`, `digital-dashboard`, …) — never treat one of those as the `visual_style`. Default records rendering under confirmation h; Quick keeps the selected rendering only in active context and any required image manifest.>-> The **`Illus.`** column is each style's spot-illustration propensity — `core` (illustration is intrinsic to the look), `supportive` (use where it lifts, restrained), or `sparse` (the style's lead visual competes; default off). It sets the **default lean** only, for when the user gives no steer: an explicit user request to use / skip illustrations overrides it either way, and `image_usage: none` always writes no illustration rows. Full per-style rule in each file's §6.+> The **`Illus.`** column is each style's illustration propensity — `core` (illustration is intrinsic to the look), `supportive` (illustration can share the composition), or `sparse` (use selectively so the style's lead visual remains clear). It tunes centrality and recurrence, never eligible page types, element scale, or carrier combinations. An explicit user request to use / skip illustrations overrides it either way, and `image_usage: none` always writes no illustration rows. Full per-style rule in each file's §6.### 1.1 Corporate / productdiff --git a/skills/ppt-master/references/visual-styles/blueprint.md b/skills/ppt-master/references/visual-styles/blueprint.mdindex f4f7cb8b..251f1c9f 100644--- a/skills/ppt-master/references/visual-styles/blueprint.md+++ b/skills/ppt-master/references/visual-styles/blueprint.md@@ -35,4 +35,4 @@ Engineering schematic — thin line work on dark blueprint paper, isometric proj## 6. Illustration propensity-**supportive** — but note the natural illustration here is hand-drawn **SVG schematic line-work / annotated marks**, not raster spot sheets; reach for line diagrams over decorative cutouts. If raster spots are used at all, keep them schematic, sparse, and secondary to the SVG line work. With no user steer this is the default lean; an explicit user request wins either way, and `image_usage: none` writes no illustration rows.+**supportive** — the natural illustration language is schematic line-work, annotated marks, and blueprint-aligned transparent elements, whether authored in SVG or generated and sliced. Choose the carrier that composes cleanly with the page. With no user steer this is the default lean; role, scale, reuse, and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/brutalist.md b/skills/ppt-master/references/visual-styles/brutalist.mdindex 2c94793a..7029db4a 100644--- a/skills/ppt-master/references/visual-styles/brutalist.md+++ b/skills/ppt-master/references/visual-styles/brutalist.md@@ -36,4 +36,4 @@ Brutalist editorial newspaper. Wall-to-wall small type, irregular column widths,## 6. Illustration propensity-**supportive** — raw halftone cuts fit the newsprint density, but structure leads; use them sparingly, only where a page needs a visual jolt. With no user steer this is the default lean; an explicit user request wins either way, and `image_usage: none` writes no illustration rows.+**supportive** — raw halftone cuts and illustration elements can anchor or disrupt the newsprint composition while structure remains legible. With no user steer this is the default lean; role, scale, reuse, and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/chalkboard.md b/skills/ppt-master/references/visual-styles/chalkboard.mdindex 2c14fa6f..ae309674 100644--- a/skills/ppt-master/references/visual-styles/chalkboard.md+++ b/skills/ppt-master/references/visual-styles/chalkboard.md@@ -34,4 +34,4 @@ Classroom chalkboard — a dark slate field, soft chalk-stroke line work, powder## 6. Illustration propensity-**core** — chalk-drawn marks and doodles are the classroom aesthetic; with no user steer, default to recommending a coherent spot-illustration family. Default *lean* only — heaviness and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.+**core** — chalk-drawn marks and doodles are the classroom aesthetic; with no user steer, default to recommending a coherent composable illustration family. Default *lean* only — role, scale, reuse, and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/dark-tech.md b/skills/ppt-master/references/visual-styles/dark-tech.mdindex 94338977..92934ad7 100644--- a/skills/ppt-master/references/visual-styles/dark-tech.md+++ b/skills/ppt-master/references/visual-styles/dark-tech.md@@ -35,4 +35,4 @@ Dark canvas, luminous accents, geometric precision. For tech, AI, dev tools, dat## 6. Illustration propensity-**sparse** — glow accents and geometric precision lead, and raster spots tend to read as clip-art against the dark UI. With no user steer, default to none. If the user explicitly asks, prefer restrained geometric marks over illustrated characters. `image_usage: none` writes no illustration rows.+**sparse** — glow accents and geometric precision lead. Use illustration selectively as a focal or supporting layer that belongs to the dark-tech system rather than generic clip-art; form and scale follow the page job. An explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/data-journalism.md b/skills/ppt-master/references/visual-styles/data-journalism.mdindex 18800415..fc2332c8 100644--- a/skills/ppt-master/references/visual-styles/data-journalism.md+++ b/skills/ppt-master/references/visual-styles/data-journalism.md@@ -34,4 +34,4 @@ Bloomberg / Economist news-infographic — publication-grade information density## 6. Illustration propensity-**sparse** — charts, sidebars, and data density carry the page; decorative spots undercut the serious data-publication tone. With no user steer, default to none. If the user explicitly asks, keep them minimal and journalistic. `image_usage: none` writes no illustration rows.+**sparse** — charts, sidebars, and evidence lead. Use illustration selectively for orientation, narrative framing, or emphasis without obscuring values or source authority; form and scale follow the page job. An explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/editorial.md b/skills/ppt-master/references/visual-styles/editorial.mdindex 4f46e2c3..9eaaa661 100644--- a/skills/ppt-master/references/visual-styles/editorial.md+++ b/skills/ppt-master/references/visual-styles/editorial.md@@ -36,4 +36,4 @@ Magazine-grade hierarchy. Columns, hairline rules, a serif / sans interplay, str## 6. Illustration propensity-**supportive** — editorial spot illustrations beside articles are classic here; use them where they lift a section or break text density, kept restrained. With no user steer this is the default lean; an explicit user request wins either way, and `image_usage: none` writes no illustration rows.+**supportive** — editorial illustration elements can anchor, frame, pace, or clarify a page while typography and evidence retain authority. With no user steer this is the default lean; role, scale, reuse, and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/glassmorphism.md b/skills/ppt-master/references/visual-styles/glassmorphism.mdindex 88b65314..8ed263c5 100644--- a/skills/ppt-master/references/visual-styles/glassmorphism.md+++ b/skills/ppt-master/references/visual-styles/glassmorphism.md@@ -34,4 +34,4 @@ Frosted-glass SaaS — translucent layered panels, flowing gradient light, float## 6. Illustration propensity-**sparse** — translucent panels, gradient light, and floating depth carry the look; decorative spots compete with the glass. With no user steer, default to none. If the user explicitly asks, keep them minimal and let them sit behind / under the glass rather than on top. `image_usage: none` writes no illustration rows.+**sparse** — translucent panels, gradient light, and floating depth lead. Use illustration selectively within, behind, beside, or across the glass layers when it improves composition without obscuring their hierarchy. An explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/ink-notes.md b/skills/ppt-master/references/visual-styles/ink-notes.mdindex 60043e81..3cc757d1 100644--- a/skills/ppt-master/references/visual-styles/ink-notes.md+++ b/skills/ppt-master/references/visual-styles/ink-notes.md@@ -35,4 +35,4 @@ Whiteboard-ink minimalism — a pale field, confident black hand-ink line work,## 6. Illustration propensity-**supportive** — the style is already sparse and considered; a few hand-ink spots fit, but restraint is its temperament — use only where one genuinely earns its place. With no user steer this is the default lean; an explicit user request wins either way, and `image_usage: none` writes no illustration rows.+**supportive** — hand-ink illustration elements can anchor, annotate, or connect a composition while the style's considered restraint remains intact. With no user steer this is the default lean; role, scale, reuse, and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/ink-wash.md b/skills/ppt-master/references/visual-styles/ink-wash.mdindex d0bfa9e5..0d7f5a0e 100644--- a/skills/ppt-master/references/visual-styles/ink-wash.md+++ b/skills/ppt-master/references/visual-styles/ink-wash.md@@ -34,4 +34,4 @@ New-Chinese ink-wash — a rice-paper field, vast literati whitespace, restraine## 6. Illustration propensity-**supportive** — a single brush mark or seal can anchor a page, but stillness and whitespace lead; use very few, very quiet. With no user steer this is the default lean; an explicit user request wins either way, and `image_usage: none` writes no illustration rows.+**supportive** — brush, seal, or painted illustration elements can anchor or frame a page while stillness and whitespace lead. With no user steer this is the default lean; role, scale, reuse, and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/memphis.md b/skills/ppt-master/references/visual-styles/memphis.mdindex 3cbafaf3..d03078bc 100644--- a/skills/ppt-master/references/visual-styles/memphis.md+++ b/skills/ppt-master/references/visual-styles/memphis.md@@ -35,4 +35,4 @@ Memphis / Pop — clashing color blocks, geometric confetti, bold outlines, 80s-## 6. Illustration propensity-**core** — bold-outline spots, confetti, and geometric shapes *are* the Memphis language; with no user steer, default to recommending a coherent spot-illustration family. Default *lean* only — heaviness and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.+**core** — bold-outline illustration elements, confetti, and geometric shapes *are* the Memphis language; with no user steer, default to recommending a coherent composable illustration family. Default *lean* only — role, scale, reuse, and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/paper-cut.md b/skills/ppt-master/references/visual-styles/paper-cut.mdindex d4f0d84e..149378d0 100644--- a/skills/ppt-master/references/visual-styles/paper-cut.md+++ b/skills/ppt-master/references/visual-styles/paper-cut.md@@ -34,4 +34,4 @@ Layered paper-craft — scissor-cut shapes stacked in tactile layers, soft shado## 6. Illustration propensity-**core** — layered cut-paper elements *are* the style, and the slicer's transparent cutouts match it natively; with no user steer, default to recommending a coherent spot-illustration family. Default *lean* only — heaviness and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.+**core** — layered cut-paper elements *are* the style, and transparent slices match it natively; with no user steer, default to recommending a coherent composable illustration family. Default *lean* only — role, scale, reuse, and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/photo-editorial.md b/skills/ppt-master/references/visual-styles/photo-editorial.mdindex 435cacce..8b62eb3a 100644--- a/skills/ppt-master/references/visual-styles/photo-editorial.md+++ b/skills/ppt-master/references/visual-styles/photo-editorial.md@@ -36,4 +36,4 @@ Photo-led editorial — large full-bleed photography dominates the page, text po## 6. Illustration propensity-**sparse** — photography *is* the visual; illustration competes with the hero image. With no user steer, default to none. If the user explicitly asks, keep them to tiny captional marks that never rival the photo. `image_usage: none` writes no illustration rows.+**sparse** — photography leads. Use illustration selectively when it frames, connects, or extends the photographic composition without displacing factual or visual authority; form and scale follow the page job. An explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/pixel-art.md b/skills/ppt-master/references/visual-styles/pixel-art.mdindex 68b97099..1f16114b 100644--- a/skills/ppt-master/references/visual-styles/pixel-art.md+++ b/skills/ppt-master/references/visual-styles/pixel-art.md@@ -34,4 +34,4 @@## 6. Illustration propensity-**core** — pixel sprites and blocky icons *are* the style; with no user steer, default to recommending a coherent spot-illustration family. Default *lean* only — heaviness and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.+**core** — pixel sprites and blocky forms *are* the style; with no user steer, default to recommending a coherent composable illustration family. Default *lean* only — role, scale, reuse, and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/sketch-notes.md b/skills/ppt-master/references/visual-styles/sketch-notes.mdindex 3ea85a5c..7545b5b0 100644--- a/skills/ppt-master/references/visual-styles/sketch-notes.md+++ b/skills/ppt-master/references/visual-styles/sketch-notes.md@@ -34,4 +34,4 @@ Warm hand-drawn sketchnote — soft paper field, black ink doodle line work, gen## 6. Illustration propensity-**core** — doodle spots and hand-drawn marks are intrinsic here, not optional garnish; with no user steer, default to recommending a coherent spot-illustration family (the decoration this style is built on). This sets the default *lean* only: heaviness and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.+**core** — doodles and hand-drawn illustration elements are intrinsic here, not optional garnish; with no user steer, default to recommending a coherent composable illustration family. This sets the default *lean* only: role, scale, reuse, and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/soft-rounded.md b/skills/ppt-master/references/visual-styles/soft-rounded.mdindex b566e695..2517ce50 100644--- a/skills/ppt-master/references/visual-styles/soft-rounded.md+++ b/skills/ppt-master/references/visual-styles/soft-rounded.md@@ -35,4 +35,4 @@ Approachable and modern. Rounded cards, gentle elevation, friendly rhythm. For p## 6. Illustration propensity-**supportive** — friendly rounded spots suit this approachable style; use them where they lift rhythm or section warmth, kept restrained. With no user steer this is the default lean; an explicit user request wins either way, and `image_usage: none` writes no illustration rows.+**supportive** — friendly rounded illustration elements can carry anchors, support, rhythm, or warmth across the page system. With no user steer this is the default lean; role, scale, reuse, and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/swiss-minimal.md b/skills/ppt-master/references/visual-styles/swiss-minimal.mdindex c637ea8c..c197000f 100644--- a/skills/ppt-master/references/visual-styles/swiss-minimal.md+++ b/skills/ppt-master/references/visual-styles/swiss-minimal.md@@ -36,4 +36,4 @@ Strict Swiss-grid discipline. Modular grid, sharp geometry, aggressive whitespac## 6. Illustration propensity-**sparse** — the whitespace and grid *are* the design; decorative spots compete with that restraint, so with no user steer, default to none. If the user explicitly asks, use them — but stay austere: very few, very light, never crowding the negative space. `image_usage: none` writes no illustration rows.+**sparse** — whitespace and grid lead. Use illustration selectively when it sharpens hierarchy or creates a deliberate counterpoint without eroding negative space; scale and placement follow the page composition. An explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/vintage-poster.md b/skills/ppt-master/references/visual-styles/vintage-poster.mdindex bd09f406..62610da2 100644--- a/skills/ppt-master/references/visual-styles/vintage-poster.md+++ b/skills/ppt-master/references/visual-styles/vintage-poster.md@@ -34,4 +34,4 @@ Mid-century print poster (1950s–1970s) — bold rounded-geometric shapes, limi## 6. Illustration propensity-**core** — mid-century spot motifs and halftone cuts are intrinsic to the poster look; with no user steer, default to recommending a coherent spot-illustration family. Default *lean* only — heaviness and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.+**core** — mid-century illustration motifs and halftone cuts are intrinsic to the poster look; with no user steer, default to recommending a coherent composable illustration family. Default *lean* only — role, scale, reuse, and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/references/visual-styles/zine.md b/skills/ppt-master/references/visual-styles/zine.mdindex eda1b17e..a8050004 100644--- a/skills/ppt-master/references/visual-styles/zine.md+++ b/skills/ppt-master/references/visual-styles/zine.md@@ -35,4 +35,4 @@ Risograph zine / DIY poster — misregistered color layers, halftone dots, a tig## 6. Illustration propensity-**core** — riso / halftone spot imagery is part of the zine's print grit; with no user steer, default to recommending a coherent spot-illustration family. Default *lean* only — heaviness and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.+**core** — riso / halftone illustration and cutout imagery is part of the zine's print grit; with no user steer, default to recommending a coherent composable illustration family. Default *lean* only — role, scale, reuse, and placement stay Strategist judgment, an explicit user request wins either way, and `image_usage: none` writes no illustration rows.diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex 88de0d31..70a97de7 100644--- a/skills/ppt-master/scripts/prompt_audit_manifest.json+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json@@ -33,7 +33,7 @@"skills/ppt-master/references/native-data-interface.md": 6750,"skills/ppt-master/references/pptx-structure-interface.md": 4750,"skills/ppt-master/references/strategist.md": 18000,- "skills/ppt-master/references/strategist-image.md": 2750,+ "skills/ppt-master/references/strategist-image.md": 3250,"skills/ppt-master/references/strategist-template.md": 3000,"skills/ppt-master/templates/design_spec_reference.md": 3750,"skills/ppt-master/templates/spec_lock_reference.md": 2750,diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.mdindex 72ec241a..1f4fabe5 100644--- a/skills/ppt-master/workflows/generate-pptx.md+++ b/skills/ppt-master/workflows/generate-pptx.md@@ -535,7 +535,7 @@ A deck with only `ai` rows never loads `image-searcher.md`; a deck with only `we> **Default — short provider query (may override for a complete entity name or necessary disambiguation)**: keep §VIII `Reference` as the locked subject/focal/crop intent and author a separate concrete `image_queries.json.query`. Search/review never rewrites the Design Spec or lock to fit a candidate.-> **Default — one sheet per compatible AI visual family (may override for different cell shape, detail, quality, or semantics)**: for lettering, group exact strings by a coherent visual identity rather than an identical effect recipe; compatible marks share a sheet, genuinely different identities use separate sheets, and one family splits only when its element needs conflict. Apply the same family test to spots. Give the model role/context/relative visual weight/energy and apply the controlled-default/high-expression boundary in [image-generator.md](../references/image-generator.md) §5.3. A lettering sheet contains no scene or page chrome; keep it unplaced and place/project only successful transparent `slice` rows. Contract: [image-generator.md](../references/image-generator.md) §4.3.+> **Default — one sheet per compatible AI visual family (may override for different cell shape, detail, quality, or semantics)**: group illustration elements or exact lettering strings by a coherent visual identity rather than an identical effect recipe. A family may include recurring chrome, dominant anchors, supporting figures, and accents; split only when element geometry, quality, or semantics conflict. Give the model each element's page/reuse job, relative visual weight, and energy, then apply the lettering boundary in [image-generator.md](../references/image-generator.md) §5.3. Keep every sheet unplaced and place/project only successful transparent `slice` rows. Contract: [image-generator.md](../references/image-generator.md) §4.3.> ⚠️ **Honor the Design Spec's confirmed image source before running any generation command**: the `ai` generation path (Path A = `image_gen.py` API / Path B = host-native tool / Offline Manual) is **not** auto-only — the production value recorded in `design_spec.md §I` wins. `host-native` forces Path B even when `IMAGE_BACKEND` is configured; `api` forces Path A; `manual` forces offline. Never reopen `result.json` here, and never run `image_gen.py --manifest` when the recorded value is `host-native` or `manual`. Full selection rule: [image-generator.md](../references/image-generator.md) §7 Path Selection.diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.mdindex 82969d83..e0ff048e 100644--- a/skills/ppt-master/workflows/profiles/quick-generate.md+++ b/skills/ppt-master/workflows/profiles/quick-generate.md@@ -278,9 +278,9 @@ the roster after the whole-roster check:- an ordinary body-content frame and a density judgment for every page, adapted to the canvas and any user / template / style geometry; use `anchor`, `dense`, `breathing`, or an equivalent active-context distinction instead of one uniform fill level;- for each page not bound to literal supplied geometry, a primary visual zone and page-scale composition direction tied to its core message; use cards or equal grids when the content relationship calls for them, not as the automatic page grammar;- for each page, preserve its semantic units, source-stated qualitative relationships, intended entry, and outcome so §3 can make the sole Structure decision before geometry;-- when useful, one transient deck-level visual motif with an identity or- communication job, a recognizable invariant, and deliberate variation across- applicable page roles; omit it when restraint serves the deck better;+- when useful, a transient deck-level visual motif system with an identity or+ communication job, a recognizable invariant, and a reuse mode: fixed chrome,+ adaptive variation, or both; omit it when restraint serves the deck better;- the resource decisions needed for immediate preparation. Required operationalimage manifests may carry filenames, page relationship, status, andgeneration/crop/focal cues, but do not create a general resource roster or an@@ -328,9 +328,13 @@ the complete carrier menu once and choose only the forms that communicate itscontent best. A decision to use none of a carrier is valid; skipping the scanbecause Quick is expected to be faster is not.+**Reference — carriers compose, not compete**: Any page may combine a suitable subset of background paint, native shapes, editable text, photos/scenes, transparent illustration elements, decorative lettering, icons, and visualizations. Outside explicit requirements, no carrier is mandatory or mutually exclusive; choose the combination that makes the page coherent and visually resolved.+**Hard rule**: Credentials do not decide image need. Missing `IMAGE_BACKEND`, host generation, or Pexels/Pixabay keys never justifies a zero-image result or deletion of a web-compatible role. Web acquisition retains zero-config providers; when no generator is callable, use web for compatible real-world roles while explicit generation-only requirements follow the normal Offline Manual boundary.-**Default — visual grounding before a zero-image deck (may override when the user forbids images or charts / native SVG fully carry the visual burden)**: When the audience must recognize, experience, compare, or choose an externally verifiable subject, place, product, or setting, plan supplied/extracted or web images. When a generator is callable, prepare AI imagery proactively where invented or deliberately stylized expression materially improves a planned visual job. This is a semantic decision, not an image-count quota.+**Default — visual grounding before a zero-image deck (may override when the user forbids images or charts / native SVG fully carry the visual burden)**: When the audience must recognize, experience, compare, or choose an externally verifiable subject, place, product, or setting, plan supplied/extracted or web images. When a generator is callable, prepare AI imagery proactively where invented or deliberately stylized expression materially improves a planned visual job; this may be a complete image or transparent elements composed with other page carriers. This is a semantic decision, not an image-count quota.++**Default — prepare a composable illustration family when it strengthens the deck (may omit when no page benefits)**: Resolve the family before SVG authoring. Elements may repeat unchanged as title/corner chrome or vary as dominant anchors, supporting figures, and accents on any suitable page. Batch compatible elements through Illustration Sheets, split only for geometry/detail/quality conflicts, and keep final page composition in SVG under [`image-generator.md`](../../references/image-generator.md) §4.3.**Mandatory — proactive AI decorative lettering**: Apply[`image-generator.md`](../../references/image-generator.md) §7's@@ -372,6 +376,7 @@ still follows the normal resource contract.| Communication job | Available carrier ||---|---|| Real subject, place, product, evidence, atmosphere, or scene benefits from visual grounding | Supplied/extracted, web, AI, or sliced image |+| Reusable title/corner decoration, a dominant illustrated anchor, supporting figure, or accent strengthens one or more page compositions | A coherent AI illustration family prepared as transparent `slice` assets and combined freely with other carriers || A compact semantic cue clarifies a category, process, KPI, state, navigation item, or real brand | Prepared project-local icon || Editable geometry can express a relationship, flow, emphasis, callout, symbol, or diagram | Basic SVG primitive, exact Office preset, Boolean result, then necessary freeform || Values, categories, time, weights, or duration determine mark geometry | Value-driven chart |@@ -426,7 +431,7 @@ Prepare only the resource paths needed by the decided pages:| Formula | Create no resource file. Retain the exact source LaTeX, then choose ordinary text, an inline native marker, or a block native marker under §3; the registered SVG preview is discarded by native export || AI image | Follow `image-base.md` + `image-generator.md`; apply only the chosen rendering preset or exact custom bases, never blend unselected catalog identities, and keep `image_prompts.json` plus its human-readable sidecar || Web image | Follow `image-base.md` + `image-searcher.md`; keep query/status data and `image_sources.json`, including any required on-slide attribution |-| Illustration / lettering slice | Generate or obtain the parent sheet, run `slice_images.py --trim --alpha --bg KEY_HEX_FROM_PROMPT --strict-alpha`, and place only outputs from a successful strict cut; a lettering sheet names every exact stable string and contains no scene or page chrome |+| Composable illustration / lettering slice | Generate or obtain the parent sheet, run `slice_images.py --trim --alpha --bg KEY_HEX_FROM_PROMPT --strict-alpha`, and place only outputs from a successful strict cut; one illustration element may serve several pages, while a lettering sheet names every exact stable string and contains no scene or page chrome || Registered reconstruction group | Follow `image-generator.md` §4.4; keep full-canvas members registered with `crop=no-crop`, and materialize every required shared-plate member as an independent picture object || Visualization | Keep Chart values, Table cell topology, and chosen treatment in active context; load the applicable Chart/Table authority in §3 and write native replacement metadata only for an independently selected native-ready object |@@ -588,9 +593,10 @@ under [`shared-standards-core.md`](../../references/shared-standards-core.md)order. Use P01 as the visual-system calibration baseline and continuedirectly through the remaining pages without a first-page checker orconfirmation stop. When a motif was-resolved, reuse it selectively and vary scale, crop, density, position, or-content interaction instead of cloning one ornament. Keep this choice only in-active context; create no planning artifact or approval stop. After every page+resolved, follow its reuse mode: exact repetition is valid for deliberate+title/corner chrome, while adaptive motifs may vary scale, crop, density,+position, or content interaction. Keep this choice only in active context;+create no planning artifact or approval stop. After every pageexists, run the one final checker below. Apply other supporting tools andstages only when their capability is actually needed.@@ -688,7 +694,7 @@ or lock.- [x] All required source/resource preparation is complete- [x] One mode and visual style were resolved, and every catalog source actually used was read-- [x] Every page considered the complete visual-carrier menu without a coverage quota+- [x] Every page considered suitable carrier combinations without a coverage quota or single-carrier assumption- [x] Image need was decided independently of credentials; any zero-image deck is backed by an explicit no-image requirement or a roster whose visual burden is fully carried by charts / native SVG- [x] Every image-bearing page made its one pre-geometry composition decision- [x] Every image decided its own source from that page's subject and job — not inherited from the resolved visual style — and every externally verifiable subject deliberately not shown as itself was stated with its reason