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(generate): add quick test SVG-to-PPTX mode
hugohe359b820c0adc4
diff --git a/AGENTS.md b/AGENTS.mdindex 21879108..33cc0450 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -13,6 +13,7 @@ PPT Master is an AI-driven presentation generation system. Multi-role collaborat- Topic-only or fact-insufficient inputs run [`topic-research`](skills/ppt-master/workflows/stages/topic-research.md) in Generate Step 1; facts only, no images.- Raw PPTX template plus new material/topic routes to [`template-fill-pptx`](skills/ppt-master/workflows/template-fill-pptx.md), not the SVG pipeline.- Raw PPTX cannot be consumed as a Generate Step 3 SVG template; run [`create-template`](skills/ppt-master/workflows/create-template.md) first and return with the generated template workspace root. Never add Master/Layout structure directly to an existing PPTX/SVG; generate new structured SVG pages from the workspace.+- Explicit disposable tests with a small fixed roster of self-contained slides may use the Generate-route [`quick-test`](skills/ppt-master/workflows/profiles/quick-test.md) profile: hand-author `svg_output/` and run the test-only direct exporter, producing no normal planning, preview, notes, validation, or backup artifacts.- PPTX beautify is a strict 1:1 main-generation [`profile`](skills/ppt-master/workflows/profiles/beautify-pptx.md), not a separate route; any split/merge/drop/reorder uses the default main-pipeline policy.- Finished PPTX native enhancement uses [`native-enhance-pptx`](skills/ppt-master/workflows/native-enhance-pptx.md) and must not enter SVG regeneration.- [`visual-review`](skills/ppt-master/workflows/stages/visual-review.md), [`customize-animations`](skills/ppt-master/workflows/stages/customize-animations.md), and [`generate-audio`](skills/ppt-master/workflows/stages/generate-audio.md) are supporting stages; their trigger rules remain explicit/conditional.diff --git a/README.md b/README.mdindex 3194181b..2dd4cc3c 100644--- a/README.md+++ b/README.md@@ -315,7 +315,7 @@ AI: Sure. Let's confirm the design spec:The AI handles everything — content analysis, visual design, SVG generation, and PPTX export.-> **Output:** The SVG pipeline has one PPTX export route: PPT Master's converter reads `svg_output/` and writes a directly editable native DrawingML deck to `exports/<name>_<timestamp>.pptx`. Step 7 still always runs `finalize_svg.py`, producing self-contained files in `svg_final/` for visual inspection or manual insertion as SVG pictures; PowerPoint's manual **Convert to Shape** command is outside the supported contract. A copy of `svg_output/` is always snapshotted to `backup/<timestamp>/svg_output/` for re-export / archival. By default charts and tables export as individually editable SVG-derived DrawingML shapes, which prioritize cross-app visual consistency. Pass `--native-charts-and-tables` to replace eligible groups with PowerPoint-native Chart/Table objects backed by data, which provide **Edit Data** and object-specific controls but may render differently across apps; this variant is saved as `exports/<name>_<timestamp>_native_charts_tables.pptx`. Both routes are editable—the distinction is the PowerPoint object model, not editability itself.+> **Output:** The SVG pipeline has one PPTX converter: it reads `svg_output/` and writes a directly editable native DrawingML deck to `exports/<name>_<timestamp>.pptx`. The normal delivery flow runs `finalize_svg.py`, produces self-contained previews in `svg_final/`, and snapshots `svg_output/` to `backup/<timestamp>/svg_output/`; PowerPoint's manual **Convert to Shape** command is outside the supported contract. Explicit disposable few-page tests may instead use [quick-test mode](./skills/ppt-master/workflows/profiles/quick-test.md), which writes only the authored SVGs and one PPTX—no planning, preview, notes, validation, or backup artifacts. By default charts and tables export as individually editable SVG-derived DrawingML shapes, which prioritize cross-app visual consistency. Pass `--native-charts-and-tables` to replace eligible groups with PowerPoint-native Chart/Table objects backed by data, which provide **Edit Data** and object-specific controls but may render differently across apps; this variant is saved as `exports/<name>_<timestamp>_native_charts_tables.pptx`. Both routes are editable—the distinction is the PowerPoint object model, not editability itself.> **Already have a `.pptx` you want to reuse?** Hand the AI that deck plus your material and ask it to "fill this deck with the new content" — it fills text, table, and chart data into your existing design and exports only the pages you pick, staying natively editable. See the [FAQ](./docs/faq.md) and [template-fill workflow](./skills/ppt-master/workflows/template-fill-pptx.md).diff --git a/README_CN.md b/README_CN.mdindex 8d324a97..eb719fef 100644--- a/README_CN.md+++ b/README_CN.md@@ -325,7 +325,7 @@ AI:好的,先确认设计规范:AI 全程处理——内容分析、视觉设计、SVG 生成、PPTX 导出。-> **输出说明:** 标准导出从 `svg_output/` 经项目转换器生成原生 DrawingML `.pptx`,保存至 `exports/<name>_<timestamp>.pptx`;这是唯一的 PPTX 产物路线,文字和图形可直接编辑。`svg_output/` 始终镜像到 `backup/<timestamp>/svg_output/`,便于归档或后续重跑。流程仍会强制生成 `svg_final/`:它是一组自包含的视觉预览 SVG,可直接打开,也可作为 SVG 图片手动插入 PowerPoint;PowerPoint 手工“转换为形状”不在支持范围。图表和表格默认导出为 SVG 派生、可逐形状编辑的 DrawingML 对象,优先保证 PowerPoint / Keynote / WPS 间的视觉一致性;加 `--native-charts-and-tables` 则把符合合同的组替换为带数据源和对象专属编辑能力的 PowerPoint 原生 Chart/Table 对象,跨软件渲染可能略有差异,保存为 `exports/<name>_<timestamp>_native_charts_tables.pptx`。两条路线都可编辑,区别在于 PowerPoint 对象模型,而不是“能否编辑”。+> **输出说明:** SVG 管线统一由项目转换器读取 `svg_output/`,生成可直接编辑的原生 DrawingML `.pptx`,保存至 `exports/<name>_<timestamp>.pptx`。正式交付流程会生成自包含预览 `svg_final/`,并把 `svg_output/` 镜像到 `backup/<timestamp>/svg_output/`;PowerPoint 手工“转换为形状”不在支持范围。明确用于临时测试的少量自包含页面可改用[快速测试模式](./skills/ppt-master/workflows/profiles/quick-test.md):只写 SVG 页面和一个 PPTX,不生成规划、预览、讲稿、验证报告或备份。图表和表格默认导出为 SVG 派生、可逐形状编辑的 DrawingML 对象,优先保证 PowerPoint / Keynote / WPS 间的视觉一致性;加 `--native-charts-and-tables` 则把符合合同的组替换为带数据源和对象专属编辑能力的 PowerPoint 原生 Chart/Table 对象,跨软件渲染可能略有差异,保存为 `exports/<name>_<timestamp>_native_charts_tables.pptx`。两条路线都可编辑,区别在于 PowerPoint 对象模型,而不是“能否编辑”。> **已有一份想复用的 `.pptx`?** 把那份 deck 连同素材给 AI,说「套模板」即可——它会把新内容(文字、表格、图表数据)填进你现有的设计,只导出你挑选的页面,且保持原生可编辑。详见 [常见问题](./docs/zh/faq.md) 与 [套模板工作流](./skills/ppt-master/workflows/template-fill-pptx.md)。diff --git a/docs/faq.md b/docs/faq.mdindex b988ae5b..6153c7ec 100644--- a/docs/faq.md+++ b/docs/faq.md@@ -77,9 +77,9 @@ Be clear on what this buys you: **web search only finds *a* relevant, downloadab## Q: Can I edit the generated presentations?-Yes. The only PPTX export route in the SVG pipeline is PPT Master's own `svg_output/` → DrawingML conversion. It saves a timestamped native PowerPoint deck to `exports/`, with text, graphics, and colors directly editable as PowerPoint objects. A copy of `svg_output/` (the Executor's raw SVG source) is always written to `backup/<timestamp>/svg_output/` so you can rebuild via `finalize_svg → svg_to_pptx` without re-running the LLM.+Yes. The only PPTX converter in the SVG pipeline is PPT Master's own `svg_output/` → DrawingML conversion. It saves a timestamped native PowerPoint deck to `exports/`, with text, graphics, and colors directly editable as PowerPoint objects. In the normal delivery flow, a copy of `svg_output/` (the Executor's raw SVG source) is written to `backup/<timestamp>/svg_output/` so you can rebuild via `finalize_svg → svg_to_pptx` without re-running the LLM.-`finalize_svg.py` remains a mandatory Step 7 operation even though native PPTX export reads `svg_output/`. It produces self-contained files in `svg_final/` for visual inspection and for manual insertion into another deck as SVG pictures. PowerPoint's manual **Convert to Shape** command is not a supported round-trip path; use the generated native PPTX when you need editable shapes.+`finalize_svg.py` remains a mandatory Step 7 operation in the normal delivery flow even though native PPTX export reads `svg_output/`. It produces self-contained files in `svg_final/` for visual inspection and for manual insertion into another deck as SVG pictures. The explicit quick-test profile skips preview and backup artifacts. PowerPoint's manual **Convert to Shape** command is not a supported round-trip path; use the generated native PPTX when you need editable shapes.## Q: Why is one paragraph split into multiple text boxes? Can I get one text box per paragraph instead?@@ -197,6 +197,19 @@ A typical 10–15 page presentation takes about **10–20 minutes** with a fastIf generation feels slow, check your model's token throughput. The bottleneck is usually the model's output speed, not the scripts.+## Q: Can I use a fast mode for a few disposable test slides?++Yes. Explicitly say that this is a **quick test** and request a small fixed+roster of self-contained slides. The Generate route then uses the+[`quick-test` profile](../skills/ppt-master/workflows/profiles/quick-test.md):+the agent hand-authors `svg_output/` and runs the test-only direct exporter.++This mode produces only the SVG pages and one PPTX. It skips source conversion,+research, Strategist/confirmation, templates, asset acquisition, Live Preview,+quality-report files, notes, `svg_final/`, backup, animation, and narration. It+is not available for normal delivery, factual/source-backed decks, external+assets, templates, native charts/tables, or reusable output.+## Q: Will long decks blow out the context window in one shot?Default recommendation: **continuous one-shot generation**. 10–15 page decks fit comfortably in a 200K window, and cross-page visual consistency is best when the Executor can see prior pages in the same session (it actively aligns style, font sizes, and rhythm).diff --git a/docs/technical-design.md b/docs/technical-design.mdindex 24bb3024..2c13da41 100644--- a/docs/technical-design.md+++ b/docs/technical-design.md@@ -253,7 +253,7 @@ Two converter design choices still shape the system:## Project Structure & Lifecycle-`project_manager.py init` creates the fixed project working directories; a later default export creates a timestamped backup directory and then attempts to copy a `backup/` snapshot. The complete lifecycle is:+`project_manager.py init` creates the fixed project working directories; a later default export creates a timestamped backup directory and then attempts to copy a `backup/` snapshot. The explicit test-only [`quick-test`](../skills/ppt-master/workflows/profiles/quick-test.md) profile bypasses that lifecycle and creates only `svg_output/` plus the PPTX destination. The normal delivery lifecycle is:| Directory | Role ||---|---|@@ -263,7 +263,7 @@ Two converter design choices still shape the system:| `icons/` | project-local icon set copied by `icon_sync.py`; global library fallback at export exists only for legacy compatibility || `templates/` | copied template specs / SVG references / non-image template assets || `svg_output/` | the only hand-authored SVG source directory |-| `svg_final/` | mandatory derived visual-preview SVGs; supported bitmap/SVG resources are inlined when possible, while EMF/WMF retain an external-reference exception; used for IDE/browser preview or manual insertion as SVG pictures |+| `svg_final/` | mandatory normal-flow derived visual-preview SVGs; supported bitmap/SVG resources are inlined when possible, while EMF/WMF retain an external-reference exception; used for IDE/browser preview or manual insertion as SVG pictures || `live_preview/` | preview server state, edit history, and annotation logs || `notes/` | `total.md` and split per-slide speaker notes || `validation/` | SVG quality reports and PPTX postflight audit reports |@@ -288,7 +288,7 @@ These invariants are stronger than ordinary implementation preferences. If a cha| Planning context is retained until invalidated | continuous execution reuses the complete Design Spec, lock, and triggered references; fresh/resumed/restarted or compacted execution reloads them once || `page-context` is on demand | the read-only projector supports diagnostics, deterministic routing checks, and optional usage telemetry; it is not a pre-page gate || `svg_output/` is the only hand-authored SVG directory | quality checks, manual edits, re-export, and `update_spec.py` target authored source |-| `svg_final/` is mandatory but derived | it is regenerated from `svg_output/` for visual preview or manual insertion as an SVG picture; supported resources are inlined when possible while EMF/WMF retain an external-reference exception, and it never becomes the native export source of truth |+| `svg_final/` is mandatory but derived in normal delivery | it is regenerated from `svg_output/` for visual preview or manual insertion as an SVG picture; supported resources are inlined when possible while EMF/WMF retain an external-reference exception, and it never becomes the native export source of truth; quick-test skips this artifact || Native PPTX export reads `svg_output/` by default | converter preserves icons, `preserveAspectRatio`, rounded rects, and native image crop metadata before finalization rewrites them || PowerPoint Convert to Shape is outside the compatibility contract | `svg_final/` may be inserted as an SVG picture, but the converted structure and visual result are not guaranteed and do not constrain the supported SVG feature set || Direct OOXML routes do not enter the SVG pipeline | preservation workflows patch native PPTX parts directly |@@ -532,7 +532,7 @@ Validation JSON files are cold audit artifacts, not routine model inputs. The exThis is easy to miss when reading the code. Shared cleanup modules, the local-reference expander, and the inline-geometry materializer are used both to write `svg_final/` and in memory during native conversion. The checker, editor, and structure parser also share parts of the geometry interpretation, but they are not artifact consumers in this section.-**Disk consumer** — `finalize_svg.py` writes `svg_output/` → `svg_final/` once per run, expanding both project icon placeholders and qualified local `<use>` references. This mandatory output feeds IDE/browser preview and may be inserted manually as an SVG picture; it is not converted into a separate PPTX artifact.+**Disk consumer** — in normal delivery, `finalize_svg.py` writes `svg_output/` → `svg_final/` once per run, expanding both project icon placeholders and qualified local `<use>` references. This mandatory normal-flow output feeds IDE/browser preview and may be inserted manually as an SVG picture; it is not converted into a separate PPTX artifact. Quick-test skips the disk consumer.**Memory consumer** — native pptx generation reads `svg_output/` directly (no disk hop). It materializes author SVG inline geometry, expands project icon placeholders, materializes geometry injected by those icons, expands qualified local `<use>` references, and finally processes positional text runs:diff --git a/docs/zh/faq.md b/docs/zh/faq.mdindex 3fbdd437..c34fde7b 100644--- a/docs/zh/faq.md+++ b/docs/zh/faq.md@@ -79,9 +79,9 @@ python3 skills/ppt-master/scripts/update_repo.py## Q: 生成的 PPT 可以编辑吗?-可以。唯一受支持的 PPTX 产物路线,是由项目转换器读取 `svg_output/` 并生成原生 DrawingML `.pptx`;文字、图形和颜色无需额外转换即可编辑,文件以时间戳命名保存至 `exports/`。Executor 的原始 SVG 源(`svg_output/` 副本)始终镜像到 `backup/<timestamp>/svg_output/`,便于归档或基于该版重跑 `finalize_svg → svg_to_pptx` 重建 PPTX,无需再走 LLM。+可以。SVG 管线统一由项目转换器读取 `svg_output/` 并生成原生 DrawingML `.pptx`;文字、图形和颜色无需额外转换即可编辑,文件以时间戳命名保存至 `exports/`。在正式交付流程中,Executor 的原始 SVG 源(`svg_output/` 副本)会镜像到 `backup/<timestamp>/svg_output/`,便于归档或基于该版重跑 `finalize_svg → svg_to_pptx` 重建 PPTX,无需再走 LLM。-Step 7 仍会强制生成 `svg_final/`。其中每页都是自包含的视觉预览 SVG,可直接在浏览器或 IDE 中打开,也可作为 SVG 图片手动插入 PowerPoint;项目只保证其作为预览或图片显示,不保证 PowerPoint 手工“转换为形状”后的结果。需要可编辑形状时,请使用 `exports/` 中由项目转换器生成的原生 PPTX。+正式交付的 Step 7 仍会强制生成 `svg_final/`。其中每页都是自包含的视觉预览 SVG,可直接在浏览器或 IDE 中打开,也可作为 SVG 图片手动插入 PowerPoint;显式快速测试会跳过预览和备份产物。项目只保证 `svg_final/` 作为预览或图片显示,不保证 PowerPoint 手工“转换为形状”后的结果。需要可编辑形状时,请使用 `exports/` 中由项目转换器生成的原生 PPTX。## Q: 为什么一段正文被拆成了好几个文本框?能不能一段一个文本框?@@ -198,6 +198,12 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a auto --animation-t如果感觉生成很慢,检查一下模型的 token 吞吐速度。瓶颈通常在模型的输出速度,而不是脚本本身。+## Q: 临时测试几页 PPT,可以走快速模式吗?++可以。请明确说明这是一次**快速测试**,并给出少量、固定、自包含的页面清单。Generate 路线会启用 [`quick-test` profile](../../skills/ppt-master/workflows/profiles/quick-test.md):AI 直接手写 `svg_output/`,随后调用测试专用的直接导出器。++该模式只产出 SVG 页面和一个 PPTX;不会做源文件转换、事实研究、策略师规划与确认、模板套用、素材获取、Live Preview、质量报告、讲稿、`svg_final/`、备份、动画或旁白。正式交付、需要事实或源文件、依赖外部素材/模板/原生图表表格,或要求复用时,仍走标准流程。+## Q: 长 PPT 一次生成会不会上下文爆掉?默认推荐**一次性连续生成**——10–15 页的 deck 在 200K 上下文窗口下完全够用,跨页视觉一致性也最好(Executor 看到前几页 SVG 后会主动对齐风格、字号、节奏)。diff --git a/skills/ppt-master/references/shared-standards-core.md b/skills/ppt-master/references/shared-standards-core.mdindex f2026642..15d483cf 100644--- a/skills/ppt-master/references/shared-standards-core.md+++ b/skills/ppt-master/references/shared-standards-core.md@@ -424,8 +424,10 @@ helper cannot write a project, select layout, or generate a page.**Authoring paint boundary**: v1 accepts `none` or six-digit solid HEX fill andstroke, optional fill/stroke opacity, stroke width, line cap, and line join.-Generated pages use `spec_lock.md` for stable semantic color anchors and choose-page-local paint from the retained Design Spec, style, and composition context;+Normal generated pages use `spec_lock.md` for stable semantic color anchors and+choose page-local paint from the retained Design Spec, style, and composition context.+The test-only [`quick-test`](../workflows/profiles/quick-test.md) profile has no+lock: keep every chosen paint value explicit in the SVG.`create-template` authored templates take their values from the confirmed briefand template `design_spec.md`.Use ordinary SVG for gradients, patterns, filters, or other treatments outside@@ -528,7 +530,7 @@ continue without modification.## 3. Canvas Format Quick Reference-Use the already locked canvas id and exact viewBox. [`canvas-formats.md`](canvas-formats.md) owns format selection; this core owns only SVG conformance on that canvas.+Use the already locked canvas id and exact viewBox. [`canvas-formats.md`](canvas-formats.md) owns format selection; this core owns only SVG conformance on that canvas. The test-only [`quick-test`](../workflows/profiles/quick-test.md) profile has no lock; its first SVG establishes the canvas and every remaining page must use the identical viewBox.---@@ -550,13 +552,15 @@ Use the already locked canvas id and exact viewBox. [`canvas-formats.md`](canvasSemantic markers are minimal compiler hints. Flat pages declare one root `data-pptx-page-role` and omit Master/Layout/layer/placeholder markers. Structured pages carry their final root identity, layer atoms, slots, and native-object metadata from authoring start and omit `data-pptx-page-role`. Use `data-pptx-role` with a stable `id` only when no specialized marker expresses page-frame behavior. Keep ordinary visible content in SVG attributes/text; [`semantic-svg.md`](semantic-svg.md) owns the vocabulary.- **Canvas authority**: New authoring writes `viewBox="0 0 W H"` with positive- integer pixels from the lock. Numerically equivalent spellings and positive+ integer pixels from the lock, or from the first SVG when the explicit+ `quick-test` profile is active. Numerically equivalent spellings and positivefractional imported dimensions remain compatible; export quantizes once at`1 SVG px = 9,525 EMU`. Invalid/non-finite values, non-zero origin,non-positive size, or unsupported PowerPoint dimensions are errors. All pages- and Layout prototypes in one build share the numeric canvas and match- `spec_lock.md canvas.viewBox`; standalone templates match `design_spec.md- canvas_viewbox`. Optional root `width`/`height` do not override `viewBox`.+ and Layout prototypes in one normal build share the numeric canvas and match+ `spec_lock.md canvas.viewBox`; quick-test pages match the first SVG;+ standalone templates match `design_spec.md canvas_viewbox`. Optional root+ `width`/`height` do not override `viewBox`.Root `<svg>` transform is forbidden; nested crop and `<symbol viewBox>` keeptheir own contracts.- **Font portability**: font families used by the deck must resolve to installed@@ -576,7 +580,7 @@ These forms are needed only when the stated PPT behavior matters:| One editable PPT text frame with mixed inline formatting or wrapped prose | Keep one logical paragraph in one `<text>`. Use non-positional `<tspan>` children for inline runs. Keep the first wrapped line as direct text and put each later line in a direct positioned `<tspan>` that repeats the parent `x` and uses positive relative `dy`; an all-`<tspan>` form may start with `dy="0"`. Same-size, evenly stacked lines flow in the current paragraph; a font-size change, list marker, or larger accepted gap starts another paragraph in that frame. Sibling `<text>` elements are forbidden as line breaks for one paragraph; they remain valid for semantically independent frames. || Stable object grouping or object-level animation anchor | Wrap the intended object in `<g id="...">`. Content grouping is **mandatory** per §4.3 — a top-level `<g id>` is also the animation anchor; it is not an optional convenience. || Native PowerPoint background promotion | Outside structured mode, the first eligible visual layer may be a direct full-canvas `<rect>` or one inside a simple single-child group. Its fill must have a registered native mapping (solid, linear/radial gradient, or preset pattern), and it must have no transform, filter, clip, rounding, or visible stroke. Export writes the fill as Slide `p:bg`; image elements remain pictures. Structured routes use the narrower explicit solid-background ownership contract in [`pptx-structure-interface.md`](./pptx-structure-interface.md). |-| Free-design / brand-only PowerPoint structure | Use `pptx_structure.mode: flat`. Keep every represented object Slide-local; export materializes one clean project-owned Master plus one Blank Layout from the current lock, removes stock content placeholders/Layout inventory, and retains only the standard date/footer/slide-number capability hooks. Do not author Master/Layout identities, layers, or placeholder slots. |+| Free-design / brand-only PowerPoint structure | Use `pptx_structure.mode: flat`. Keep every represented object Slide-local; export materializes one clean project-owned Master plus one Blank Layout from the current lock, removes stock content placeholders/Layout inventory, and retains only the standard date/footer/slide-number capability hooks. Do not author Master/Layout identities, layers, or placeholder slots. Quick-test uses the same flat object ownership but converter-default theme scaffolding because no lock exists. || Reusable template-based PowerPoint Layout | Select one complete authoring SVG per page in `page_layouts`, declare each unique Master/Layout definition once, and assign pages through `page_pptx_layouts`. Strict preserves the prototype contract; adaptive retains its Master and uses a current or new Layout key already declared and assigned by Strategist. Construction cannot extend or mutate that mapping downstream. Non-mirror skin follows `spec_lock`. |**Hard rule — supported shape conversion**: Every PPT editability claim in this specification refers to the project converter reading `svg_output/` and emitting native DrawingML. `svg_final/` is a self-contained visual preview that may be inserted into PowerPoint as an SVG picture. PowerPoint's manual Convert-to-Shape operation is unsupported; do not narrow the authoring contract to its undocumented SVG subset.@@ -640,9 +644,12 @@ separate parent content group; never put them inside the preset group itself.## 5. Workflow Authority-The serial post-processing and export workflow belongs to-[`generate-pptx.md`](../workflows/generate-pptx.md) Step 7. This file defines SVG authoring boundaries-and intentionally does not mirror commands, flags, or output behavior.+The normal serial post-processing and export workflow belongs to+[`generate-pptx.md`](../workflows/generate-pptx.md) Step 7. The explicit+test-only exception belongs to+[`quick-test.md`](../workflows/profiles/quick-test.md). This file defines SVG+authoring boundaries and intentionally does not mirror commands, flags, or+output behavior.---@@ -650,5 +657,5 @@ and intentionally does not mirror commands, flags, or output behavior.## 8. Scope BoundaryGenerate project structure, commands, quality-gate order, and export products-are owned by [`generate-pptx.md`](../workflows/generate-pptx.md). They are-intentionally outside this SVG authoring policy.+are owned by [`generate-pptx.md`](../workflows/generate-pptx.md) and its+selected profile. They are intentionally outside this SVG authoring policy.diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.mdindex 03246d65..21e9cb62 100644--- a/skills/ppt-master/scripts/docs/svg-pipeline.md+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md@@ -304,18 +304,33 @@ warning and uses `flat`; no SVG regeneration is required. A missing `spec_lock.man explicit legacy/unknown mode, or a requested `structured` export without anexplicit current structured contract remains blocking.+Disposable few-page converter/layout tests may use the explicit+[`quick-test`](../../workflows/profiles/quick-test.md) profile:++```bash+python3 scripts/svg_to_pptx.py <project_path> --quick-test+```++This test-only flag reads `svg_output/` directly, infers one consistent canvas,+uses flat converter-default package scaffolding, disables notes and motion, and+does not read or require `spec_lock.md`. It writes the PPTX only: no+`backup/`, conversion trace, or `validation/` report. ZIP integrity and Slide+count are checked in memory and reported through+`[QUICK-TEST] status=passed`. The flag rejects options that would add native+data objects, motion, narration, alternate SVG sources, or diagnostic sidecars.+For generated-project narration, follow the[`generate-audio`](../../workflows/stages/generate-audio.md) stage. It owns voiceselection, audio generation, and the narrated re-export workflow.Behavior:-- Default output (default-flow mode, no `-o`):+- Default output (normal flow, no `-o`):- `exports/<project_name>_<timestamp>.pptx` — native editable pptx (canonical output)- `validation/<project_name>_<timestamp>.report.json` — package postflight, quality-gate linkage, unresolved resource audit, and published part counts- `backup/<timestamp>/svg_output/` — copy of Executor SVG source, always written so the pptx can be rebuilt via `finalize_svg → svg_to_pptx` without re-running the LLM- `exports/` contains only final PPTX deliverables; machine-readable quality and postflight reports belong in `validation/`.-- `finalize_svg.py` always creates `svg_final/` before export. This directory is the self-contained SVG visual preview; it is not packaged as a second PPTX.-- Explicit `-o/--output` changes the native PPTX destination and skips `backup/`; its postflight report still uses the output stem under the project `validation/` directory.+- Normal flow always runs `finalize_svg.py` before export. This directory is the self-contained SVG visual preview; it is not packaged as a second PPTX. Quick-test deliberately skips it.+- In normal flow, explicit `-o/--output` changes the native PPTX destination and skips `backup/`; its postflight report still uses the output stem under the project `validation/` directory. Quick-test writes no report.- Postflight reruns ZIP integrity and published Slide count. Internal relationships,structured-package validation, transitions, and animations are enforced before thebuilder publishes the PPTX and are reported as `enforced-at-build`, not as repeated@@ -350,11 +365,11 @@ Behavior:- `[Content_Types].xml` is generated from the actual media extensions written into the PPTX. Unknown media extensions fail unless Python's `mimetypes` can identify them.- Native export writes to a temporary file first and publishes the requested PPTX only after conversion succeeds. A failed conversion does not replace the main output file.- `--conversion-trace` without a path writes `validation/<output_stem>.trace.json`. `--conversion-trace <path>` respects the explicit destination; relative paths are resolved from the project root, so `exports/<name>.trace.json` remains available when intentionally requested.-- After publication, native export writes `validation/<output_stem>.report.json`. The report distinguishes authored Slides from internal Layout definitions, reruns ZIP integrity and published Slide-count checks, records slide/layout/master/notes part counts, labels relationship/structured/transition/animation validation as enforced at build time, links the final SVG quality report only when its SHA-256 source fingerprint matches the exact export inputs, and surfaces stale/unverified gates, unresolved template tokens, generic-only font stacks, and external image references. A matching final quality report with introduced warnings yields `passed-with-warnings` and a `quality_introduced_warnings=<N>` receipt instead of a clean `passed` claim.+- After normal-flow publication, native export writes `validation/<output_stem>.report.json`. The report distinguishes authored Slides from internal Layout definitions, reruns ZIP integrity and published Slide-count checks, records slide/layout/master/notes part counts, labels relationship/structured/transition/animation validation as enforced at build time, links the final SVG quality report only when its SHA-256 source fingerprint matches the exact export inputs, and surfaces stale/unverified gates, unresolved template tokens, generic-only font stacks, and external image references. A matching final quality report with introduced warnings yields `passed-with-warnings` and a `quality_introduced_warnings=<N>` receipt instead of a clean `passed` claim.- By default, a successful command also prints a compact receipt instead of requiring a report read: `[POSTFLIGHT] status=<...> quality_gate=<...> slides=<N> warning_categories=<N>`, followed by one compact line per warning category and the `[PPTX]` / `[REPORT]` paths. Resource-warning lines carry counts; a non-passing quality gate carries its status. Routine agents use this receipt and do not load either complete validation JSON into model context. Full reports remain cold audit artifacts; failure investigation and explicit audits extract only the required fields. `--quiet` keeps suppressing successful-run output.- Before publishing structured template output, export reopens the temporary PPTX and validates the Slide → Layout → Master graph and registrations, Layout identity, placeholder identity, reusable bounds, and prompt/level-one sizes. A mismatch aborts publication. Flat release instead validates its single referenced Master/Layout shell and exact date/footer/slide-number hook roster before packaging.- SVG clip paths are still restricted for authored SVGs, but nested crop wrappers generated by PPTX import are mapped back to native picture crop / geometry when possible.-- Speaker notes are embedded automatically unless `--no-notes` is used+- Normal flow embeds speaker notes automatically unless `--no-notes` is used; quick-test always disables them- Recorded narration is opt-in:- `notes_to_audio.py` uses `edge-tts` by default, or a configured cloud TTS provider (`elevenlabs`, `minimax`, `qwen`, `cosyvoice`), and generates one audio file per slide into `audio/`- Narration text is read strictly from the matching `notes/*.md` file; the script only skips Markdown heading lines (`# ...`) and does not summarize, rewrite, or filter delivery notesdiff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.pyindex 0a276c91..b296d732 100644--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py@@ -469,6 +469,30 @@ def _print_postflight_receipt(receipt: _PostflightReceipt) -> None:print(f' [REPORT] {receipt.report_path}')+def _validate_quick_test_output(+ output_path: Path,+ *,+ expected_slide_count: int,+) -> dict[str, object]:+ """Validate a quick-test PPTX without writing a report sidecar."""+ try:+ package = _package_part_counts(output_path)+ except (OSError, zipfile.BadZipFile) as exc:+ raise PptxPostflightValidationError(+ f"quick-test PPTX is not a readable ZIP package: {exc}"+ ) from exc+ if package['zip_integrity'] != 'passed':+ raise PptxPostflightValidationError(+ f"quick-test PPTX ZIP integrity failed at {package['corrupt_member']}"+ )+ if package['slides'] != expected_slide_count:+ raise PptxPostflightValidationError(+ "Quick-test Slide count does not match authored SVG count: "+ f"{package['slides']} != {expected_slide_count}"+ )+ return package++def _declared_pptx_structure_mode(project_path: Path) -> str | None:"""Return the explicitly locked SVG export mode, if the lock declares one."""lock_path = project_path / 'spec_lock.md'@@ -666,6 +690,7 @@ def main(argv: list[str] | None = None) -> int:Examples:%(prog)s examples/ppt169_demo # Default: native pptx -> exports/, svg_output -> backup/<ts>/%(prog)s examples/ppt169_demo -o out.pptx # Explicit path (no backup/)+ %(prog)s projects/_smoke_quick --quick-test # Test-only: svg_output/ -> PPTX, no sidecars# Disable transition / change transition effect%(prog)s examples/ppt169_demo -t none@@ -740,6 +765,17 @@ Recorded narration:choices=list(CANVAS_FORMATS.keys()), default=None,help='Require SVG canvases to match this registered format')parser.add_argument('-q', '--quiet', action='store_true', help='Quiet mode')+ parser.add_argument(+ '--quick-test',+ action='store_true',+ help=(+ 'Test-only direct export of a small fixed SVG roster from '+ 'svg_output/. Infer one consistent canvas from the SVGs, use a flat '+ 'package with converter defaults, and skip spec_lock.md, notes, '+ 'animations, backup, conversion trace, and validation report '+ 'artifacts.'+ ),+ )merge_group = parser.add_mutually_exclusive_group()merge_group.add_argument('--merge-paragraphs', action='store_true', dest='merge_paragraphs',@@ -906,6 +942,49 @@ Recorded narration:file=sys.stderr,)+ if args.quick_test:+ conflicts: list[str] = []+ if args.source not in {None, 'output'}:+ conflicts.append('--source must be omitted or output')+ if args.pptx_structure not in {None, 'flat'}:+ conflicts.append('--pptx-structure must be omitted or flat')+ if args.conversion_trace is not None:+ conflicts.append('--conversion-trace')+ if args.native_objects:+ conflicts.append('--native-charts-and-tables')+ if args.animation_config:+ conflicts.append('--animation-config')+ if args.recorded_narration:+ conflicts.append('--recorded-narration')+ if args.narration_audio_dir:+ conflicts.append('--narration-audio-dir')+ if args.use_narration_timings:+ conflicts.append('--use-narration-timings')+ if args.auto_advance is not None:+ conflicts.append('--auto-advance')+ if args.transition is not None or args.transition_duration is not None:+ conflicts.append('transition overrides')+ if any(+ value is not None+ for value in (+ args.animation,+ args.animation_duration,+ args.animation_trigger,+ args.animation_stagger,+ )+ ):+ conflicts.append('animation overrides')+ if conflicts:+ print(+ "Error: --quick-test cannot be combined with: "+ + ", ".join(conflicts),+ file=sys.stderr,+ )+ return 1+ args.no_notes = True+ args.no_animations = True+ args.pptx_structure = 'flat'+project_path = Path(args.project_path)if not project_path.exists():print(f"Error: Path does not exist: {project_path}")@@ -915,13 +994,17 @@ Recorded narration:native_structure_contract = Nonepptx_structure = args.pptx_structurelock_path = project_path / 'spec_lock.md'- if not lock_path.is_file():+ if not args.quick_test and not lock_path.is_file():print("Error: spec_lock.md is required for release SVG export",file=sys.stderr,)return 1- declared_structure_mode = _declared_pptx_structure_mode(project_path)+ declared_structure_mode = (+ None+ if args.quick_test+ else _declared_pptx_structure_mode(project_path)+ )if pptx_structure in _LEGACY_PPTX_STRUCTURE_MODES:_print_structure_contract_error(pptx_structure)return 1@@ -968,7 +1051,7 @@ Recorded narration:theme_font_spec = Nonemaster_text_style_spec = Nonetheme_color_spec = None- if pptx_structure in {'flat', 'structured'}:+ if pptx_structure in {'flat', 'structured'} and not args.quick_test:try:theme_font_spec = load_theme_font_spec(project_path)master_text_style_spec = load_master_text_style_spec(project_path)@@ -1008,8 +1091,12 @@ Recorded narration:project_name = project_path.namecanvas_format = args.format- expected_viewbox = _declared_canvas_viewbox(project_path)- if expected_viewbox is None:+ expected_viewbox = (+ None+ if args.quick_test+ else _declared_canvas_viewbox(project_path)+ )+ if expected_viewbox is None and not args.quick_test:print("Error: spec_lock.md must contain canvas.viewBox for release export",file=sys.stderr,@@ -1140,7 +1227,8 @@ Recorded narration:narrated_tag = "_narrated" if (args.recorded_narration or args.narration_audio_dir) else ""native_path = exports_dir / f"{project_name}_{timestamp}{native_tag}{narrated_tag}.pptx"# Preserve the authored svg_output/ beside every default-flow export.- backup_dir = project_path / "backup" / timestamp+ if not args.quick_test:+ backup_dir = project_path / "backup" / timestampnative_path.parent.mkdir(parents=True, exist_ok=True)@@ -1445,7 +1533,7 @@ Recorded narration:# are still stamped at export; only the authored fields stay blank.doc_metadata = Nonemetadata_path = project_path / 'metadata.json'- if metadata_path.is_file():+ if metadata_path.is_file() and not args.quick_test:try:loaded = json.loads(metadata_path.read_text(encoding='utf-8'))except (json.JSONDecodeError, OSError) as exc:@@ -1569,6 +1657,31 @@ Recorded narration:print(f" [info] svg_output/ not found, backup skipped")if success:+ if args.quick_test:+ try:+ package = _validate_quick_test_output(+ native_path,+ expected_slide_count=len(native_files),+ )+ except PptxPostflightValidationError as exc:+ print(+ "Error: quick-test PPTX failed in-memory validation and "+ f"must not be used: {exc}",+ file=sys.stderr,+ )+ print(+ f" Invalid output remains at: {native_path}",+ file=sys.stderr,+ )+ return 1+ if verbose:+ print(+ " [QUICK-TEST] "+ f"status=passed slides={package['slides']} "+ "sidecars=none"+ )+ print(f" [PPTX] {native_path}")+ return 0try:receipt = _write_postflight_report(output_path=native_path,diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.mdindex be17a582..ae57a454 100644--- a/skills/ppt-master/workflows/generate-pptx.md+++ b/skills/ppt-master/workflows/generate-pptx.md@@ -6,7 +6,7 @@ description: Generate PPTX route authority for source intake, planning, SVG auth> Load only after [`routing.md`](./routing.md) selects Generate PPTX. This file owns the route's Step 1–7 sequence, gates, role switching, and mandatory commands.-**Core Pipeline**: `Initial Materials → [Fact Research] → Create Project → [Template] → Strategist Structured Plan → [Image Acquisition] → Executor Live Preview → Quality Check → Post-processing → Export`+**Default Core Pipeline**: `Initial Materials → [Fact Research] → Create Project → [Template] → Strategist Structured Plan → [Image Acquisition] → Executor Live Preview → Quality Check → Post-processing → Export`**Generate-specific execution discipline**:@@ -15,6 +15,18 @@ description: Generate PPTX route authority for source intake, planning, SVG auth- `preset_shape_svg.py` and `shape_boolean_svg.py` may provide only their documented stdout fragment(s) after the main agent chooses the object's role, operands, paint, and z-order; neither helper chooses layout or writes a page.- Gate checklists are internal verification, not user-facing output. On success, continue automatically and emit at most one compact status line when useful; on failure, report only the blocking items and required recovery.+### Quick Test Profile Short Circuit++When the user explicitly requests quick/fast mode for a disposable test with a+small fixed roster of self-contained slides, load and follow+[`quick-test.md`](./profiles/quick-test.md). That profile owns the complete+test-only sequence and skips this route's Steps 1–7.++**Hard rule — no implicit downgrade**: page count alone never selects quick+test. Normal delivery, source conversion, factual research, template use,+external assets, native data objects, notes, animation, narration, and reusable+output remain on the default pipeline below.+### SVG Page-Design Boundary| Scope | Contract |@@ -22,7 +34,7 @@ description: Generate PPTX route authority for source intake, planning, SVG auth| Any route that authors or regenerates slide visuals through SVG | `svg_output/` is the complete page-design source: every visible text, image, shape, chart/table fallback, and layout element that should appear on the exported slide is present in that page SVG or referenced by it. || Templates, `design_spec.md`, and `spec_lock.md` | Authoring/control inputs. They guide SVG creation but MUST NOT supply visible slide content that is absent from the completed SVG during export. || Semantic SVG markers | Minimal rendering-neutral compiler hints used only after existing Layout/Layer/Placeholder/Native metadata has been considered. They never replace native SVG geometry, text, styles, grouping, or asset references. |-| `svg_final/` | Mandatory derived, self-contained SVG visual preview. It may be opened directly or inserted into PowerPoint as an SVG picture, but it is not a supported PPTX source and carries no manual Convert-to-Shape compatibility contract. |+| `svg_final/` | Mandatory derived, self-contained SVG visual preview in the default pipeline. It may be opened directly or inserted into PowerPoint as an SVG picture, but it is not a supported PPTX source and carries no manual Convert-to-Shape compatibility contract. Quick-test skips it. || SVG-to-PPTX export | The only supported generated-PPTX route reads `svg_output/` and maps its content through the project converter to DrawingML/native objects. It compiles only the selected route's explicit structure contract: `flat` keeps represented content Slide-local, while `structured` may place explicitly scoped content in Master/Layout/Slide parts. It MUST NOT infer structure, upgrade `flat`, or invent new visible page content. || Native PPTX routes and presentation-behavior stages | Remain outside SVG page-design closure. `template-fill-pptx`, `native-enhance-pptx`, animations, transitions, speaker notes, narration, and package relationships are not required to round-trip through SVG. |@@ -146,7 +158,7 @@ Bare names, style descriptions, brand mentions, vague template intent, and silen----### Step 4: Strategist Phase (MANDATORY — cannot be skipped)+### Step 4: Strategist Phase (MANDATORY in the default pipeline)🚧 **GATE**: Step 3 complete; default free-design path taken, or (if triggered) template files copied or confirmed in place in the project.diff --git a/skills/ppt-master/workflows/profiles/quick-test.md b/skills/ppt-master/workflows/profiles/quick-test.mdnew file mode 100644index 00000000..a14df386--- /dev/null+++ b/skills/ppt-master/workflows/profiles/quick-test.md@@ -0,0 +1,105 @@+---+description: Test-only Generate profile for authoring a few SVG slides and exporting one PPTX without normal planning or sidecar artifacts.+---++# Quick Test Profile++> Generate-PPTX profile, not a top-level route. Use it only for disposable+> converter/layout tests; normal presentation delivery stays on+> [`generate-pptx.md`](../generate-pptx.md) Steps 1–7.++**Trigger**: the user explicitly requests quick/fast test mode, identifies the+deck as a test, and asks for a small fixed slide roster. A small page count alone+never activates this profile.++---++## 1. Eligibility++| Condition | Required state |+|---|---|+| Intent | Explicit disposable test, not a presentation delivery |+| Page roster | Small, fixed, and named or directly inferable |+| Content | Supplied in chat and sufficient to draw without conversion or research |+| Visual inputs | Plain SVG geometry/text, or already supplied self-contained data; no asset acquisition |+| Output | Only authored SVG pages and one native PPTX |++**Missing eligibility** → use the normal Generate pipeline. Do not ask the user+to weaken a normal delivery request so it can enter this profile.++**Hard rule — explicit scope only**: this profile never activates for a factual+deck, a template-backed deck, source-file conversion, native charts/tables,+external images/icons/fonts, speaker notes, animation, narration, visual+review, or any reusable deliverable.++---++## 2. Minimal Authoring Contract++Read only [`shared-standards-core.md`](../../references/shared-standards-core.md).+Load one of its conditional modules only when the user's exact SVG test needs+that registered feature; otherwise keep the SVG surface to solid paint, basic+geometry, text, and semantic groups.++Create only:++```text+<project_path>/+├── svg_output/+│ └── <ordered-page>.svg+└── exports/+ └── <project_name>_<timestamp>.pptx+```++**Hard rule — no normal-pipeline artifacts**: do not run source conversion,+`project_manager.py init`, topic research, template application, Strategist,+Confirm UI, image/icon acquisition, Live Preview, SVG quality checker,+speaker-note generation, `finalize_svg.py`, chart verification, animation,+narration, or any supporting stage. Do not create `design_spec.md`,+`spec_lock.md`, `sources/`, `analysis/`, `images/`, `icons/`, `templates/`,+`confirm_ui/`, `notes/`, `svg_final/`, `validation/`, `backup/`, or metadata+sidecars.++**Canvas**: write `viewBox="0 0 W H"` on every page. The first SVG establishes+the test canvas; every remaining page must match it exactly.++**Structure**: author flat, Slide-local SVG only. Include the complete visible+page in each SVG; set one root `data-pptx-page-role` from `cover`, `toc`,+`section`, `content`, or `ending`, and omit Master/Layout/layer/placeholder+metadata.++**Typography**: name an installed concrete font family in the SVG; do not depend+on a lock or generated font asset.++**Generation pacing**: the current main agent hand-writes the fixed SVG roster+in order. Skip the normal first-page and final checker gates.++---++## 3. Direct Export++Run one export command after every requested SVG exists:++```bash+python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path> --quick-test+```++`--quick-test` reads only `svg_output/`, infers one consistent canvas, uses a+flat PowerPoint package with converter defaults, disables notes and motion,+skips lock/theme sidecars, and writes no backup, conversion trace, or validation+report. An explicit `-o <path>.pptx` may replace the default `exports/`+destination without changing the artifact boundary.++**Validation**: success requires `[QUICK-TEST] status=passed`, the authored SVG+count to equal the published Slide count, and the PPTX to pass in-memory ZIP+integrity. On failure, repair the owning SVG and rerun this command; do not+create planning or validation artifacts.++```markdown+## ✅ Quick Test Complete++- [x] Requested SVG pages exist under `svg_output/`+- [x] One native PPTX exists under `exports/` or the explicit output path+- [x] No normal-pipeline artifacts were created+- [ ] **Next**: Report the PPTX path+```diff --git a/skills/ppt-master/workflows/routing.md b/skills/ppt-master/workflows/routing.mdindex 40371439..eeff3437 100644--- a/skills/ppt-master/workflows/routing.md+++ b/skills/ppt-master/workflows/routing.md@@ -30,7 +30,7 @@ route selection. After selection, the route authority owns execution.| Route | Request shape | Authority | Preconditions | Mutation model | Output contract ||---|---|---|---|---|---|-| Generate PPTX | Create a new presentation; regenerate an existing deck visually; use source material or a topic; optionally apply an explicit template workspace | [`generate-pptx`](./generate-pptx.md) | Source facts exist or the topic-research stage can gather them | Author new SVG pages and export a new PPTX | New project with `design_spec.md`, `spec_lock.md`, `svg_output/`, `validation/`, and `exports/` |+| Generate PPTX | Create a new presentation; regenerate an existing deck visually; use source material or a topic; optionally apply an explicit template workspace | [`generate-pptx`](./generate-pptx.md) | Source facts exist or the topic-research stage can gather them; explicit `quick-test` supplies self-contained test content | Author new SVG pages and export a new PPTX | Default pipeline: project with `design_spec.md`, `spec_lock.md`, `svg_output/`, `validation/`, and `exports/`; explicit `quick-test`: only `svg_output/` plus one PPTX || Create Template | Create a reusable brand/layout/deck template from one or more PPTX/SVG files, images/PDFs, direct or file-based text, documents/websites, brand assets, or a mixed reference bundle | [`create-template`](./create-template.md) | A reusable-template request exists; reference material is optional, and project scope additionally requires an initialized target project | Author a new portable workspace; never modify any reference file in place | Workspace with required `templates/`, optional `images/` / `icons/`, and optional review `exports/` || Fill Native PPTX | Use a raw PPTX's native slide shells and replace/fill content | [`template-fill-pptx`](./template-fill-pptx.md) | Source PPTX plus new material/topic | Clone and patch PPTX through OOXML; no SVG pipeline | New filled PPTX in project `exports/` || Enhance Native PPTX | Keep a finished PPTX's visible slides stable while adding notes, audio, timings, or transitions | [`native-enhance-pptx`](./native-enhance-pptx.md) | Finished source PPTX exists | Append/update scoped OOXML parts; no slide regeneration | New enhanced PPTX in project `exports/` |@@ -41,6 +41,7 @@ route selection. After selection, the route authority owns execution.| Request condition | Generate-route behavior ||---|---|+| Explicit disposable test intent + explicit quick/fast mode + small fixed roster of self-contained slides | Activate [`quick-test`](./profiles/quick-test.md) inside Generate PPTX; author SVG pages and run the test-only direct exporter without entering normal Steps 1–7 || Topic only, or supplied sources leave planning-critical factual gaps | Run [`topic-research`](./stages/topic-research.md) inside [`generate-pptx`](./generate-pptx.md) Step 1: immediately for topic-only input, or after conversion and reading for source-backed input; research only the identified gaps, then continue Step 2 || Existing PPTX may be split, merged, dropped, reordered, or re-outlined | Treat the PPTX as source content through [`generate-pptx`](./generate-pptx.md) Step 1 and its PPTX intake; use the default Generate pipeline || Existing PPTX must preserve wording, page count, and page order 1:1 | Activate the [`beautify-pptx`](./profiles/beautify-pptx.md) profile inside the main pipeline |@@ -57,6 +58,12 @@ route selection. After selection, the route authority owns execution.**Hard rule — profile, not fifth route**: The 1:1 beautify behavior uses the same Strategist → Executor → SVG export lifecycle as Generate PPTX. It changes content/page invariants; it does not define a separate artifact lifecycle.+**Hard rule — test profile, not a release shortcut**: `quick-test` stays inside+Generate PPTX but owns a test-only SVG → PPTX short circuit. A small page count+alone never activates it, and any reusable, factual, source-backed,+template-backed, asset-dependent, or package-behavior request stays on the+normal Generate pipeline.+---## 4. Template and Master/Layout Boundary