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
prompts: Stage 1 keeps the goal, not a template blackout; Create Template gains a prototype review round; slot fit is checked before the typography lock; Quick names the typed-slot export flag
hugohe36627d92bc9e8
diff --git a/AGENTS.md b/AGENTS.mdindex 7b976bbe..488086a7 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -22,7 +22,7 @@ PPT Master turns source material into natively editable DrawingML PPTX. Generate**Route selection authority**: [`skills/ppt-master/workflows/routing.md`](skills/ppt-master/workflows/routing.md) owns the three top-level artifact routes: Generate PPTX, Create Template, and Edit Native PPTX. Child workflows, profiles, stages, and governance documents refine one selected route; they are not competing top-level routes.- Topic-only or fact-insufficient inputs run [`topic-research`](skills/ppt-master/workflows/stages/topic-research.md) inside the selected Generate profile's source intake; its facts URLs are not auto-expanded. After normal image search fails, one relevant webpage may be fetched as a source package and only reviewed selections enter the runtime image pool.-- Default Generate prepares template candidates internally in Step 3, then confirms the communication contract and free-design/template choice together in Stage 1. Template content stays unread until that confirmation; selected roots are installed before template-aware Stage 2. Quick skips this interaction.+- Default Generate prepares template candidates internally in Step 3, then confirms the communication contract and free-design/template choice together in Stage 1. A template never rewrites the confirmed communication contract; selected roots are installed before template-aware Stage 2. Quick skips this interaction.- Raw PPTX template plus new material/topic routes to [`edit-native-pptx`](skills/ppt-master/workflows/edit-native-pptx.md): a `pptx_to_svg.py --roundtrip` workspace where unchanged pages are referenced byte-for-byte and only planned pages are edited; it never enters Generate.- Raw PPTX cannot be consumed as a Generate template workspace; run [`create-template`](skills/ppt-master/workflows/create-template.md) first and return with the generated workspace root as a Stage-1 candidate. Never add Master/Layout structure directly to an existing PPTX/SVG; generate new structured SVG pages from the workspace.- Explicit quick/fast or skip-strategy generation uses [`quick-generate`](skills/ppt-master/workflows/profiles/quick-generate.md): prepare sources/resources as needed, decide without interaction, omit Strategist/confirmation/spec/lock, hand-author `svg_output/`, pass its lockless final checker, and export.diff --git a/docs/rules/rule-owners.md b/docs/rules/rule-owners.mdindex 6b702740..e53d04bc 100644--- a/docs/rules/rule-owners.md+++ b/docs/rules/rule-owners.md@@ -26,7 +26,7 @@| ID | Rule (one line) | Owner | Pointer only ||---|---|---|---|| R20 | Three-direction construction: author three whole-solution intents first, freeze every basis id from the three indexes, read once only the deduplicated detail files, a novel custom reads none | `references/strategist.md` §d Hard rule | `references/strategist.md` §1 first paragraph, Layer 1 / Layer 2 GATEs, §2; `workflows/generate-pptx.md` Step 4; `references/modes/_index.md` §1/§3, `references/visual-styles/_index.md` §1/§4, `references/image-renderings/_index.md` §1 |-| R21 | Stage 1 is template-independent: authored from request, sources, and initialization only; no candidate, index, spec, or prototype is evidence | `workflows/generate-pptx.md` Step 4 | `references/strategist.md` §1, `references/strategist-template.md` §1, `references/confirm-surface.md` §2, `scripts/docs/confirm_ui.md` |+| R21 | A template never rewrites the Stage-1 goal: audience, intent, outcome, message, delivery, and afterlife come from request, sources, and initialization; template facts in context may inform canvas and page range only | `workflows/generate-pptx.md` Step 4 | `references/strategist.md` §1, `references/strategist-template.md` §1, `references/confirm-surface.md` §2, `scripts/docs/confirm_ui.md` || R22 | Template discovery reads only the four `*_index.json` files; never scan kind directories; a bare name never resolves to a path; one root per kind, Layout precedes Deck | `workflows/routing.md` §7 | `workflows/generate-pptx.md` Step 3, `workflows/stages/apply-template-workspace.md` §1, `templates/README.md`, the four kind READMEs, `references/artifact-ownership.md`, `references/strategist-template.md` || R23 | Resource need is decided while composing the roster: which pages need a prepared image, lettering, or illustrated-icon file; the carrier mix itself is never planned | `references/plan-core.md` §5 | `references/strategist.md` Resource Need and Reference Planning (Design Spec handoff only), `workflows/profiles/quick-generate.md` §2, `references/strategist-image.md` §1 || R24 | Whole-roster rhythm check: neighbors and section arcs compared, chapter entries reset, same-density runs intentional, motif carries a continuity job | `references/plan-core.md` §4 | `references/strategist.md` §6.2, `workflows/profiles/quick-generate.md` §2 |diff --git a/docs/technical-design.md b/docs/technical-design.mdindex 8909f3b9..fd7ebb6c 100644--- a/docs/technical-design.md+++ b/docs/technical-design.md@@ -83,7 +83,7 @@ User Input (PDF/DOCX/XLSX/PPTX/URL/Markdown/topic text)├── If canonical same-stem Markdown is absent, run ppt_to_md.py against that archived PPTX└── Content-type files in sources/ become the content contract↓-[Template Candidate Preparation (Step 3)] — internal only; no UI, wait, selection, template read, or installation+[Template Candidate Preparation (Step 3)] — internal only; no UI, wait, selection, or installationPrepare indexed Brand/Style/Layout/Deck candidates and supplied exact rootsStage 1 confirms communication plus free design/template use together; selected workspaces are then validated and installed before Stage 2↓@@ -406,8 +406,8 @@ The architectural choice worth flagging: **viewBox is in pixels, not absolute un## Template System & SelectionTemplate use is **opt-in, not inferred**. Default Step 3 only prepares-candidates; it never opens UI or reads template content. Stage 1 displays its-template-independent communication recommendation together with a switchable+candidates; it never opens UI or installs template content. Stage 1 displays its+communication recommendation together with a switchablefree-design/template choice. Ordinary requests default to free design; explicittemplate intent or any supplied root defaults to template mode. Exactly one rootmay be preselected, while multiple roots remain unselected candidates. Thediff --git a/docs/templates-guide.md b/docs/templates-guide.mdindex 3cf72429..819bce37 100644--- a/docs/templates-guide.md+++ b/docs/templates-guide.md@@ -53,7 +53,7 @@ The two rules that prevent most mistakes:### How selection worksDefault Generate places template selection inside **Stage 1**, beside the-template-independent communication contract. The page first shows switchable+communication contract. The page first shows switchableFree design / Use templates choices. Ordinary requests initialize Free designand keep the detailed selectors collapsed. Explicit template intent or anyexact workspace root initializes Use templates and expands the registereddiff --git a/skills/ppt-master/references/artifact-ownership.md b/skills/ppt-master/references/artifact-ownership.mdindex 921775a2..b9ea93bd 100644--- a/skills/ppt-master/references/artifact-ownership.md+++ b/skills/ppt-master/references/artifact-ownership.md@@ -41,7 +41,7 @@ Global artifact ownership rules for PPT Master projects. A selected route or pro| `<import_workspace>/authoring-svg-flat/` | Optional verification IR | Self-contained page composition with its own summary/manifest | Generated only from an explicitly requested `svg-flat/`; verification only || `<import_workspace>/icons/imported/` | Imported vector pool | One canonical copy of every factored vector subtree | Referenced as `data-icon="imported/<name>"`; inventories retain source refs || `confirm_ui/template_options.json`, `template_selection.json`, `template_handoff.json` | Default UI template-selection sidecar | Agent-authored candidates, user-confirmed selection beside the Stage-1 result, installation/free-design handoff | Step 3 writes options without launching UI; the Stage-1 submission writes `template_selection.json`; `--complete-template-selection` writes the handoff; Stage 2 is exposed only after that handoff and a fresh recommendation. Chat/delegated flows keep equivalent state without fabricating receipts; Quick creates none |-| `confirm_ui/recommendations.stage1.json`, `.stage2.json` | Confirmation proposals | Template-independent communication contract, then template-aware complete solution plus production mechanics | Stage 1 is authored without candidate indexes or workspaces as evidence and confirms communication plus template mode/selection in one submission; Stage 2 is created only after installation or free-design closure; `template_application` decides only how to use installed state; only the active unconfirmed stage may be overwritten |+| `confirm_ui/recommendations.stage1.json`, `.stage2.json` | Confirmation proposals | Template-independent communication contract, then template-aware complete solution plus production mechanics | Stage 1 is authored so that no candidate rewrites the communication contract and confirms communication plus template mode/selection in one submission; Stage 2 is created only after installation or free-design closure; `template_application` decides only how to use installed state; only the active unconfirmed stage may be overwritten || `confirm_ui/result.json` | Confirmation result | Persisted user-confirmed evidence | Step 4 reads the final object once; Strategist consumes it completely into `design_spec.md`; downstream never reopens it except a fresh recovery with no retained state || `svg_output/` | Page-design author source | Handwritten SVG pages containing the complete visible design, including formula markers | Canonical source for the checker and native export; templates and locks never add missing visible objects at export || `notes/total.md`, `notes/slide_*.md` | Conditional speaker-note source / split notes | Complete notes; per-slide split by `total_md_split.py` | Written only when Speaker Notes is enabled; Step 7.1 or Quick §4 splits |diff --git a/skills/ppt-master/references/executor-structured.md b/skills/ppt-master/references/executor-structured.mdindex 4f8c3790..d23add97 100644--- a/skills/ppt-master/references/executor-structured.md+++ b/skills/ppt-master/references/executor-structured.md@@ -14,7 +14,7 @@ Conditional Executor authority for `template_reuse_scope: mirror|layout` with `p| Context | Load policy ||---|---|-| `templates/design_spec.md` | Reuse in a valid context; after invalidation read it once with the planning artifacts |+| Installed `templates/design_spec.<kind>.<id>.md` files | Every installed spec, segments owned per [`apply-template-workspace.md`](../workflows/stages/apply-template-workspace.md) §5; reuse in a valid context and after invalidation read them once with the planning artifacts || Current page mapping | The retained `spec_lock.md page_layouts` row; a page change needs no file load || Selected prototype SVG | Read the complete `templates/<basename>.svg` once per valid context and reuse it until a known change |diff --git a/skills/ppt-master/references/strategist-template.md b/skills/ppt-master/references/strategist-template.mdindex 1b9a4c3d..5af3165e 100644--- a/skills/ppt-master/references/strategist-template.md+++ b/skills/ppt-master/references/strategist-template.md@@ -12,7 +12,7 @@ Conditional extension for applying an installed Brand/Style/Layout/Deck workspac**Inputs**: every installed `<project_path>/templates/design_spec.<kind>.<id>.md` is a template-design source; read all of them. A `design_spec.style.*.md` file marks an active Direction / method segment. A legacy or incomplete Layout/Deck is rejected under [`pptx-structure-interface.md`](./pptx-structure-interface.md) §3; never mutate the input.-**Hard rule — no Stage-1 influence**: never revise a confirmed Stage 1 to match the workspace (Stage-1 evidence boundary: [`generate-pptx.md`](../workflows/generate-pptx.md) Step 4).+**Hard rule — no Stage-1 influence**: never revise a confirmed Stage 1 to match the workspace (Stage-1 goal boundary: [`generate-pptx.md`](../workflows/generate-pptx.md) Step 4).**Outputs**:@@ -72,7 +72,7 @@ A Style installed alongside Layout/Deck changes only Direction / method and neve- **Master roster**: one `pptx_masters` row per Master as `<master_key>: <picker name>`, copied from the workspace roster. Keys are 1–64 ASCII letters/digits/dots/underscores/hyphens starting with a letter or digit; spaces belong only in the picker name. Master visuals are root-level atoms, never `<g>`.- **Reusable Layout roster**: every unique Layout once as `<layout_key>: <master_key> | <PowerPoint layout name> | <prototype source>`. Each installed `template:<basename>` is a complete Slide prototype, including ones not selected for this deck; a new adaptive Layout uses its first generated `P<NN>`. Reuse a key only when fixed atoms and slot ids/types/indices/bounds/binding modes are identical. Name authored keys after composition, never page topic. Zero-slot Layouts are valid; do not manufacture an empty `utility` kind or a full-page fake slot.- **Page assignment**: exactly one `page_pptx_layouts` row per page; each key must exist in `pptx_layouts`. Check that distinct compositions do not collapse into role-only keys and that one skeleton does not split into topic-specific keys.-- **Slot planning**: each reusable slot is a direct root `<g id>` with `data-pptx-placeholder`, positive design-zone bounds from the safe area, column, panel inset, or media frame — not sample text ink — and exactly one compatible direct carrier. A genuinely composite region uses only the explicit `object` + `proxy` downgrade.+- **Slot fit**: before locking a typography role, check each page's planned content against its selected prototype's slot bounds with that role's family and anchor size (`text_measure.py`); when it does not fit, change the expression, pick another prototype, or declare an adaptive Layout — never drop a reusable slot's role below its band or widen the slot in Executor. Slot syntax and the `object` + `proxy` downgrade are [`pptx-structure-interface.md`](./pptx-structure-interface.md) §2.- **Adaptive refinement**: initial definitions are complete. If construction shows that reusable framing or slot topology/bounds must change, return to Strategist to add a definition sourced from that page and update its assignment before execution resumes. Executor never mutates the contract; export only compiles declared structure.- **Input prototypes**: one `page_layouts` row per page using a complete Slide prototype. Strict preserves that SVG's contract; adaptive keeps its Master and may declare a new output Layout. Mirror preserves authored visuals and text-node topology; a JSON-first Chart/Table may regenerate only its derived preview children.diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex 0d092da1..1340ceb6 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -35,7 +35,7 @@ Canvas formats and their typography scale start: [`canvas-formats.md`](canvas-fo**Default — continuity-aware whole solution (may override when a scene reset communicates better)**: before recommending page count or production mechanics, judge whether adjacent beats can stay within one recognizable mental map while a visible state changes. Where that lowers cognitive switching and motion has a named job, let it shape the spine, rhythm, visual approach, and notes/narration segmentation, and recommend `proactive_custom_animations: true`. Plan such neighbors as visible states of one scene: recognizable anchors kept, the delta legible, each enabled notes/narration segment aligned with its state, every state page still carrying content and an `Audience move`. Reset when the map changes or continuity adds nothing. One positive signal, not the only one: topic or wording repetition alone is insufficient, and a `Motion suggestion` never changes the effective outcome.-**Hard rule — Stage-1 source boundary**: the evidence Stage 1 may use is fixed by [`generate-pptx.md`](../workflows/generate-pptx.md) Step 4; template controls on the same surface are confirmation state, not evidence. Load [`strategist-template.md`](./strategist-template.md) only after Stage 1 is confirmed and the selection installed.+**Hard rule — Stage-1 goal boundary**: what a template may inform in Stage 1 is fixed by [`generate-pptx.md`](../workflows/generate-pptx.md) Step 4; template controls on the same surface are confirmation state, never a reason to reshape the contract. Load [`strategist-template.md`](./strategist-template.md) only after Stage 1 is confirmed and the selection installed.> **Execution discipline**: Stage 1 is the first BLOCKING checkpoint; its receipt is intermediate and never ends the task. In the same run, install/fuse the selection, complete the handoff, author fresh Stage 2, and enter the final wait. After final confirmation proceed without another pause unless refinement is enabled; the only opt-in exception is [`refine-spec`](../workflows/stages/refine-spec.md), offered with the split-mode note and never entered unprompted.>diff --git a/skills/ppt-master/references/template-designer.md b/skills/ppt-master/references/template-designer.mdindex f0808a71..4c56c680 100644--- a/skills/ppt-master/references/template-designer.md+++ b/skills/ppt-master/references/template-designer.md@@ -227,7 +227,7 @@ Mirror retains literal source text and placeholder metadata and inserts no `{{..</g><rect x="40" y="90" width="1200" height="550" fill="#FFFFFF" rx="8"/><g id="body-slot" data-pptx-placeholder="body" data-pptx-bounds="40 90 1200 550">- <text id="body-carrier" data-pptx-carrier="true" x="640" y="365" text-anchor="middle" fill="#CBD5E1" font-size="16">{{CONTENT_AREA}}</text>+ <text id="body-carrier" data-pptx-carrier="true" x="64" y="122" fill="#CBD5E1" font-size="16">{{CONTENT_AREA}}</text></g>```diff --git a/skills/ppt-master/scripts/docs/confirm_ui.md b/skills/ppt-master/scripts/docs/confirm_ui.mdindex 8485cc9b..bc7f3fc8 100644--- a/skills/ppt-master/scripts/docs/confirm_ui.md+++ b/skills/ppt-master/scripts/docs/confirm_ui.md@@ -1,7 +1,7 @@# Confirm UI — Strategist and Template Confirmation Page> The interactive surface for [`generate-pptx`](../../workflows/generate-pptx.md)-> Step 4. Stage 1 shows the template-independent communication recommendation+> Step 4. Stage 1 shows the communication recommendation> and the template/free-design choice on one page and confirms both with one> submission. That submission writes the Strategist contract to `result.json`> and the selection sidecar to `template_selection.json`. The agent then installsdiff --git a/skills/ppt-master/workflows/create-template.md b/skills/ppt-master/workflows/create-template.mdindex 65ab2c25..bd054d6d 100644--- a/skills/ppt-master/workflows/create-template.md+++ b/skills/ppt-master/workflows/create-template.md@@ -40,7 +40,7 @@ A complete source PPTX does not determine the kind — classify only the stable## Process Overview```-Reference Bundle Intake & Analysis → Fact-Based Brief Proposal → User Confirmation Gate → Preflight + Invoke Selected Child → Validate Child Output → [Review PPTX: optional for one Master, required for multi-Master] → [Register Library Index] → Output+Reference Bundle Intake & Analysis → Fact-Based Brief Proposal → User Confirmation Gate → Preflight + Invoke Selected Child → Validate Child Output → [Prototype Review Round: Layout/Deck] → [Review PPTX: optional for one Master, required for multi-Master] → [Register Library Index] → Output```**No final template directory, template SVG, or Design Spec may be written until `[TEMPLATE_BRIEF_CONFIRMED]` is emitted in Step 3.** Reference-analysis intermediates (import workspaces under `/tmp/`) are not subject to this gate.@@ -301,6 +301,10 @@ Checker behavior in template mode: [`template-tools.md`](../scripts/docs/templatThis step is a **hard gate**: no review PPTX, registration, staged install, or handoff until it passes. After a staged project install, rerun the checker on the final `<target_project>/templates/`. A one-Master template may skip Step 6 when no review was requested; a multi-Master template must pass Step 6 before registration or completion.+### Step 5.1: Prototype Review Round++Layout/Deck only; Brand and Style skip it. Step 3 confirmed scope from a brief, not from the new design, so show the validated prototypes before they become durable: list the roster with one line per prototype (basename, role, slots) and point to the files or the Step 6 review PPTX, then wait for the user's reaction. Feedback revises prototypes or the spec inside the confirmed brief; a change to scope, kind, canvas, or replication intent returns to Step 2. After any revision rerun Step 5 (and Step 6 when triggered) before Step 7. Under explicit delegation, record `Prototype review: delegated` in the completion summary and continue.+---## Step 6: Template Review PPTX and Multi-Master Package Gate@@ -309,7 +313,7 @@ This step is a **hard gate**: no review PPTX, registration, staged install, or h```bashpython3 skills/ppt-master/scripts/template_preview_pptx.py "<authoring_workspace>" # exports/<template_id>_template_preview.pptx-python3 skills/ppt-master/scripts/template_preview_pptx.py "<authoring_workspace>" --native-charts-and-tables -o "<authoring_workspace>/exports/<template_id>_template_preview_native.pptx" # optional JSON-first check+python3 skills/ppt-master/scripts/template_preview_pptx.py "<authoring_workspace>" --native-charts-and-tables -o "<authoring_workspace>/exports/<template_id>_template_preview_native.pptx" # explicit native review; typed chart/table slots already compile natively in the default runpython3 skills/ppt-master/scripts/template_preview_pptx.py "<authoring_workspace>" --force # intentional replacement after a fix```@@ -333,7 +337,7 @@ A multi-Master failure blocks registration and completion; an unrequested one-Ma| Scope | Action ||---|---|-| `library` | After Step 5 (and Step 6 when requested or required), run `python3 skills/ppt-master/scripts/register_template.py <template_id> --kind brand|style|deck|layout`; it derives the entry from the spec frontmatter (preferred) or prose plus the actual `templates/*.svg` roster and updates that kind's `*_index.json` — the complete discovery source for Default Stage-1 controls and chat listing (neither scans directories) |+| `library` | After Step 5.1 (and Step 6 when requested or required), run `python3 skills/ppt-master/scripts/register_template.py <template_id> --kind brand|style|deck|layout`; it derives the entry from the spec frontmatter (preferred) or prose plus the actual `templates/*.svg` roster and updates that kind's `*_index.json` — the complete discovery source for Default Stage-1 controls and chat listing (neither scans directories) || `project` | Skip the registrar, edit no index or README, and report `Not registered (project workspace)` |An exact unregistered root supplied by the user or handed off by this route appears as an `explicit` candidate preselected only when it is the sole root; a root matching a registered canonical root may display as `library`; bare names are never resolved. Frontmatter examples per kind live in the child workflows; `--rebuild-all` rebuilds a kind's index after editing many specs.@@ -354,6 +358,7 @@ An exact unregistered root supplied by the user or handed off by this route appe**Bitmap Path**: `<template_workspace>/images/` ← omit when nothing was written or adopted**Imported Vector Path**: `<template_workspace>/icons/imported/` ← omit when nothing was written or adopted**Review PPTX**: `<template_workspace>/exports/<template_id>_template_preview.pptx` ← Layout/Deck only; omit when an optional one-Master review was not requested+**Prototype Review**: user-reviewed | delegated ← Layout/Deck only**Primary Color**: <hex> ← Brand/Deck only**Index Registration**: Done | Not registered (project workspace)diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.mdindex 20cc5a4c..275ec82c 100644--- a/skills/ppt-master/workflows/generate-pptx.md+++ b/skills/ppt-master/workflows/generate-pptx.md@@ -71,7 +71,7 @@ python3 ${SKILL_DIR}/scripts/project_manager.py import-sources <project_path> <s### Step 3: Template Candidate Preparation-Internal preparation for every Default run — no page, question, receipt, selection, template read, or installation. Quick skips this Step.+Internal preparation for every Default run — no page, question, receipt, selection, or installation; read only the frontmatter an exact root needs for kind and canvas. Quick skips this Step.Candidates follow [`routing.md`](./routing.md) §7: registered roots from the four indexes plus every exact root supplied for this run. Raw PPTX is source material, not a candidate — raw PPTX plus new content is [`edit-native-pptx`](./edit-native-pptx.md), and a reusable workspace comes from [`create-template`](./create-template.md).@@ -84,15 +84,15 @@ Resolve the surface under [`confirm-surface.md`](../references/confirm-surface.mStage 1 initializes from `default_mode` but the user may switch. Template mode requires at least one selection; exactly one supplied root may be preselected, several remain unselected.-**✅ Checkpoint** — candidates ready; nothing selected, read, validated, or installed. Proceed to Step 4 without a user-visible stop.+**✅ Checkpoint** — candidates ready; nothing selected, validated, or installed. Proceed to Step 4 without a user-visible stop.---### Step 4: Strategist Phase (MANDATORY in the default pipeline)-🚧 **GATE**: Steps 1–3 complete; no template content in planning context; Stage 1 not started.+🚧 **GATE**: Steps 1–3 complete; Stage 1 not started.-**Hard rule — Stage 1 is template-independent**: author every Stage-1 recommendation from the user's request, source facts, conversation constraints, and project-initialization state only; candidate paths, index summaries, template specs/prototypes/assets, and template canvas are not evidence. Template inspection begins only after Stage 1 confirms both the communication contract and the template/free-design choice and any selection is installed.+**Hard rule — a template never rewrites the goal**: audience, intent, outcome, core message, delivery context, and afterlife come from the user's request, source facts, conversation constraints, and project-initialization state; a candidate's existence, summary, or prototypes never bend them. Template facts already in context — a root handed off by Create Template in this conversation, an exact root's kind and canvas — may inform the recommended canvas and page range, and a canvas that differs from project initialization is a visible Stage-1 decision, never a silent Stage-2 override. Prototype-level planning begins only after Stage 1 confirms both the communication contract and the template/free-design choice and any selection is installed.Load the planning core in one batch, plus the structured facts already in `<project_path>/analysis/`:@@ -129,7 +129,7 @@ This is a capability map, not a usage checklist; direction construction follows**Only the user confirms**: the agent authors recommendations, operates the server, reads state, and applies a template. It never confirms on the user's behalf, automates submission, synthesizes a payload, or writes user result state; silence confirms nothing. Under explicit delegation the agent makes the Stage-1 decision, installs it, derives Stage 2, and presents one complete summary without fabricating UI receipts.-**UI branch** — `template_options.json` (Step 3), `recommendations.stage1.json`, `template_handoff.json` (written only by `--complete-template-selection`), and `recommendations.stage2.json` are agent inputs; `template_selection.json` and `result.json` are user receipts. Only the active unconfirmed stage file may be overwritten, in place, never with a revision suffix or another stage's payload. Author Stage 1 without reading candidates, launch, post the [`confirm-surface.md`](../references/confirm-surface.md) handoff summary, then wait:+**UI branch** — `template_options.json` (Step 3), `recommendations.stage1.json`, `template_handoff.json` (written only by `--complete-template-selection`), and `recommendations.stage2.json` are agent inputs; `template_selection.json` and `result.json` are user receipts. Only the active unconfirmed stage file may be overwritten, in place, never with a revision suffix or another stage's payload. Author Stage 1 without opening candidate specs or prototypes, launch, post the [`confirm-surface.md`](../references/confirm-surface.md) handoff summary, then wait:```bashpython3 ${SKILL_DIR}/scripts/confirm_ui/server.py <project_path> --daemondiff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.mdindex 1f1970eb..711ac1aa 100644--- a/skills/ppt-master/workflows/profiles/quick-generate.md+++ b/skills/ppt-master/workflows/profiles/quick-generate.md@@ -226,7 +226,7 @@ python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path> --quick-generate --wipython3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path> --quick-generate --no-notes # Speaker Notes disabled```-**Exporter behavior**: `--quick-generate` reads `svg_output/`, resolves project-local assets, infers one canvas and one all-page structure mode (no metadata → flat; complete Master/Layout/slot metadata → structured), and needs no lock. Notes, Custom Animations, and narration stay off unless the agent enabled them or the video rule requires them; append `--native-charts-and-tables` only for an explicit native Chart/Table delivery decision. Never run `finalize_svg.py`. The exporter requires a passing `final` report whose fingerprint matches the current `svg_output/`; the default output path keeps backup and postflight, an explicit `-o <path>.pptx` skips backup.+**Exporter behavior**: `--quick-generate` reads `svg_output/`, resolves project-local assets, infers one canvas and one all-page structure mode (no metadata → flat; complete Master/Layout/slot metadata → structured), and needs no lock. Notes, Custom Animations, and narration stay off unless the agent enabled them or the video rule requires them; append `--native-charts-and-tables` for an explicit native Chart/Table delivery decision or any structured `chart` / `table` placeholder slot (the exporter refuses to compile a typed slot as a fallback). Never run `finalize_svg.py`. The exporter requires a passing `final` report whose fingerprint matches the current `svg_output/`; the default output path keeps backup and postflight, an explicit `-o <path>.pptx` skips backup.**On failure**: repair the owning SVG, resource, or capability input, rerun the checker, and export again — never create a Design Spec or lock.