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
fix(executor): enforce planned content and image layouts
hugohe3df0bfcafbf9c
diff --git a/skills/ppt-master/references/artifact-ownership.md b/skills/ppt-master/references/artifact-ownership.mdindex 2990a7a2..b3c26fce 100644--- a/skills/ppt-master/references/artifact-ownership.md+++ b/skills/ppt-master/references/artifact-ownership.md@@ -10,7 +10,7 @@ Global artifact ownership rules for PPT Master projects.| Artifact | Owner | Role | Read/write contract ||---|---|---|---|-| `sources/` content-type files | Content contract | Main pipeline source for text, tables, chart data values, and SmartArt node wording | Strategist reads content-type files (`.md` / `.markdown` / `.txt` / `.csv` / `.tsv` / `.json` / `.jsonl` / `.yaml` / `.yml`) and judges by content; do not replace values with PPTX geometry JSON in the main pipeline |+| `sources/` content-type files | Content contract | Main pipeline factual/text origin for tables, chart data values, SmartArt node wording, and presentation content | Strategist reads content-type files (`.md` / `.markdown` / `.txt` / `.csv` / `.tsv` / `.json` / `.jsonl` / `.yaml` / `.yml`), judges by content, and resolves approved on-slide wording into §IX. Executor opens source passages only for explicit verification/resolution; do not replace values with PPTX geometry JSON in the main pipeline. || `sources/*.facts.json` | Fact provenance contract | Stable external `fact_id` → claim/source mapping created by topic research | Strategist cites IDs in §IX; Executor resolves them for visible footnotes / natural notes attribution. Scenario data never enters this file. || `sources/` converted-source originals | Source archive | Imported source files that have a converted content contract (`.pdf` / `.pptx` / `.docx` / `.xlsx` / `.html` / `.epub` / `.tex` / `.rst` / `.ipynb` / `.typ`, etc.) and source-adjacent extracted assets | Read via the converted `<stem>.md` in the main pipeline; direct-PPTX workflows read the `.pptx` by route || `sources/*.conversion_profile.json`, `sources/*_files/image_manifest.json` | Pipeline sidecar | Conversion audit record / asset index | NOT read as slide content; open only to audit a conversion or resolve assets |@@ -18,7 +18,7 @@ Global artifact ownership rules for PPT Master projects.| `analysis/<stem>.identity.json` | Native deck identity facts | Canvas, theme palette/fonts, observed usage | Read selectively when detailed identity facts are needed || `analysis/<stem>.slide_library.json` | Native PPTX structure facts | Text slots, geometry, native tables, native chart caches, SmartArt nodes/connections | Direct PPTX workflows use as native fill/structure contract || `analysis/image_analysis.csv` | Regenerated image fact view | Measured facts about the current `images/` folder | Re-run `analyze_images.py` before reading image facts after changes |-| `design_spec.md` | Strategist design authority | Human-readable design intent, outline, rationale, resource plan, and confirmed production mechanics authored from the final confirmation plus source analysis | Strategist consumes the final confirmation once, writes and audits every confirmed field here, then later roles read this artifact instead of reopening `result.json` |+| `design_spec.md` | Strategist design authority | Human-readable design intent, final page wording, rationale, resource plan, and confirmed production mechanics authored from the final confirmation plus source analysis | Strategist consumes the final confirmation once, writes and audits every confirmed field here, then later roles read this artifact instead of reopening `result.json`; after Gate 1, §IX is the Executor's page-content authority. || `spec_lock.md` | Execution anchor and routing contract | Machine-readable stable color/type roles, icons, images, page rhythm, charts, `template_reuse_scope`, and the route's PowerPoint structure mode; mirror/layout template routes additionally own input prototypes, the Master roster, and the complete page-to-Master/Layout mapping | Strategist authors the route-specific anchors from the audited Design Spec plus current project/page/template context. `page-context` repeats that compact anchor set per page and adds current-page routing values. Sparse page-local color/font garnish needs no lock row; a recurring semantic role or new adaptive Layout identity requires Strategist repair before reuse. || `project_manager.py page-context` stdout | Derived per-page context | Read-only model-facing anchor set + current-page delta + fingerprints for large references | Generate immediately before each page without `--bundle`; never edit or persist it as a replacement source of truth. `global` is the bounded repeated anchor set, not a whitelist of every valid page-local value. `reference_set` carries path/SHA/load policy for project/template Design Specs and selected prototype/chart SVGs, but never appends their payloads. || `analysis/page-context/P<NN>.usage.json` | Derived context telemetry | Actual compact page-context size plus hashes of owning inputs/references | `page-context --record-usage` deterministically replaces that page's snapshot; `page-context-report` summarizes current snapshots and unique references. Use token data to evaluate context cost, never as content or an execution contract. |@@ -51,7 +51,7 @@ Global artifact ownership rules for PPT Master projects.| Invariant | Rule ||---|---|-| Content values | Main pipeline text, tables, chart values, and SmartArt node wording come from content-type files in `sources/` (`.md` / `.markdown` / `.txt` / `.csv` / `.tsv` / `.json` / `.jsonl` / `.yaml` / `.yml`), not from `slide_library.json`. |+| Content authority | Content-type files in `sources/` (`.md` / `.markdown` / `.txt` / `.csv` / `.tsv` / `.json` / `.jsonl` / `.yaml` / `.yml`) own the factual/text origin for main-pipeline content, tables, chart values, and SmartArt node wording; Strategist resolves approved on-slide wording into §IX. Executor renders §IX and opens sources only for explicit verification/resolution, never to draft a second outline. `slide_library.json` does not own content values. || Sources read policy | In `sources/`, read content-type files (`.md` / `.markdown` / `.txt` / `.csv` / `.tsv` / `.json` / `.jsonl` / `.yaml` / `.yml`) and judge by content — a `.json` / `.csv` may be core content or just data. Exclude known sidecars: `*.conversion_profile.json` and `*_files/image_manifest.json`. `analysis/` facts (`source_profile.json`, `<stem>.slide_library.json`) are read per Step 4 / direct-PPTX workflow, not in the `sources/` content scan. || PPTX structure | `slide_library.json` owns native geometry, slot facts, and SmartArt layout/relationships for direct PPTX workflows. || Design contract | Final confirmation is read once → complete audited `design_spec.md` → context-authored `spec_lock.md` anchors/routing. Executor may apply projected `Template Application` prose to visible template content, but never replace confirmed identity with an independent direction. On divergence, repair the lock from the Design Spec/current context unless the Design Spec itself fails confirmation fidelity. |diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex 0af413c2..9fcbcb52 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -9,7 +9,7 @@ Always-loaded Executor authority for flat SVG page authoring and behavior shared| `pptx_structure.mode: structured` | [`executor-structured.md`](./executor-structured.md) || Any data chart, chart catalog selection, or text-grid table | [`executor-chart.md`](./executor-chart.md) || A page will use a preset pattern fill or evaluate native chart/table replacement | [`native-data-interface.md`](./native-data-interface.md) before deciding eligibility or emitting metadata |-| Any image or formula resource, including template-bundled images | [`executor-image.md`](./executor-image.md) |+| Any image or formula resource, including template-bundled images | [`executor-image.md`](./executor-image.md) + [`image-layout-patterns.md`](./image-layout-patterns.md) || Any `Status: Sourced` web image | [`executor-web-image.md`](./executor-web-image.md), after `executor-image.md` || Speaker notes generation after all SVG pages pass | [`executor-notes.md`](./executor-notes.md) |@@ -63,7 +63,7 @@ python3 skills/ppt-master/scripts/project_manager.py page-context <project_path>Use named lock roles literally when that role applies, and use optional `Template Application` from the retained Design Spec. Choose contextual page-local values from the Design Spec, style, content, and current composition rather than forcing every object into a lock row. The delta overrides neither facts nor constraints. After an approved change, rerun the command and reload only changed references. Deprecated `--bundle` is a compatibility no-op.-**Source facts**: The page delta carries page intent and routing facts, not the complete source corpus. Read the relevant `sources/` content and resolve listed `Fact IDs` from `sources/*.facts.json` when the page needs concrete claims, quotes, names, or data.+**Source verification**: `design_spec.md §IX` owns the final page wording; the page delta does not carry the complete source corpus. Read relevant `sources/` content only to resolve listed `Fact IDs` or verify exact claims, quotes, names, or data already required by the current §IX block. Do not enrich, expand, or substitute the authored content. An underspecified §IX block is an upstream defect; return for Design Spec repair.**Per-page communication trace**: Read `communication.objective`, `communication.core_message`, and the current §IX `Core message` + `Audience move` before choosing composition. The page must advance the compact objective and move the audience as authored in §IX; the global core message remains the deck-wide north star. A page that cannot state this movement is an upstream outline defect — surface `warning: P<NN> has no communication move` instead of compensating with decorative layout. Do not invent a new purpose, ask, or outcome at execution time. Structural pages may advance the contract by establishing relevance / tension / decision frame or by completing the final commitment; they are not exempt from having a reason to exist.diff --git a/skills/ppt-master/references/executor-image.md b/skills/ppt-master/references/executor-image.mdindex 15cb15e8..fba7b468 100644--- a/skills/ppt-master/references/executor-image.md+++ b/skills/ppt-master/references/executor-image.md@@ -23,7 +23,7 @@ Handle images by their status in the Design Spec's Image Resource List. Status e**Template-bundled images**: [`apply-template-workspace.md`](../workflows/stages/apply-template-workspace.md) copies them into project `images/`. Outside `mirror`, reference `../images/<name>` and never copy a template SVG's bare sibling href: the rendered page lives in `svg_output/`. `mirror` ([`executor-structured.md`](./executor-structured.md) §1.1) keeps hrefs verbatim; export resolves them against `images/`.-**Selected pattern, flexible realization**: Preserve the row's primary/modifier ids and semantic composition. Adapt geometry, ratio, placement, spacing, and hierarchy for the actual page; never replace the pattern, role, file/source, must-use, or crop policy downstream. If another pattern is needed, return upstream to update the Design Spec. Only explicit user/template preservation locks exact geometry. Avoid generic left/right repetition.+**Mandatory — selected pattern, flexible realization**: Read [`image-layout-patterns.md`](./image-layout-patterns.md) once when this branch loads, then resolve every primary/modifier id in each active §VIII/lock row to its exact catalog entry. Preserve the selected semantic composition. Adapt geometry, ratio, placement, spacing, and hierarchy for the actual page; never replace the pattern, role, file/source, must-use, or crop policy downstream. If another pattern is needed, return upstream to update the Design Spec. Only explicit user/template preservation locks exact geometry. Avoid generic left/right repetition.**Placeholder**: Dashed border `<rect stroke-dasharray="8,4" .../>` + description textdiff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex d3abffe1..42fa9d03 100644--- a/skills/ppt-master/scripts/prompt_audit_manifest.json+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json@@ -20,7 +20,7 @@"skills/ppt-master/references/executor-base.md": 6900,"skills/ppt-master/references/executor-structured.md": 5300,"skills/ppt-master/references/executor-chart.md": 3100,- "skills/ppt-master/references/executor-image.md": 800,+ "skills/ppt-master/references/executor-image.md": 900,"skills/ppt-master/references/executor-web-image.md": 500,"skills/ppt-master/references/executor-notes.md": 900,"skills/ppt-master/references/shared-standards.md": 250,@@ -306,7 +306,7 @@"stage.generate.executor.notes"],"files": [],- "max_tokens": 79400+ "max_tokens": 79600},"route.generate.flat-ai-two-types": {"description": "Generate-PPTX context with AI images, representative multi-source custom rendering, and two local types.",@@ -319,7 +319,7 @@"stage.generate.image.ai-two-types"],"files": [],- "max_tokens": 119500+ "max_tokens": 119700},"route.generate.flat-in-hand-image": {"description": "Generate-PPTX context with provided, placeholder, or formula images and no acquisition role.",@@ -331,7 +331,7 @@"stage.generate.executor.notes"],"files": [],- "max_tokens": 92800+ "max_tokens": 93000},"route.generate.flat-web-image": {"description": "Generate-PPTX context with web image acquisition.",@@ -344,7 +344,7 @@"stage.generate.image.web"],"files": [],- "max_tokens": 100100+ "max_tokens": 100300},"route.enhance-native-pptx.audio": {"description": "Enhance Native PPTX with the shared narration-audio stage.",@@ -364,7 +364,7 @@"profile.generate.beautify-pptx"],"files": [],- "max_tokens": 86200+ "max_tokens": 86400},"route.generate.flat-no-image-chart": {"description": "Default flat Generate-PPTX path with chart authoring, native-data replacement, and verification.",@@ -377,7 +377,7 @@"stage.generate.verify-charts"],"files": [],- "max_tokens": 103200+ "max_tokens": 103400},"route.generate.brand-flat-no-image": {"description": "Brand-preset flat Generate-PPTX path without image acquisition.",@@ -389,7 +389,7 @@"stage.generate.template.brand"],"files": [],- "max_tokens": 86400+ "max_tokens": 86600},"route.generate.deck-structured-no-image": {"description": "Deck-preset structured Generate-PPTX path without image acquisition.",@@ -401,7 +401,7 @@"stage.generate.template.deck"],"files": [],- "max_tokens": 96300+ "max_tokens": 96500},"route.generate.layout-structured-no-image": {"description": "Layout-preset structured Generate-PPTX path without image acquisition.",@@ -413,7 +413,7 @@"stage.generate.template.layout"],"files": [],- "max_tokens": 96800+ "max_tokens": 97000},"route.generate.topic-only-flat-no-image": {"description": "Topic research followed by the default flat no-image Generate-PPTX path.",@@ -423,7 +423,7 @@"route.generate.flat-no-image"],"files": [],- "max_tokens": 80800+ "max_tokens": 81000},"stage.generate.executor.flat": {"description": "Incremental flat Executor core with representative multi-source custom mode/style execution.",@@ -533,7 +533,7 @@"stage.generate.executor.image"],"files": [],- "max_tokens": 56500+ "max_tokens": 57700},"stage.generate.topic-research": {"description": "Gap-targeted factual intake stage.",@@ -661,7 +661,7 @@"stage.generate.strategist.template"],"files": [],- "max_tokens": 57900+ "max_tokens": 58100},"route.generate.planning-template-ai": {"description": "Explicit template workspace plus confirmed AI-image planning.",@@ -671,7 +671,7 @@"route.generate.planning-ai"],"files": [],- "max_tokens": 70100+ "max_tokens": 70200},"stage.generate.executor.chart": {"description": "Conditional chart/table page execution rules.",@@ -721,10 +721,11 @@"scope": "incremental","files": ["skills/ppt-master/references/executor-image.md",+ "skills/ppt-master/references/image-layout-patterns.md","skills/ppt-master/references/image-layout-spec.md","skills/ppt-master/references/svg-image-embedding.md"],- "max_tokens": 5600+ "max_tokens": 11600},"stage.generate.executor.web-image": {"description": "Conditional sourced-image attribution layered on image execution.",@@ -735,7 +736,7 @@"files": ["skills/ppt-master/references/executor-web-image.md"],- "max_tokens": 6100+ "max_tokens": 12000},"stage.generate.executor.notes": {"description": "Post-SVG speaker-notes generation rules.",diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.mdindex 27e6e0de..291e3627 100644--- a/skills/ppt-master/workflows/generate-pptx.md+++ b/skills/ppt-master/workflows/generate-pptx.md@@ -335,6 +335,8 @@ Workflow:**Exact page roster**: render `design_spec.md §IX` one-for-one, in order. Any add/drop/merge/split/reorder requires Spec repair/refinement first.+**Exact page content**: render each §IX `Title` / `Core message` / `Content` field as the approved final wording. Read sources only to resolve or verify evidence already requested by that block; never use execution to enrich or rewrite an incomplete outline. Return an incomplete block to Step 4 for Design Spec repair.+**Artifact ownership**: `svg_output/` is the author source, `svg_final/` is derived, and image facts come from the regenerated `analysis/image_analysis.csv`; see [`references/artifact-ownership.md`](../references/artifact-ownership.md).Read the execution references for this deck's locked `mode` + `visual_style` (from `spec_lock.md`):@@ -353,7 +355,7 @@ Read references/visual-styles/<resolved-id>.md # one preset id, or each `visu| `pptx_structure.mode: structured` | `executor-structured.md` + `pptx-structure-interface.md` || Any data chart/table, including mini or inset charts and sparklines | `executor-chart.md` || Preset pattern or supported native chart/table | `native-data-interface.md` before drawing |-| `spec_lock.md images` or §VIII contains at least one image/formula row, or an active template carries bundled images | `executor-image.md` + `image-layout-spec.md` + `svg-image-embedding.md` |+| `spec_lock.md images` or §VIII contains at least one image/formula row, or an active template carries bundled images | `executor-image.md` + `image-layout-patterns.md` + `image-layout-spec.md` + `svg-image-embedding.md` || At least one placed image has `Status: Sourced` | `executor-web-image.md` after the image branch || The locked style/current page calls for noncanonical or alpha paint, dash/cap/join, tracking/decoration/outline, gradient/filter/glow/shadow, path/transform/clipping, or another constructed effect | `svg-effects.md` before authoring that value or effect || A page calls for a literal PowerPoint stock shape | `native-shape-authoring.md` before selecting or emitting that shape |diff --git a/skills/ppt-master/workflows/stages/resume-execute.md b/skills/ppt-master/workflows/stages/resume-execute.mdindex 473aa05d..32a3e6fa 100644--- a/skills/ppt-master/workflows/stages/resume-execute.md+++ b/skills/ppt-master/workflows/stages/resume-execute.md@@ -60,9 +60,9 @@ Then jump to `### Step 6: Executor Phase` and run the documented pipeline:Reload the Generate authority and required execution references; do not reconstruct or replay the earlier planning conversation.-**Source materials**: the execution session is fresh; `<project_path>/sources/<file>.md` is NOT in context. The Executor SHOULD read the relevant `sources/` files when crafting per-page content — they hold the concrete facts, quotes, names, and details that turn skeleton outlines into substantive slides. `design_spec.md §IX` only carries the per-page intent; the source materials carry the texture.+**Source verification**: the execution session is fresh, but `design_spec.md §IX` already owns the complete approved page wording. Read only the relevant `sources/` passages needed to resolve explicit `Fact IDs` / source references or verify exact facts, quotes, names, and data already required by the current §IX block. Never turn §IX back into a skeleton, add new claims or details, or independently rewrite its content. If §IX lacks executable wording or evidence, stop and return to Generate Step 4 for Design Spec repair.-> Note: this stage does NOT duplicate Step 6 / Step 7 content. `generate-pptx.md` is the authoritative procedure; resume-execute only adds the resumption entry, sanity check, and source-materials guidance.+> Note: this stage does NOT duplicate Step 6 / Step 7 content. `generate-pptx.md` is the authoritative procedure; resume-execute only adds the resumption entry, sanity check, and source-verification guidance.---