Skip to content

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,checker): absence needs a reason — effect facts in the carrier receipt, a final-review checkpoint, premium device rows; review fixes

hugohe3c32c4d9b2f77
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index 68d9e449..b4b50279 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -62,6 +62,10 @@ Read this before §1: the expression vocabulary every page draws from — what e
| Timeline or step strip | Ordered events or stages | Baseline `<line>` with ticks/nodes, or chevron presets, labels above/below |
| Process or decision diagram | Flow, branch, input → output, cycle | Flowchart / block-arrow / chevron presets as nodes and direction, `<line>` or connector presets between them, labels native |
| Callout or annotation | A remark attached to an object or region | Callout preset, bracket, or leader line + short native text |
+| Display text with gradient or glow | Hero number, cover word, or chapter numeral that should read luminous or material | Text `fill="url(#…)"` or `filter="url(#titleGlow)"` on that one element; body copy never ([`svg-effects.md`](./svg-effects.md) §6.7 / §6.4) |
+| Accent gradient rule or band | Title underline, section marker, KPI baseline carrying the deck hue with direction | 2–4 px `<rect>` / `<line>` filled by a 2-stop primary → accent gradient |
+| Elevated primary object | The one card, image, or CTA that sits above the page | `softShadow` at resting opacity on that object; peers stay flat |
+| Duotone or brand-wash image | A photo that must join the deck palette instead of fighting it | Wash gradient over the picture, or a prepared duotone derivative ([`svg-effects.md`](./svg-effects.md) §6.5 / §6.12) |
**Reference — layout structures (starting points; proportion follows information weight)**: 16:9 values for 1280×720 — safe area 1200×640 with 40 px margins; title band ≈ 100 px, content field ≈ 500 px, footer ≈ 40 px.
@@ -149,7 +153,9 @@ Executor receives the plan and builds on it: Default reads the retained `design_
**Per-page reading-mode check**: apply `communication.consumption_mode` with the §IX block texture and `page_rhythm` — `text`: the visible page stands alone (complete prose, explicit labels / captions / sources, tables, necessary detail); `balanced`: the primary claim and its evidence on the page, enabled notes adding interpretation and transitions; `presentation`: one claim and one dominant visual legible at projection distance, concise copy, enabled notes carrying explanation — and with notes disabled never omit required content on the assumption that notes carry it. Never drop or invent facts to force a mode; when the authored texture materially conflicts with the lock, render the least-destructive faithful composition and surface `warning: P<NN> content texture conflicts with consumption_mode <value>` (a judgment, not a checker rule).
-**Default — authored texture (may override when information-equivalent)**: start from each §IX block's written texture (`complete`) or expand its block phrasing (`brief`) under the reading mode. Keep prose where continuity carries cause, argument, narrative, qualification, or emphasis; use bullets or keywords only for genuinely parallel or ordered material or a clearer information-equivalent structure — never because a list is easier to lay out or a template exposes a list slot. One `<text>` per prose paragraph with positioned `<tspan>` line breaks, never sibling `<text>` elements ([`shared-standards-core.md`](./shared-standards-core.md) §4.2). An inherited slot never overrides the content relationship — widen, reflow, or drop the card before converting prose to fill a list slot; the locked mode shapes voice and register, not §IX's authored titles or page order (a user-authored topic label stays a label even when the mode favors assertions). Block-level phrasing applies *within* the page's `page_rhythm` density, not against it.
+**Default — authored texture (may override when information-equivalent)**: start from each §IX block's written texture (`complete`) or expand its block phrasing (`brief`) under the reading mode. Keep prose where continuity carries cause, argument, narrative, qualification, or emphasis; use bullets or keywords only for genuinely parallel or ordered material or a clearer information-equivalent structure — never because a list is easier to lay out or a template exposes a list slot. An inherited slot never overrides the content relationship — widen, reflow, or drop the card before converting prose to fill a list slot; the locked mode shapes voice and register, not §IX's authored titles or page order (a user-authored topic label stays a label even when the mode favors assertions). Block-level phrasing applies *within* the page's `page_rhythm` density, not against it.
+
+**Hard rule — one paragraph, one text frame**: one `<text>` per prose paragraph with positioned `<tspan>` line breaks, never sibling `<text>` elements ([`shared-standards-core.md`](./shared-standards-core.md) §4.2); start from its leading ranges, then adjust for typeface, reading distance, explicit requirements, and locked style.
**Execution anchors and contextual values**:
diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.md
index 4663f434..d3f41930 100644
--- a/skills/ppt-master/scripts/docs/svg-pipeline.md
+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md
@@ -885,7 +885,7 @@ Behavior:
- 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.
- Formal default and `--quick-generate` release export compute the exact SVG source fingerprint and refuse a missing, unreadable, unsupported, non-final, blocking, stale, or unverifiable final quality report before PPTX creation. A project without `validation/svg_quality_report.json` exits nonzero with the `not-provided` gate status; run the final checker against its current `svg_output/` first. An explicit non-`output` `--source` remains outside this release gate. Dangerous compatibility export also stays outside it even when reading the default `svg_output/`: it automatically writes a conversion trace, marks postflight `passed-with-warnings`, and records its normalization count; it never claims that the source passed the normal authoring quality gate.
-- The final quality report carries an informational `carrier_receipt` aggregate plus each page's `files[].info.carrier_receipt`: actual text/image/icon counts, SVG geometry, native preset names, marker use, native Chart/Table/Formula markers, and largest image-frame share. The terminal prints only the compact aggregate. These facts never affect exit status, create coverage quotas, or score design; the active Generate profile compares them with its retained page decisions before export.
+- The final quality report carries an informational `carrier_receipt` aggregate plus each page's `files[].info.carrier_receipt`: actual text/image/icon counts, SVG geometry, native preset names, marker use, native Chart/Table/Formula markers, largest image-frame share, and effect use. `effects.inline_emphasis_runs` counts `<tspan>` elements inside `<text>` with no `x`/`y`/`dx`/`dy` that set `fill`, `font-weight`, `font-size`, `font-style`, `text-decoration`, or `letter-spacing`; `effects.gradient_uses` counts visible fill/stroke references that resolve to same-document linear/radial gradients; `effects.filter_uses` counts visible filter references that resolve to same-document filters; and `effects.text_effects` counts visible `<text>`/`<tspan>` elements with gradient/pattern paint, a filter, or a non-`none` stroke. Content inside `defs`, `clipPath`, `mask`, `pattern`, `marker`, or `symbol` is excluded. The terminal prints only the compact aggregate. These facts never affect exit status, create coverage quotas, or score design; the active Generate profile compares them with its retained page decisions before export.
- 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.
- 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.
diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.json
index 8a3814a9..b9cc3dc8 100644
--- a/skills/ppt-master/scripts/prompt_audit_manifest.json
+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json
@@ -421,7 +421,7 @@
"max_tokens": 150000
},
"route.generate.planning-image": {
- "description": "Generate-PPTX planning context after a non-none image source is proposed or confirmed; image decision and layout authorities are already in the fixed planning context. Ceiling raised after BUDGET_LOAD_SET reported 116384 tokens.",
+ "description": "Generate-PPTX planning context after a non-none image source is proposed or confirmed; the image decision authority is already in the fixed planning context (image-layout files are Executor's). Ceiling raised after BUDGET_LOAD_SET reported 116384 tokens.",
"scope": "cumulative",
"include": [
"route.generate.planning"
@@ -2066,7 +2066,7 @@
{
"path": "skills/ppt-master/references/executor-base.md",
"role": "consumer",
- "fingerprint": "098225552ea9",
+ "fingerprint": "b63e7a4de45e",
"reason": "This consumer needs the field contract for deterministic execution."
},
{
diff --git a/skills/ppt-master/scripts/svg_quality/checker.py b/skills/ppt-master/scripts/svg_quality/checker.py
index 923f68d5..28e5b442 100644
--- a/skills/ppt-master/scripts/svg_quality/checker.py
+++ b/skills/ppt-master/scripts/svg_quality/checker.py
@@ -2410,6 +2410,7 @@ class SVGQualityChecker:
'text_elements': text_count,
'images': image_receipt,
'icons': icon_count,
+ 'effects': self._carrier_effect_receipt(root, parent_by_id),
'geometry': {
'svg_elements': dict(geometry_counts),
'preset_shapes': sum(preset_names.values()),
@@ -2420,6 +2421,139 @@ class SVGQualityChecker:
'native_objects': dict(native_objects),
}
+ @classmethod
+ def _carrier_effect_receipt(
+ cls,
+ root: ET.Element,
+ parent_by_id: Dict[int, ET.Element],
+ ) -> Dict:
+ """Count factual visible effect declarations and resolved references."""
+ ignored_tags = frozenset({
+ 'clippath',
+ 'defs',
+ 'marker',
+ 'mask',
+ 'pattern',
+ 'symbol',
+ })
+ emphasis_properties = (
+ 'fill',
+ 'font-weight',
+ 'font-size',
+ 'font-style',
+ 'text-decoration',
+ 'letter-spacing',
+ )
+ definition_kinds: Dict[str, str] = {}
+ for element in root.iter():
+ definition_id = (element.get('id') or '').strip()
+ if definition_id:
+ definition_kinds[definition_id] = _local_name(element).casefold()
+
+ def declared_value(
+ element: ET.Element,
+ style_values: Dict[str, str],
+ name: str,
+ ) -> str | None:
+ if name in style_values:
+ return style_values[name]
+ return element.get(name)
+
+ def reference_kind(value: str | None) -> str:
+ match = re.fullmatch(
+ r'url\(\s*#([^)]+?)\s*\)',
+ (value or '').strip(),
+ re.IGNORECASE,
+ )
+ return definition_kinds.get(match.group(1), '') if match else ''
+
+ def has_ignored_ancestor(element: ET.Element) -> bool:
+ current: ET.Element | None = element
+ while current is not None and current is not root:
+ if _local_name(current).casefold() in ignored_tags:
+ return True
+ current = parent_by_id.get(id(current))
+ return False
+
+ effects = Counter({
+ 'inline_emphasis_runs': 0,
+ 'gradient_uses': 0,
+ 'filter_uses': 0,
+ 'text_effects': 0,
+ })
+ gradient_kinds = {'lineargradient', 'radialgradient'}
+ text_paint_kinds = gradient_kinds | {'pattern'}
+
+ for element in root.iter():
+ if (
+ element is root
+ or has_ignored_ancestor(element)
+ or cls._has_non_visual_ancestor(element, root, parent_by_id)
+ or cls._is_hidden_element(element, parent_by_id)
+ or cls._has_zero_opacity(element, parent_by_id)
+ ):
+ continue
+
+ style_values = (
+ _parse_inline_style(element.get('style'))
+ if _parse_inline_style is not None
+ else {}
+ )
+ fill_kind = reference_kind(
+ declared_value(element, style_values, 'fill')
+ )
+ raw_stroke = declared_value(element, style_values, 'stroke')
+ stroke_kind = reference_kind(raw_stroke)
+ effects['gradient_uses'] += sum(
+ kind in gradient_kinds for kind in (fill_kind, stroke_kind)
+ )
+
+ raw_filter = declared_value(element, style_values, 'filter')
+ if reference_kind(raw_filter) == 'filter':
+ effects['filter_uses'] += 1
+
+ tag = _local_name(element).casefold()
+ if tag == 'tspan':
+ current = parent_by_id.get(id(element))
+ inside_text = False
+ while current is not None:
+ if _local_name(current).casefold() == 'text':
+ inside_text = True
+ break
+ current = parent_by_id.get(id(current))
+ if (
+ inside_text
+ and not any(
+ element.get(name) is not None
+ for name in ('x', 'y', 'dx', 'dy')
+ )
+ and any(
+ name in style_values or element.get(name) is not None
+ for name in emphasis_properties
+ )
+ ):
+ effects['inline_emphasis_runs'] += 1
+
+ if tag in {'text', 'tspan'}:
+ has_filter = (
+ 'filter' in style_values
+ or element.get('filter') is not None
+ )
+ has_stroke = bool(
+ raw_stroke
+ and raw_stroke.strip()
+ and raw_stroke.strip().casefold() != 'none'
+ )
+ if (
+ fill_kind in text_paint_kinds
+ or stroke_kind in text_paint_kinds
+ or has_filter
+ or has_stroke
+ ):
+ effects['text_effects'] += 1
+
+ return dict(effects)
+
@staticmethod
def _carrier_native_replacement_kind(element: ET.Element) -> str:
"""Return one native replacement kind without turning bad data into a check."""
@@ -8638,6 +8772,10 @@ class SVGQualityChecker:
'preset_shapes': 0,
'page_frame_elements': 0,
'marker_uses': 0,
+ 'inline_emphasis_runs': 0,
+ 'gradient_uses': 0,
+ 'filter_uses': 0,
+ 'text_effects': 0,
})
pages_with = Counter({
'images': 0,
@@ -8646,6 +8784,10 @@ class SVGQualityChecker:
'charts': 0,
'tables': 0,
'formulas': 0,
+ 'inline_emphasis_runs': 0,
+ 'gradient_uses': 0,
+ 'filter_uses': 0,
+ 'text_effects': 0,
})
geometry_counts: Counter[str] = Counter()
preset_names: Counter[str] = Counter()
@@ -8656,6 +8798,7 @@ class SVGQualityChecker:
images = receipt['images']
geometry = receipt['geometry']
native = receipt['native_objects']
+ effects = receipt.get('effects', {})
totals['text_elements'] += receipt['text_elements']
totals['image_placements'] += images['placements']
totals['icons'] += receipt['icons']
@@ -8679,6 +8822,16 @@ class SVGQualityChecker:
pages_with['tables'] += 1
if native.get('formula_block') or native.get('formula_inline'):
pages_with['formulas'] += 1
+ for name in (
+ 'inline_emphasis_runs',
+ 'gradient_uses',
+ 'filter_uses',
+ 'text_effects',
+ ):
+ count = effects.get(name, 0)
+ totals[name] += count
+ if count > 0:
+ pages_with[name] += 1
totals['svg_geometry_elements'] = sum(geometry_counts.values())
frame_share_range = (
@@ -8717,6 +8870,17 @@ class SVGQualityChecker:
f"page-frame elements {totals['page_frame_elements']} | "
f"marker uses {totals['marker_uses']}"
)
+ pages_with = receipt['pages_with']
+ print(
+ f" Effects: inline emphasis {totals['inline_emphasis_runs']} "
+ f"(pages {pages_with['inline_emphasis_runs']}) | "
+ f"gradients {totals['gradient_uses']} "
+ f"(pages {pages_with['gradient_uses']}) | "
+ f"filters {totals['filter_uses']} "
+ f"(pages {pages_with['filter_uses']}) | "
+ f"text effects {totals['text_effects']} "
+ f"(pages {pages_with['text_effects']})"
+ )
print(
f" Native objects: charts {native.get('chart', 0)} | "
f"tables {native.get('table', 0)} | formulas "
diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.md
index fb3197f2..fcf9f99b 100644
--- a/skills/ppt-master/workflows/generate-pptx.md
+++ b/skills/ppt-master/workflows/generate-pptx.md
@@ -112,7 +112,7 @@ Read ${SKILL_DIR}/templates/charts/chart-vocabulary.md
Read ${SKILL_DIR}/templates/tables/table-vocabulary.md
```
-This is a capability map, not a usage checklist. Author the three whole-solution intents first, freeze every mode/style/rendering id from the indexes, then read once only the deduplicated union of those detail files; a novel custom reads none. Confirmed non-`none` image sources continue into resource planning with the loaded layout references; confirmed `none` writes no image rows but keeps the rendering candidates.
+This is a capability map, not a usage checklist. Author the three whole-solution intents first, freeze every mode/style/rendering id from the indexes, then read once only the deduplicated union of those detail files; a novel custom reads none. Confirmed non-`none` image sources continue into resource planning under `strategist-image.md` (the image-layout files are Executor's); confirmed `none` writes no image rows but keeps the rendering candidates.
**Fact channels** ([`artifact-ownership.md`](../references/artifact-ownership.md) §1–2): before Stage 1 read `analysis/source_profile.json`'s `decks[]` digests, opening a deck's identity/slide-library files only when raw facts are needed. Content — text, tables, chart values, SmartArt wording — comes from the content-type files in `sources/` (`<stem>.md` and archived `.txt` / `.csv` / `.json` / `.yaml`), never from the digest; `*.conversion_profile.json` and `*_files/image_manifest.json` are sidecars. A source deck's identity is reference, not constraint. If the user provided images, run `python3 ${SKILL_DIR}/scripts/analyze_images.py <project_path>/images` before the Design Spec and read `analysis/image_analysis.csv` before §VIII; the CSV is a regenerated view of `images/` — rerun after any change, never treat it as a store. Never bulk-open images: Strategist inspects one specifically ambiguous asset under [`strategist-image.md`](../references/strategist-image.md) and records the result in §VIII; Executor inspects one `Existing` / `Sourced` asset only for crop, focal placement, or text contrast.
@@ -279,7 +279,7 @@ python3 ${SKILL_DIR}/scripts/svg_quality_checker.py <project_path> \
- Every `warning` is advisory — no mandatory modification, no auto-normalizing user syntax, no disposition line; structured-template warnings (empty/framing-only Layout, bare Master, duplicate layout keys) guide optional cleanup only. A condition that must be corrected before release is an `error`.
- **Hard rule — token-safe report handling**: on success use the exit status and terminal summary; never `cat` the complete JSON into context. Read it only for failure investigation, an explicit audit, or a field absent from stdout.
-**Mandatory — final carrier-receipt review**: compare the checker's `[CARRIERS]` summary (detail under `files[].info.carrier_receipt`) with the retained page jobs, resource roles, and running geometry signatures. Counts and diversity are not quotas; when the facts contradict an active decision — an adopted preset absent, a directional / step / flowchart relationship drawn as a hand path or polygon where `executor-base.md` §3.0 names a preset, a primary image reduced to a minor frame, unrelated jobs collapsing to one neutral construction — read only the affected rows, repair those pages in one pass, and rerun the final checker.
+**Mandatory — final carrier-receipt review**: compare the checker's `[CARRIERS]` summary (detail under `files[].info.carrier_receipt`) with the retained page jobs, resource roles, and running geometry signatures. Counts and diversity are not quotas; when the facts contradict an active decision — an adopted preset absent, a directional / step / flowchart relationship drawn as a hand path or polygon where `executor-base.md` §3.0 names a preset, a primary image reduced to a minor frame, unrelated jobs collapsing to one neutral construction — read only the affected rows, repair those pages in one pass, and rerun the final checker. **Absence needs a reason**: when the receipt shows a deck-wide zero — `Presets: (none)`, or `inline emphasis 0`, `gradients 0`, or `filters 0` on the `Effects:` line — or fewer pages carrying a preset or connector than pages whose §IX `Relationships` line names `order` / `link` / `parent` / `membership`, answer one line per absent family or per such page: what carries that job instead, and why it serves the reader better. The style, speed, restraint, "text was enough", or "it is editable anyway" are not answers; a family or page without one is repaired where the page job calls for it, then the checker reruns. Choosing not to use a device is valid — only an unstated reason is not.
**Logic Construction Phase (conditional)**: when the effective Speaker Notes outcome in §I is enabled, load [`executor-notes.md`](../references/executor-notes.md): validate a frozen `notes/total.md` against every information-bearing final SVG group (repair the page or the plan, never the script), or otherwise ground each page's narration in its final SVG and write `notes/total.md`. When disabled, load nothing and create no notes.
diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.md
index 29c2c867..6e8afb20 100644
--- a/skills/ppt-master/workflows/profiles/quick-generate.md
+++ b/skills/ppt-master/workflows/profiles/quick-generate.md
@@ -159,7 +159,7 @@ This menu never satisfies the per-page Structure decision in §3.
## 3. Direct SVG Authoring
-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.
+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 the complete `Any image` row of `executor-base.md`'s routing table — [`executor-image.md`](../../references/executor-image.md), [`image-layout-spec.md`](../../references/image-layout-spec.md), [`image-layout-patterns.md`](../../references/image-layout-patterns.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 and the export hand-off in §6 — which Quick's transient §2 anchors, single final checker, and export below own; the Default gate cadence lives in `generate-pptx.md` Step 6 and does not apply. 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.
@@ -192,7 +192,7 @@ python3 ${SKILL_DIR}/scripts/svg_quality_checker.py <project_path> \
--quick-generate --canonical-authoring --stage final --json
```
-**Mandatory — final carrier-receipt review**: compare the `[CARRIERS]` summary with the retained page jobs, deck shape language, motif, resource roles, and geometry signatures. Counts are not quotas; when the facts contradict an active decision — an adopted preset absent, a directional / step / flowchart relationship drawn as a hand path or polygon where `executor-base.md` §3.0 names a preset, a primary image reduced to a minor frame — read only the affected `files[].info.carrier_receipt` rows, repair those pages in one pass, and rerun the checker.
+**Mandatory — final carrier-receipt review**: compare the `[CARRIERS]` summary with the retained page jobs, deck shape language, motif, resource roles, and geometry signatures. Counts are not quotas; when the facts contradict an active decision — an adopted preset absent, a directional / step / flowchart relationship drawn as a hand path or polygon where `executor-base.md` §3.0 names a preset, a primary image reduced to a minor frame — read only the affected `files[].info.carrier_receipt` rows, repair those pages in one pass, and rerun the checker. **Absence needs a reason**: when the receipt shows a deck-wide zero — `Presets: (none)`, or `inline emphasis 0`, `gradients 0`, or `filters 0` on the `Effects:` line — or fewer pages carrying a preset or connector than pages whose transient relationship statement names `order` / `link` / `parent` / `membership`, answer one line per absent family or per such page: what carries that job instead, and why it serves the reader better. The style, speed, restraint, "text was enough", or "it is editable anyway" are not answers; a family or page without one is repaired where the page job calls for it, then the checker reruns. Choosing not to use a device is valid — only an unstated reason is not.
**Notes** (when enabled): load [`executor-notes.md`](../../references/executor-notes.md) after the passing check, validate a frozen script or pre-SVG narration without regenerating it or otherwise generate `notes/total.md` from the final roster, then split: