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(prompts): load execution modules on triggers, keep the executor core and preset vocabulary resident
hugohe317d1fd689857
diff --git a/AGENTS.md b/AGENTS.mdindex 4fc84303..78900c0e 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -35,7 +35,7 @@ PPT Master turns source material into natively editable DrawingML PPTX. Generate## Execution Requirements- For any `brand`, `style`, `layout`, or `deck` workspace creation from PPTX/SVG, images/PDFs, documents/websites, brand assets, direct text, or mixed references, enter [`skills/ppt-master/workflows/create-template.md`](skills/ppt-master/workflows/create-template.md); it keeps the fixed Create Template name and dispatches exactly one of [`create-brand`](skills/ppt-master/workflows/create-template/create-brand.md), [`create-style`](skills/ppt-master/workflows/create-template/create-style.md), [`create-layout`](skills/ppt-master/workflows/create-template/create-layout.md), or [`create-deck`](skills/ppt-master/workflows/create-template/create-deck.md).-- Always-on SVG constraints and shared visual-quality defaults live in [`skills/ppt-master/references/shared-standards-core.md`](skills/ppt-master/references/shared-standards-core.md). Default and Quick Generate always load [`svg-effects.md`](skills/ppt-master/references/svg-effects.md); other routes load it, [`native-data-interface.md`](skills/ppt-master/references/native-data-interface.md), and [`pptx-structure-interface.md`](skills/ppt-master/references/pptx-structure-interface.md) only when their documented execution triggers apply.+- Always-on SVG constraints and shared visual-quality defaults live in [`skills/ppt-master/references/shared-standards-core.md`](skills/ppt-master/references/shared-standards-core.md). Default and Quick Generate load [`svg-effects.md`](skills/ppt-master/references/svg-effects.md) on the executor-base routing trigger (the everyday effects live in the executor core); other routes load it, [`native-data-interface.md`](skills/ppt-master/references/native-data-interface.md), and [`pptx-structure-interface.md`](skills/ppt-master/references/pptx-structure-interface.md) only when their documented execution triggers apply.- Canvas choices live in [`skills/ppt-master/references/canvas-formats.md`](skills/ppt-master/references/canvas-formats.md).- Icon library details live in [`skills/ppt-master/templates/icons/README.md`](skills/ppt-master/templates/icons/README.md).diff --git a/docs/rules/prompt-layers.md b/docs/rules/prompt-layers.mdindex 8cd51a89..6d053010 100644--- a/docs/rules/prompt-layers.md+++ b/docs/rules/prompt-layers.md@@ -45,7 +45,7 @@ case is what makes a rule hard to recall at authoring time.**Hard rule — one owner, pointers elsewhere**: a rule is stated in full in exactly one file. Every other file that needs it carries a pointer naming the file and section, not a paraphrase. A paraphrase is a second owner: it drifts, contradicts the original after the next edit, and doubles the tokens. The cross-file duplicate check in `prompt_audit.py` catches verbatim copies only; paraphrases are caught by reading.-**Hard rule — everyday capabilities stay in the core**: effects, native shapes and their preset vocabulary, relationship grammar, and topology assembly are read before the first page by both Default and Quick. Only a capability most decks never touch (formula, hyperlink, chart/table branches, structured templates, video, animation, web-image attribution) loads on its own observable trigger, and the always-read core still names it in one routing row. Demoting an everyday capability to a trigger does not shrink the run — nearly every deck fires the trigger — and it reintroduces the failure where a capability not in context is never used.+**Hard rule — planning reads everything, execution loads on triggers, the core keeps the recall**: the planning role reads its complete bundle. The execution core (`executor-base.md`, `shared-standards-core.md`, `semantic-svg.md`, the locked mode/style files) stays resident and carries the everyday forms and a recall of every deeper module — device menu, everyday effects, preset families, the Structure decision — so a capability is known before its file is opened. The preset vocabulary stays resident with the core so contours are known before selection. Each deeper module (effects, native-shape authoring, relationship grammar and topology, images, charts/tables, formula, hyperlink, structured templates, video, animation, web-image attribution) loads on one observable trigger named in the core's routing table, is read completely on first use, and stays for the run; the page's module line records the load. A module with no recall in the core is the failure where a capability not in context is never used.---diff --git a/docs/rules/prompt-style.md b/docs/rules/prompt-style.mdindex f6a21152..fe174030 100644--- a/docs/rules/prompt-style.md+++ b/docs/rules/prompt-style.md@@ -121,8 +121,8 @@ against the v2.13.0 baseline, an Executor-phase core of roughly 1,300 linesacross a role file plus a shared technical file produced richer pages than a4,000-line, 12-file mandatory bundle; the larger bundle flattened expressionwhile passing every structural gate. Treat that as the working ceiling. When a-core grows past it, shrink it by removing what is not authoring guidance —-never by demoting an everyday capability to a trigger. What may stay in a+core grows past it, shrink it by removing what is not authoring guidance or by+moving a deeper module behind a trigger whose recall stays in the core. What may stay in aprompt file at all — craft, minimal contract, or tool documentation — and theprocedure for moving content out are owned by[`prompt-layers.md`](prompt-layers.md).diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex cd9f4b4e..e5ff00f5 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -11,6 +11,9 @@ Always-loaded Executor authority for flat SVG page authoring, shared by Default| Any value-driven geometry, including a chart-family reference, mini chart, sparkline, inset, or small multiple | [`executor-chart.md`](./executor-chart.md) || Any semantic cell grid, including a table-family reference | [`executor-table.md`](./executor-table.md) || A page uses a preset pattern fill, or an independent Chart/Table object is resolved as `<object-key>=yes` | [`native-data-interface.md`](./native-data-interface.md) before emitting the pattern or replacement metadata |+| The per-page Structure decision is `yes` for the first time | [`executor-structure.md`](./executor-structure.md) + [`topology-assembly.md`](./topology-assembly.md) |+| A page's contour reaches beyond rectangle, rounded rectangle, circle, ellipse, and line — block arrow, chevron, callout, flowchart symbol, banner, star, bracket, connector preset — or needs a Boolean / freeform decision | [`native-shape-authoring.md`](./native-shape-authoring.md), read completely on first use (the preset vocabulary is already resident) |+| A page's visual job reaches beyond the everyday block below — faux glass, constructed styles (hand-drawn, ink, riso, pixel, halftone, paper-cut, facets, gradient ribbon), gradient stroke, text picture/texture fill, gauge / sunburst / explicit arc geometry, freeform curves, transforms beyond rotate, or an unsupported effect needing a native-safe alternative | [`svg-effects.md`](./svg-effects.md) || Any image | [`executor-image.md`](./executor-image.md) + [`image-layout-spec.md`](./image-layout-spec.md) + [`image-layout-patterns.md`](./image-layout-patterns.md) + [`svg-image-embedding.md`](./svg-image-embedding.md) || Any nontrivial mathematical expression | [`native-formula.md`](./native-formula.md) || Any external or same-deck click hyperlink | [`native-hyperlinks.md`](./native-hyperlinks.md) |@@ -97,7 +100,7 @@ Read this before §1: the expression vocabulary every page draws from. The contr## 1. Effect Capability Discovery-**Reference — effects vocabulary**: [`svg-effects.md`](./svg-effects.md) §6.1 lists the visual jobs an effect can serve, with its Visual Job Router as recall; §6.13 offers coordinated page recipes. Active cross-page continuous action additionally loads [`animations.md`](./animations.md) §3.1 before authoring both endpoints.+**Reference — effects are a triggered module**: the everyday block in the Page Expression Core covers gradients, cards, shadow, glow, scrims, dashes, and inline emphasis for most pages. Load [`svg-effects.md`](./svg-effects.md) the first time a page's job reaches beyond it (routing table above); once loaded, its §6.1 Visual Job Router recalls candidates and §6.13 offers coordinated page recipes, and it stays in context for the rest of the run. Active cross-page continuous action additionally loads [`animations.md`](./animations.md) §3.1 before authoring both endpoints.**Hard rule — discovery does not expand compatibility**: follow `svg-effects.md` syntax and fallbacks; source/backdrop blur, blend mode, `<mask>` / per-pixel masking, dense texture, and skew stay baked or alternative-only.@@ -127,7 +130,7 @@ Before the first SVG page, output one confirmation listing: the compact communic**Per-page communication trace**: read `communication.objective`, `communication.core_message`, and the page's §IX `Core message` + `Audience move` before composing. The page must advance the objective and make that move; a page that cannot state its move is an outline defect — surface `warning: P<NN> has no communication move` rather than decorating around it, and never invent a purpose at execution time. Structural pages advance the contract by establishing relevance, tension, or the decision frame, or by completing the final commitment.-**Mandatory — per-page Structure decision**: before drawing, read the page's §IX `Layout`, `Visualization`, and `Content` and decide whether geometry must carry a qualitative `order`, `link`, `parent`, `membership`, `contrast`, or `overlap` relationship — from the semantic relationship alone, with the already-loaded [`executor-structure.md`](./executor-structure.md); a suggested carrier, topology, or composition does not decide it. `no` stays on this base path; `yes` applies that grammar and keeps the relationship statement in active page context with no catalog reference, lock row, or artifact. A Chart/Table reference never substitutes.+**Mandatory — per-page Structure decision**: before drawing, read the page's §IX `Layout`, `Visualization`, and `Content` and decide whether geometry must carry a qualitative `order`, `link`, `parent`, `membership`, `contrast`, or `overlap` relationship — from the semantic relationship alone, loading [`executor-structure.md`](./executor-structure.md) and [`topology-assembly.md`](./topology-assembly.md) at the first `yes`; a suggested carrier, topology, or composition does not decide it. `no` stays on this base path; `yes` applies that grammar and keeps the relationship statement in active page context with no catalog reference, lock row, or artifact. A Chart/Table reference never substitutes.**Per-page reading-mode check**: read `communication.consumption_mode` and apply it with the §IX block texture and `page_rhythm`:@@ -187,13 +190,14 @@ Mechanical repetition comes from reusing one carrier and topology without a page- **Main-agent ownership**: SVG generation runs in the main agent, never a sub-agent — pages share upstream context for cross-page continuity.- **Generation rhythm (Default only)**: P01 → first-page gate → remaining pages with one page gate per first-exercised `not-exercised` item → final gate, in one context, no batches or other mid-run checker calls.- **Fact provenance**: resolve each §IX `Fact ID` from `sources/*.facts.json` and keep the value unchanged; render a compact source footnote (name + short URL/domain) when space permits and state attribution naturally in enabled notes. For `Data class: scenario`, place a visible localized `Scenario data` / `情景数据` label beside the KPI/chart and say in notes that it is illustrative. Never attach a fact ID to scenario data or let an unlabeled invented KPI look factual.-- **Mandatory — resolve the page carrier mix before coordinates**: in one page-level decision, choose the background field, editable text and optional lettering, native geometry/lines, prepared photos/scenes/illustration/icon assets, and applicable visualizations — their combination, visual weight, z-order, and local construction from the page message and hierarchy, using only prepared resources and preserving every binding resource job. The resolved style controls treatment and emphasis, never carrier eligibility, image source, or the native vocabulary. Recall the loaded vocabulary here: the style's §1 `Composition geometry`, [`svg-effects.md`](./svg-effects.md) §6.1, and [`native-shape-authoring.md`](./native-shape-authoring.md) §2.1.+- **Mandatory — resolve the page carrier mix before coordinates**: in one page-level decision, choose the background field, editable text and optional lettering, native geometry/lines, prepared photos/scenes/illustration/icon assets, and applicable visualizations — their combination, visual weight, z-order, and local construction from the page message and hierarchy, using only prepared resources and preserving every binding resource job. The resolved style controls treatment and emphasis, never carrier eligibility, image source, or the native vocabulary. Recall the vocabulary here: the style's §1 `Composition geometry`, the everyday block above, and — once triggered — [`svg-effects.md`](./svg-effects.md) §6.1 and [`native-shape-authoring.md`](./native-shape-authoring.md) §2.1.- **Default — stage each page with the style's composition geometry (may override when another page-fit move is stronger)**: an SVG page is a canvas, not a DOM. A preset uses its style's §1 `Composition geometry`; a `custom` executes `visual_style_behavior` first and takes §1 geometry only from the exact `visual_style_references` the behavior assigns a shape or composition job; an unreferenced custom follows its behavior alone. Every listed move is generative vocabulary, then [`native-shape-authoring.md`](./native-shape-authoring.md) §2.1's exact-fit gate applies.- **Default — consider the planned motif (may override when another coherent expression serves the deck better)**: when §III `Theme` recommends a cross-page motif, decide whether it earns a continuity job; if adopted, vary scale, crop, density, position, and content interaction by page role. An explicit user/template motif binds.- **Ordinary carriers stay ordinary**: cards, icon-and-label rows, color swatches, soft shadows, and gradient fields are everyday carriers — use them whenever content groups, compares, enumerates, or names a color, material, or sample, with one shared treatment for peers. When the subject is a color or material, draw it: a swatch is content, its value comes from the source, and it needs no lock row.- **Everyday devices**: the device menu above is the recall list; reach for a device by page job and let the locked style set its treatment.- **Inherited containers**: keep meaningful template frames and restyle radius, fill, stroke, and depth from the Design Spec and lock; Chart/Table reference adaptation belongs to [`executor-visualization.md`](./executor-visualization.md), and preview effects never override project styling.- **Reference — semantic geometry over preset stacks**: for ascending, converging, breaking-through, or stacking relationships, compose faithful primitives and exact presets as one geometry system; a Boolean only when the contour must merge, open, or fragment; one page-specific path only when neither works.+- **Mandatory — per-page module line**: before drawing each page, write one line `P<NN> modules: core[, structure][, native-shape][, effects][, image][, chart | table | formula | link | web-image]` naming the triggered modules the page uses; a module named for the first time is read completely before that page's first SVG line, and a page whose carrier mix uses a module's capability without naming it is a defect the carrier receipt exposes.- **Phased generation** (recommended):1. **Visual Construction Phase**: generate all pages sequentially, applying every triggered branch while drawing. **MUST embed one object-scoped plot-area marker** per §IX-named or Quick-promoted value-driven chart object ([`executor-chart.md`](./executor-chart.md) §2); calibration follows in [`verify-charts`](../workflows/stages/verify-charts.md). Write every `<object-key>=yes` native marker plus JSON metadata atomically ([`native-data-interface.md`](./native-data-interface.md) §2) and stamp its baseline before the page's gate — `python3 ${SKILL_DIR}/scripts/stamp_native_fallbacks.py <project_path>/svg_output/<page>.svg --write`, rerun after any visible edit inside the marker group. **Reach for native presets** per §3.0 as you draw, decided by the object's intent, never by scanning finished paths; several presets for one page go through one `preset_shape_svg.py render-batch --input -` round (gradient/pattern paint stays ordinary SVG; a justified §6.4 shadow/glow stays on the helper-authored shape).2. **Quality gates**: owned by the route — [`generate-pptx.md`](../workflows/generate-pptx.md) Step 6 (first-page, first-exercise, final, carrier receipt) or [`quick-generate.md`](../workflows/profiles/quick-generate.md) §4 (one lockless final check). Run each checker unfiltered, review the complete issue set, fix every error plus selected warnings in one consolidated pass, verify once; never check between individual fixes, never `cat` a passing report, never defer errors past `finalize_svg.py` (it rewrites SVG and masks violations). Every `warning` is advisory.@@ -201,9 +205,9 @@ Mechanical repetition comes from reusing one carrier and topology without a page### 3.0 Native Shape Selection-**Hard rule — contour before encoding**: choose the page-fit contour from the full native vocabulary — [`preset-shape-vocabulary.md`](./preset-shape-vocabulary.md), read completely before the first page — before its authoring form. Rectangle, rounded rectangle, circle, and ellipse are preset contours even in short SVG syntax; easier syntax never selects a contour. Block arrows, chevrons, banners, callouts, flowchart nodes, stars, and other Office symbols come from `preset_shape_svg.py`, never plain paths or fake rectangles. No Design Spec selection, scorer, or inventory gates this choice.+**Hard rule — contour before encoding**: choose the page-fit contour from the full native vocabulary — [`preset-shape-vocabulary.md`](./preset-shape-vocabulary.md), read completely before the first page — before its authoring form; the first time a page reaches beyond rectangle, rounded rectangle, circle, ellipse, and line, read [`native-shape-authoring.md`](./native-shape-authoring.md) completely before choosing. Rectangle, rounded rectangle, circle, and ellipse are preset contours even in short SVG syntax; easier syntax never selects a contour. Block arrows, chevrons, banners, callouts, flowchart nodes, stars, and other Office symbols come from `preset_shape_svg.py`, never plain paths or fake rectangles. No Design Spec selection, scorer, or inventory gates this choice.-**Mandatory — independent per-page geometry move**: after the Structure result and any topology, apply [`native-shape-authoring.md`](./native-shape-authoring.md) §2.1 before writing coordinates; it owns exact-fit comparison, composition lenses, relationship and carrier fit, contour-family choice, the reader effect of a generic or undrawn result, the running geometry signature, and the materialization boundary for both Structure results. Keep the decision in active context; never change the Structure result.+**Mandatory — independent per-page geometry move**: after the Structure result and any topology, decide the page's geometry before writing coordinates; when it reaches beyond basic primitives, apply [`native-shape-authoring.md`](./native-shape-authoring.md) §2.1 (loading it then); it owns exact-fit comparison, composition lenses, relationship and carrier fit, contour-family choice, the reader effect of a generic or undrawn result, the running geometry signature, and the materialization boundary for both Structure results. Keep the decision in active context; never change the Structure result.Materialize through [`native-shape-authoring.md`](./native-shape-authoring.md) §1's table: an ordinary primitive when the exporter maps it to the same contour, otherwise the helper fragment; `<line>` for a straight relationship and a `bentConnector*` / `curvedConnector*` preset for a stock bend or curve (both export unconnected); independent siblings for a page-level system; `shape_boolean_svg.py` only when one contour must merge, cut, or fragment; ordinary path/polygon only for geometry none of those express. A directional solid object is a `shape` preset such as `rightArrow` or `chevron`; `actionButton*` presets are geometry only.diff --git a/skills/ppt-master/references/executor-structure.md b/skills/ppt-master/references/executor-structure.mdindex f15ca091..5069735b 100644--- a/skills/ppt-master/references/executor-structure.md+++ b/skills/ppt-master/references/executor-structure.md@@ -2,7 +2,7 @@# Executor Shape Composition Grammar-Runtime grammar for Slide-local qualitative relationships built from editable shapes; not a diagram catalog. Default and Quick read it once with their fixed construction bundle and reuse it for every per-page decision; loading it selects no `Structure=yes` and creates no geometry quota.+Runtime grammar for Slide-local qualitative relationships built from editable shapes; not a diagram catalog. Default and Quick read it once at the first page whose Structure decision is `yes` and reuse it for every later page; loading it selects no `Structure=yes` and creates no geometry quota.**Hard rule — no Structure catalog**: never recall or resolve `structure/<key>`; compose from authoritative content, §IX relationships, the communication move, and the active visual system.diff --git a/skills/ppt-master/references/image-layout-spec.md b/skills/ppt-master/references/image-layout-spec.mdindex fa5469a1..ede484b3 100644--- a/skills/ppt-master/references/image-layout-spec.md+++ b/skills/ppt-master/references/image-layout-spec.md@@ -8,7 +8,7 @@ Neutral geometry and review rules for every image placement. This file calculate## 1. Ownership and Inputs-Default Strategist owns resource choice, semantic role, crop boundary, and the preferred image/content or image/shape relationship; Image_Generator owns composition inside each generated bitmap for its planned container; Default Executor owns final SVG regions and geometry and may adapt the preferred relationship while preserving binding resource, content, and crop constraints; Quick's main agent holds all of these in one context. This specification and [`image-layout-patterns.md`](./image-layout-patterns.md) are the always-read geometry and composition vocabulary; [`svg-image-embedding.md`](./svg-image-embedding.md) owns embedding; [`svg-effects.md`](./svg-effects.md) and [`native-shape-authoring.md`](./native-shape-authoring.md) are loaded before realization, so apply them directly when a construction needs effects, preset, or Boolean geometry.+Default Strategist owns resource choice, semantic role, crop boundary, and the preferred image/content or image/shape relationship; Image_Generator owns composition inside each generated bitmap for its planned container; Default Executor owns final SVG regions and geometry and may adapt the preferred relationship while preserving binding resource, content, and crop constraints; Quick's main agent holds all of these in one context. This specification and [`image-layout-patterns.md`](./image-layout-patterns.md) are the always-read geometry and composition vocabulary; [`svg-image-embedding.md`](./svg-image-embedding.md) owns embedding; [`svg-effects.md`](./svg-effects.md) and [`native-shape-authoring.md`](./native-shape-authoring.md) load on their executor-base triggers, so apply them when a construction needs effects, preset, or Boolean geometry.### 1.1 Geometry notationdiff --git a/skills/ppt-master/references/native-shape-authoring.md b/skills/ppt-master/references/native-shape-authoring.mdindex 0cfa7223..2497ee2d 100644--- a/skills/ppt-master/references/native-shape-authoring.md+++ b/skills/ppt-master/references/native-shape-authoring.md@@ -24,7 +24,7 @@ python3 ${SKILL_DIR}/scripts/shape_boolean_svg.py render <svg-file> \- **Hard rule — atomic and helper-owned**: never write `data-pptx-prst`, frame, adjustment, or registry paths by hand, never edit a direct path, and rerun the helper when preset, frame, adjustment, paint, or filter changes. Keep the fragment top-level without `data-pptx-bounds` when standalone (its `data-pptx-frame` owns geometry); put labels or decorations beside it in a separate bounded parent group, never inside. Moving, scaling, rotating, or flipping the whole group is fine; zero-scale and shear are not, the transformed frame stays inside DrawingML's coordinate range, and stroke width stays inside its line-width range. Keep the helper's exact space-separated ordinary-decimal `data-pptx-frame` spelling; compact authoring accepts no alternate numeric spelling. Keep paint and opacity off ancestor groups (the checker warns).- `shape_boolean_svg.py` consumes closed `path` / `polygon` / `rect` / `circle` / `ellipse`, one unfiltered compact preset, or supported horizontal direct `<text>` with a resolvable OpenType face (`--font-dir` adds roots; text becomes glyph geometry). The first `--source` supplies result paint and explicit paint flags override only their named channels; for `subtract` every later operand is removed from it. Coordinates are baked into root space: insert the stdout paths at the primary operand's z-order with no extra transform. `union` / `combine` / `intersect` / `subtract` emit one `<path>`; `fragment` emits `<id>-1`, `<id>-2`, … in top/left/bottom/right/area order, each a separate shape. Results use nonzero winding and never `fill-rule`, `clip-rule`, `clip-path`, `mask`, or Merge Shapes metadata; operands that depend on even-odd fill, clipping, or masking fail closed. Never use it on mirror/preserve source structure.-**Mandatory — complete vocabulary before contour selection**: read [`preset-shape-vocabulary.md`](./preset-shape-vocabulary.md) completely at authoring entry (Create Template: as soon as `replication_mode` resolves to `standard` or `fidelity`; never for `mirror`); a filtered lookup cannot replace it. Reread only after context invalidation or a known file change.+**Mandatory — complete vocabulary before contour selection**: [`preset-shape-vocabulary.md`](./preset-shape-vocabulary.md) is read completely before contour work (Generate: with the executor core before the first page; Create Template: as soon as `replication_mode` resolves to `standard` or `fidelity`; never for `mirror`); a filtered lookup cannot replace it. Reread only after context invalidation or a known file change.## 1. Contour Selection and Materialization Gatediff --git a/skills/ppt-master/references/preset-shape-vocabulary.md b/skills/ppt-master/references/preset-shape-vocabulary.mdindex 43d69d71..b195bc76 100644--- a/skills/ppt-master/references/preset-shape-vocabulary.md+++ b/skills/ppt-master/references/preset-shape-vocabulary.md@@ -1,8 +1,8 @@# Native Preset Shape VocabularyThis is Executor's complete authoring-side map of the 187 registered DrawingML-preset names. Read it once before choosing a newly authored page or template-contour. The Office categories and family descriptions expose what exists and+preset names. Read it once, completely, with the executor core before the first page+(Generate) or at authored-mode entry (Create Template). The Office categories and family descriptions expose what exists andwhat each contour objectively depicts; the current page's meaning, visualsystem, and composition determine whether and how to use it.diff --git a/skills/ppt-master/references/shared-standards-core.md b/skills/ppt-master/references/shared-standards-core.mdindex 3559aa84..441798aa 100644--- a/skills/ppt-master/references/shared-standards-core.md+++ b/skills/ppt-master/references/shared-standards-core.md@@ -253,6 +253,6 @@ Serial post-processing and export belong to [`generate-pptx.md`](../workflows/ge| Containers | A card or panel expresses grouping, hierarchy, boundary, capacity, or a distinct material plane; peer containers share treatment unless a semantic difference justifies contrast. An unplanned repeated web-card grid is a carrier / topology problem, not a reason to suppress meaningful borders, shapes, or containers. || Titles and page chrome | Treat the semantic page title as part of the current composition rather than an automatic fixed header band; its position, scale, and relationship may change with page role while preserving the active route's content invariants. Add or retain running headers, footers, and page numbers only when they carry navigation, identity, attribution, or another explicit page job. Fidelity profiles preserve required source chrome. |-**Reference — effects vocabulary**: Default and Quick Generate load [`svg-effects.md`](./svg-effects.md); its §6.1 Visual Job Router lists the visual jobs an effect can serve. Whether any compatible technique is added is the author's call.+**Reference — effects vocabulary**: the executor core carries the everyday effects; [`svg-effects.md`](./svg-effects.md) loads on its routing trigger, and its §6.1 Visual Job Router lists the visual jobs an effect can serve. Whether any compatible technique is added is the author's call.**Reference — where expression lives**: §4.2 owns editable text form, including per-run inline emphasis and leading; §4.3 owns grouping. §1.4's imported-PowerPoint metadata applies only to import, mirror, and round-trip routes.diff --git a/skills/ppt-master/references/svg-effects.md b/skills/ppt-master/references/svg-effects.mdindex a299aa49..a54b8c9e 100644--- a/skills/ppt-master/references/svg-effects.md+++ b/skills/ppt-master/references/svg-effects.md@@ -2,14 +2,14 @@# SVG Effects and Geometry Specification-Authority for advanced paint, effects, transforms, freeform/radial geometry, and constructed visual styles. Default and Quick Generate load it before SVG authoring; other SVG-authoring routes follow their workflow trigger. It keeps the form the model writes and the design decisions behind each technique; the complete grammar the checker and exporter enforce for §6.2–§6.10 is in [`svg-contract.md`](../scripts/docs/svg-contract.md) Part II under the same section numbers; §6.1 and §6.11–§6.13 are design guidance with no separate contract.+Authority for advanced paint, effects, transforms, freeform/radial geometry, and constructed visual styles. Default and Quick Generate load it on the executor-base routing trigger — the first page whose visual job reaches beyond the everyday block — and keep it for the rest of the run; other SVG-authoring routes follow their workflow trigger. It keeps the form the model writes and the design decisions behind each technique; the complete grammar the checker and exporter enforce for §6.2–§6.10 is in [`svg-contract.md`](../scripts/docs/svg-contract.md) Part II under the same section numbers; §6.1 and §6.11–§6.13 are design guidance with no separate contract.**Cross-reference map**: unqualified §1, §2, and §4 references point to [`shared-standards-core.md`](./shared-standards-core.md); §6 references are local to this file.## 6. Advanced SVG Effects and Authoring Techniques-**Mandatory**: Default and Quick Generate read this file completely before SVG-authoring and keep its compatible techniques in active construction vocabulary.+**Mandatory**: once triggered, read this file completely before that page's+first SVG line and keep its compatible techniques in active construction vocabulary.Before finalizing each page, run the §6.1 selection procedure, with the VisualJob Router as recall for the jobs it diagnoses. Use §6.13 when diagnosedjobs benefit from one coordinated page recipe.diff --git a/skills/ppt-master/references/topology-assembly.md b/skills/ppt-master/references/topology-assembly.mdindex 0504c2be..347a351e 100644--- a/skills/ppt-master/references/topology-assembly.md+++ b/skills/ppt-master/references/topology-assembly.md@@ -2,7 +2,7 @@# Topology Assembly Reference-Generative material for turning one resolved qualitative topology into editable native-shape components with coherent relative registration, before coordinates. Default and Quick read it once with the construction bundle and reuse it for every `Structure=yes` assembly.+Generative material for turning one resolved qualitative topology into editable native-shape components with coherent relative registration, before coordinates. Default and Quick read it once with `executor-structure.md` at the first `Structure=yes` page and reuse it for every later assembly.**Hard rule — relative constraints, never copyable geometry**: state exact preset or primitive identities, semantic counts, inter-component relations, and only the relative geometry that makes the assembly hold; never coordinates, points, sizes, ratios, adjustment values, path data, SVG fragments, full-page frames, copy, color, styling, or page composition. Materialize every adopted call through `native-shape-authoring.md`.diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex 4ec813e4..21e94df6 100644--- a/skills/ppt-master/scripts/prompt_audit_manifest.json+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json@@ -18,7 +18,7 @@"file_budgets": {"AGENTS.md": 3250,"skills/ppt-master/SKILL.md": 1750,- "skills/ppt-master/references/executor-base.md": 9250,+ "skills/ppt-master/references/executor-base.md": 9750,"skills/ppt-master/references/executor-structured.md": 5500,"skills/ppt-master/references/executor-chart.md": 1750,"skills/ppt-master/references/executor-visualization.md": 1000,@@ -249,12 +249,8 @@"skills/ppt-master/workflows/profiles/quick-generate.md","skills/ppt-master/references/shared-standards-core.md","skills/ppt-master/references/executor-base.md",- "skills/ppt-master/references/svg-effects.md",- "skills/ppt-master/references/native-shape-authoring.md","skills/ppt-master/references/preset-shape-vocabulary.md","skills/ppt-master/references/semantic-svg.md",- "skills/ppt-master/references/executor-structure.md",- "skills/ppt-master/references/topology-assembly.md","skills/ppt-master/references/canvas-formats.md","skills/ppt-master/references/image-layout-spec.md","skills/ppt-master/references/image-layout-patterns.md",@@ -292,7 +288,7 @@"registry": "image-renderings"}],- "max_tokens": 130000+ "max_tokens": 115000},"route.generate.quick-generate.beautify": {"description": "Quick Generate with the shared strict 1:1 Beautify profile. Ceiling raised after BUDGET_LOAD_SET reported 136685 tokens.",@@ -790,17 +786,13 @@"max_tokens": 200000},"stage.generate.executor.flat": {- "description": "Incremental flat Executor core with complete visual-construction authorities and a conservative audit envelope for only the locked preset or exact custom references; selection indexes remain planning-only.",+ "description": "Executor resident core for flat pages: execution rules, everyday devices and effects, module triggers, plus the locked mode/style files. Deeper modules load on their routing triggers.","scope": "incremental","files": ["skills/ppt-master/references/executor-base.md","skills/ppt-master/references/shared-standards-core.md",- "skills/ppt-master/references/svg-effects.md",- "skills/ppt-master/references/native-shape-authoring.md",- "skills/ppt-master/references/preset-shape-vocabulary.md","skills/ppt-master/references/semantic-svg.md",- "skills/ppt-master/references/executor-structure.md",- "skills/ppt-master/references/topology-assembly.md",+ "skills/ppt-master/references/preset-shape-vocabulary.md",{"glob": "skills/ppt-master/references/modes/*.md","exclude": [@@ -822,7 +814,7 @@"allow_repeat": true}],- "max_tokens": 71000+ "max_tokens": 35000},"stage.generate.executor.structured": {"description": "Structured template execution layered on the flat/shared core.",@@ -1170,13 +1162,12 @@"max_tokens": 1000},"stage.generate.executor.native-shape": {- "description": "Complete stock PowerPoint shape vocabulary, selection, and Boolean materialization authority, always included in Generate Executor contexts. Ceiling raised after BUDGET_LOAD_SET reported 9139 tokens.",+ "description": "Native-shape selection and Boolean construction; loaded the first time a page's contour reaches beyond basic primitives (the preset vocabulary stays in the resident core).","scope": "incremental","files": [- "skills/ppt-master/references/native-shape-authoring.md",- "skills/ppt-master/references/preset-shape-vocabulary.md"+ "skills/ppt-master/references/native-shape-authoring.md"],- "max_tokens": 10000+ "max_tokens": 5000},"stage.shared.svg-effects": {"description": "Advanced SVG paint, effects, transforms, and geometry authority, always included in Generate Executor contexts and conditionally loaded by other SVG-authoring routes.",@@ -1193,6 +1184,53 @@"skills/ppt-master/references/artifact-ownership.md"],"max_tokens": 6000+ },+ "stage.generate.executor.effects": {+ "description": "Advanced effects and constructed styles; loaded the first time a page's visual job reaches beyond the everyday block in executor-base.",+ "scope": "incremental",+ "files": [+ "skills/ppt-master/references/svg-effects.md"+ ],+ "max_tokens": 10000+ },+ "stage.generate.executor.structure": {+ "description": "Qualitative relationship grammar and topology assembly; loaded at the first page whose Structure decision is yes.",+ "scope": "incremental",+ "files": [+ "skills/ppt-master/references/executor-structure.md",+ "skills/ppt-master/references/topology-assembly.md"+ ],+ "max_tokens": 5000+ },+ "route.generate.quick-generate.effects": {+ "description": "Quick Generate plus the effects module on its executor-base trigger.",+ "scope": "cumulative",+ "include": [+ "route.generate.quick-generate",+ "stage.generate.executor.effects"+ ],+ "files": [],+ "max_tokens": 130000+ },+ "route.generate.quick-generate.native-shape": {+ "description": "Quick Generate plus the native-shape module on its executor-base trigger.",+ "scope": "cumulative",+ "include": [+ "route.generate.quick-generate",+ "stage.generate.executor.native-shape"+ ],+ "files": [],+ "max_tokens": 130000+ },+ "route.generate.quick-generate.structure": {+ "description": "Quick Generate plus the structure module on its executor-base trigger.",+ "scope": "cumulative",+ "include": [+ "route.generate.quick-generate",+ "stage.generate.executor.structure"+ ],+ "files": [],+ "max_tokens": 130000}},"duplicates": {diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.mdindex 01f0d707..f96d33f1 100644--- a/skills/ppt-master/workflows/generate-pptx.md+++ b/skills/ppt-master/workflows/generate-pptx.md@@ -216,19 +216,19 @@ Load only the references the rows need; a mixed deck writes both `image_prompts.🚧 **GATE**: Step 4 (and Step 5 if triggered) complete.```-Read ${SKILL_DIR}/references/executor-base.md # REQUIRED: flat/shared execution core-Read ${SKILL_DIR}/references/shared-standards-core.md # REQUIRED: SVG contract + shared aesthetic/leading baseline-Read ${SKILL_DIR}/references/svg-effects.md # REQUIRED: effects/construction vocabulary-Read ${SKILL_DIR}/references/native-shape-authoring.md # REQUIRED: native-shape selection and Boolean construction-Read ${SKILL_DIR}/references/preset-shape-vocabulary.md # REQUIRED: complete 187-name authoring vocabulary-Read ${SKILL_DIR}/references/executor-structure.md # REQUIRED: qualitative relationship and topology grammar-Read ${SKILL_DIR}/references/topology-assembly.md # REQUIRED: topology assembly material-Read ${SKILL_DIR}/references/semantic-svg.md # REQUIRED: semantic metadata boundary+Read ${SKILL_DIR}/references/executor-base.md # REQUIRED core: execution rules, device menu, everyday effects, module triggers+Read ${SKILL_DIR}/references/shared-standards-core.md # REQUIRED core: SVG contract + shared aesthetic/leading baseline+Read ${SKILL_DIR}/references/semantic-svg.md # REQUIRED core: semantic metadata boundary+Read ${SKILL_DIR}/references/preset-shape-vocabulary.md # REQUIRED core: complete 187-name preset vocabularyRead ${SKILL_DIR}/references/modes/<resolved-id>.md # one preset id, or each `mode_references` idRead ${SKILL_DIR}/references/visual-styles/<resolved-id>.md # one preset id, or each `visual_style_references` id+# Triggered modules — read completely the first time a page needs them (executor-base routing table):+# executor-structure.md + topology-assembly.md first `Structure = yes` page+# native-shape-authoring.md first contour beyond rect / roundRect / circle / ellipse / line, or a Boolean / freeform+# svg-effects.md first visual job beyond the everyday block```-Read these as one batch with the exact detail files named by the retained `spec_lock.md`; never reopen the planning indexes, infer adjacent bases, glob a catalog, or blend unselected identities (an unreferenced custom follows its behavior alone). Conditional modules load on [`executor-base.md`](../references/executor-base.md)'s routing table, never by analogy; `video-design.md` is read before the first SVG when §I records recorded/self-running/video delivery or §X a literal script. `executor-structured.md` owns template specs and prototypes; `executor-visualization.md` resolves a selected reference to one SVG plus its family branch. Read each reference once per valid context.+Read the core as one batch with the exact detail files named by the retained `spec_lock.md`, then modules only on their triggers (each page's module line records them); never reopen the planning indexes, infer adjacent bases, glob a catalog, or blend unselected identities (an unreferenced custom follows its behavior alone). Conditional modules load on [`executor-base.md`](../references/executor-base.md)'s routing table, never by analogy; `video-design.md` is read before the first SVG when §I records recorded/self-running/video delivery or §X a literal script. `executor-structured.md` owns template specs and prototypes; `executor-visualization.md` resolves a selected reference to one SVG plus its family branch. Read each reference once per valid context.**Context**: follow `executor-base.md` §2.1 — reuse the retained Design Spec and lock; a fresh, resumed, compacted, or changed context rereads both once and reloads triggered inputs; the lock is reread after P05/P10/P15/…; the §IX roster renders one-for-one in order (repair within the confirmed range first, never during drawing); §IX is preferred wording and semantic authority, adapted only under the content-vs-expression contract, with sources read only for verification. When §X records a literal script, read the frozen `notes/total.md` once before P01 and design each visible state around its segment. Trust the latest `analysis/image_analysis.csv` (rerun `analyze_images.py` if `images/` changed; an empty folder means no inventory). `page-context` is a diagnostic only ([`artifact-ownership.md`](../references/artifact-ownership.md) §1).diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.mdindex d3391950..f59f61a6 100644--- a/skills/ppt-master/workflows/profiles/quick-generate.md+++ b/skills/ppt-master/workflows/profiles/quick-generate.md@@ -164,7 +164,7 @@ This menu never satisfies the per-page Structure decision in §3.## 3. Direct SVG Authoring-Read the execution references together, never file by file: [`shared-standards-core.md`](../../references/shared-standards-core.md), [`executor-base.md`](../../references/executor-base.md), [`svg-effects.md`](../../references/svg-effects.md), [`native-shape-authoring.md`](../../references/native-shape-authoring.md), [`preset-shape-vocabulary.md`](../../references/preset-shape-vocabulary.md) (complete, before P01), [`semantic-svg.md`](../../references/semantic-svg.md), [`executor-structure.md`](../../references/executor-structure.md), and [`topology-assembly.md`](../../references/topology-assembly.md); installed Layout/Deck structure adds [`pptx-structure-interface.md`](../../references/pptx-structure-interface.md). Keep the selected mode/style files: a custom applies one basis under its behavior, synthesizes several by their contributions, or follows the behavior alone. When any image exists, read [`executor-image.md`](../../references/executor-image.md) and [`svg-image-embedding.md`](../../references/svg-image-embedding.md) once before the first affected page (plus [`executor-web-image.md`](../../references/executor-web-image.md) for a `Sourced` image); reread anything only after a known file change or context invalidation.+Read the execution core together, never file by file: [`shared-standards-core.md`](../../references/shared-standards-core.md), [`executor-base.md`](../../references/executor-base.md), [`semantic-svg.md`](../../references/semantic-svg.md), and [`preset-shape-vocabulary.md`](../../references/preset-shape-vocabulary.md) (complete, before P01); then load modules only on their triggers from `executor-base.md`'s routing table, each read completely the first time a page needs it and recorded in that page's module line — [`executor-structure.md`](../../references/executor-structure.md) + [`topology-assembly.md`](../../references/topology-assembly.md) at the first `Structure = yes`, [`native-shape-authoring.md`](../../references/native-shape-authoring.md) at the first contour beyond basic primitives, [`svg-effects.md`](../../references/svg-effects.md) at the first visual job beyond the everyday block; installed Layout/Deck structure adds [`pptx-structure-interface.md`](../../references/pptx-structure-interface.md). Keep the selected mode/style files: a custom applies one basis under its behavior, synthesizes several by their contributions, or follows the behavior alone. When any image exists, read [`executor-image.md`](../../references/executor-image.md) and [`svg-image-embedding.md`](../../references/svg-image-embedding.md) once before the first affected page (plus [`executor-web-image.md`](../../references/executor-web-image.md) for a `Sourced` image); reread anything only after a known file change or context invalidation.`executor-base.md` binds Quick exactly as it binds Default except its `Default only` items — the persisted-plan handoff in §2 / §2.1, the `Generation rhythm` and first-page gate, and §6 — which Quick's transient §2 anchors, single final checker, and export below own. Conditional authorities load on its routing table (Chart/Table branches, native data, formula, hyperlink); Chart/Table reference and final information model are independent signals, and selection never makes an object native-ready. Explicit user/template requirements and the resolved style override compatible aesthetic defaults, never technical boundaries, carrier eligibility, or native capability discovery.