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

docs(generate): align execution reference loading policy

hugohe32184dd6a13d5
diff --git a/docs/rules/prompt-style.md b/docs/rules/prompt-style.md
index 1bd0f0c3..d9b2b01c 100644
--- a/docs/rules/prompt-style.md
+++ b/docs/rules/prompt-style.md
@@ -75,7 +75,7 @@ Begin substantive paragraphs with a bolded short label. Reuse this fixed vocabul
✅ Good (from `executor-base.md`):
```
**Hard rule**: Before generating **each** SVG page, run:
-`python3 skills/ppt-master/scripts/project_manager.py page-context <project_path> P<NN> --bundle --record-usage`.
+`python3 skills/ppt-master/scripts/project_manager.py page-context <project_path> P<NN> --record-usage`.
**Forbidden — values outside the lock**:
- Colors (fill / stroke / stop-color) MUST come from `colors`
diff --git a/docs/technical-design.md b/docs/technical-design.md
index 815a802f..9d3c9603 100644
--- a/docs/technical-design.md
+++ b/docs/technical-design.md
@@ -165,10 +165,12 @@ analysis/source_profile.json ───┼─> Strategist -> design_spec.md + spe
analysis/image_analysis.csv ────┘
design_spec.md + spec_lock.md + images/ + icons/ + templates/
- └─> project_manager.py page-context <project> P<NN> --bundle
- + [selected complete prototype SVG]
- + [mirror text-slots.v2-min]
+ └─> project_manager.py page-context <project> P<NN>
+ + [bounded repeated lock projection]
+ + [current-page delta]
+ + [Design Spec / prototype / chart path + SHA fingerprints]
├─> Executor -> svg_output/
+ │ ├─> unchanged large references stay in the active context
│ ├─> svg_quality_checker.py -> validation/svg_quality_report.json
│ ├─> finalize_svg.py -> svg_final/
│ └─> svg_to_pptx.py -> exports/<name>_<ts>.pptx + validation/<output_stem>.report.json
@@ -381,9 +383,9 @@ The view omits universal SVG/icon prohibitions already owned by the always-loade
The lock is also the per-page routing table. Beyond global colors and typography, it carries `page_rhythm` (`anchor` / `dense` / `breathing`), `page_charts` (which chart template should be adapted), image rows with placement/cropping contracts, and the locked `mode` / `visual_style` references that decide which execution rule files are loaded. A selected custom direction also carries its resolved `mode_behavior` / `visual_style_behavior`, and page-context projects those fields instead of leaving Executor with only the literal `custom` ids. `template_reuse_scope: mirror|layout` projects additionally carry `page_layouts` (which input template SVG each page inherits), unique `pptx_masters` / `pptx_layouts` definitions, and `page_pptx_layouts` assignments. `template_reuse_scope: style`, free-design, and brand-only projects use `pptx_structure.mode: flat` and omit those sections entirely rather than writing empty values. Empty entries elsewhere are meaningful signals: no chart or no image is often a design decision rather than missing data.
-`page-context --bundle` is route-sensitive: flat pages add no template payload, structured layout pages add the complete selected prototype, and mirror pages add that prototype plus `ppt-master.template-text-slots.v2-min`. Each v2-min slot contains only selector, role, current/segmented text, and tspan count. A top-level tool hash covers selectors plus immutable text/tspan topology and attributes; page-context recomputes it and every projected field from the complete prototype, then strips the hash before model output. Legacy v1 sidecars receive the same compatibility validation and are projected to this shape in memory. The model supplies semantic decisions and replacement text. Checker and structured export validate output attributes, text topology, and resource hashes against the complete prototype internally.
+`page-context v2` separates bounded consistency state from large references. It deliberately repeats the compact global lock projection on every page as an anti-drift guard and binds it to `lock_source.sha256`. The current §IX brief, rhythm, image choice, and template/chart assignment form the page delta. The project/template Design Specs plus selected prototype and `templates/charts/<key>.svg` files appear only as scoped path/SHA fingerprints. Executor reads one of those files only when that fingerprint is absent from the active context or changed, then reuses the retained understanding. Flat pages have no prototype reference; structured pages reference the authoritative complete SVG. Manifests and text-slot sidecars remain derived tool diagnostics and are never injected into page authoring.
-`--record-usage` requires `--bundle` and writes a derived, input-hashed snapshot for that page under `analysis/page-context/`; expected-but-absent optional inputs are recorded so later artifact creation also makes the snapshot stale. Token counting lazily uses `o200k_base`; a missing `tiktoken` installation records `tokens: null` without blocking execution. `page-context-report` excludes stale snapshots and exposes the measured component totals used to decide whether a future mirror text-patch tool is warranted; no such tool is introduced by this phase.
+`--record-usage` writes a derived, input-hashed compact-output snapshot for that page under `analysis/page-context/`. Token counting lazily uses `o200k_base`; a missing `tiktoken` installation records `tokens: null` without blocking execution. `page-context-report` excludes stale snapshots, reports compact page-context totals, and lists unique reference fingerprints. The once-loaded reference payloads and other session context remain intentionally unmeasured.
`update_spec.py` propagates a post-generation change in two coordinated steps: write the new value to `spec_lock.md`, then literal-replace it across every `svg_output/*.svg`. The tool's scope is deliberately narrow — only `colors.*` (HEX values, case-insensitive replacement) and `typography.font_family` (attribute-scoped). Other fields (font sizes, icons, images, canvas) are intentionally **not supported** because their replacements would need attribute-scoped or semantic awareness whose risk/benefit doesn't justify bulk propagation. For those, edit `spec_lock.md` and re-author the affected pages.
diff --git a/docs/zh/technical-design.md b/docs/zh/technical-design.md
index ffdf4785..70cb378b 100644
--- a/docs/zh/technical-design.md
+++ b/docs/zh/technical-design.md
@@ -166,10 +166,12 @@ analysis/source_profile.json ───┼─> Strategist -> design_spec.md + spe
analysis/image_analysis.csv ────┘
design_spec.md + spec_lock.md + images/ + icons/ + templates/
- └─> project_manager.py page-context <project> P<NN> --bundle
- + [当前完整原型 SVG]
- + [mirror text-slots.v2-min]
+ └─> project_manager.py page-context <project> P<NN>
+ + [有界重复的 lock 投影]
+ + [当前页 delta]
+ + [Design Spec / 原型 / 图表的路径与 SHA 指纹]
├─> Executor -> svg_output/
+ │ ├─> 未变化的大型引用保留在当前上下文中
│ ├─> svg_quality_checker.py -> validation/svg_quality_report.json
│ ├─> finalize_svg.py -> svg_final/
│ └─> svg_to_pptx.py -> exports/<name>_<ts>.pptx + validation/<output_stem>.report.json
@@ -377,9 +379,9 @@ Strategist 阶段产出两份看起来冗余但服务不同对象的产物:
这份 lock 同时也是逐页路由表。除了全局配色和字体,它还承载 `page_rhythm`(`anchor` / `dense` / `breathing`)、`page_charts`(某页应适配哪个图表模板)、带放置/裁剪契约的图片行,以及决定加载哪些执行规则文件的 `mode` / `visual_style`。选定 custom 方向时,lock 还承载已消解的 `mode_behavior` / `visual_style_behavior`,page-context 会把它们投影给 Executor,而不是只留下字面上的 `custom` id。`template_reuse_scope: mirror|layout` 项目额外承载 `page_layouts`(每页继承哪个输入模板 SVG)、唯一的 `pptx_masters` / `pptx_layouts` 定义,以及 `page_pptx_layouts` 页面分配;`template_reuse_scope: style`、自由设计和 brand-only 项目使用 `pptx_structure.mode: flat`,那些段整段省略,而不是写成空值。其余字段的空值本身仍是信号:没有图表、没有图片,很多时候是设计选择,而不是漏填。
-`page-context --bundle` 按路线收敛输入:flat 页面不增加模板 payload;structured layout 页面增加当前完整原型;mirror 页面再增加 `ppt-master.template-text-slots.v2-min`。v2-min 的每个 slot 只包含 selector、role、当前/分段文本和 tspan 数量;顶层 tool hash 覆盖 selector 及不可变文字/tspan 拓扑和属性。page-context 会根据完整原型重算该 hash 与所有投影字段,再从模型输出中剥离 hash;旧 v1 sidecar 也会经过同等兼容校验并在内存中投影成同一形状。模型只负责语义决策和 replacement 文本;Checker 与 structured export 在内部根据完整原型校验输出属性、文字拓扑和资源 hash。
+`page-context v2` 把有界的一致性状态与大型引用分开。它有意在每页重复紧凑的全局 lock 投影,作为防漂移护栏,并用 `lock_source.sha256` 绑定版本。当前 §IX brief、节奏、图片选择和模板/图表分配构成逐页 delta。项目/模板 Design Spec、选中的原型,以及 `templates/charts/<key>.svg` 只以带 scope 的路径/SHA 指纹出现。只有该指纹不在当前执行上下文中或 SHA 已变化时,Executor 才读取文件一次;后续页面直接复用已有理解。flat 页面没有原型引用;structured 页面引用权威的完整 SVG。manifest 与 text-slot sidecar 只保留为派生工具诊断,不注入页面创作上下文。
-`--record-usage` 必须与 `--bundle` 同用;它在 `analysis/page-context/` 下写入当前页的派生快照,并记录所有输入 hash;预期但缺失的可选输入也会记录,因此后续补出产物会使快照过期。token 计数按需加载 `o200k_base`;没有安装 `tiktoken` 时写入 `tokens: null`,但不阻塞执行。`page-context-report` 排除过期快照,并汇总各组件的实测 token,用于判断未来是否值得引入 mirror text-patch 工具;本阶段不引入该工具。
+`--record-usage` 在 `analysis/page-context/` 下写入当前页的派生快照,记录输入 hash 和紧凑 stdout 的实测大小。token 计数按需加载 `o200k_base`;没有安装 `tiktoken` 时写入 `tokens: null`,但不阻塞执行。`page-context-report` 排除过期快照,汇总紧凑 page-context,并列出唯一引用指纹;一次加载的大型引用 payload 与其他会话上下文有意不纳入统计。
`update_spec.py` 把生成后的修改用两个协调步骤传播:把新值写入 `spec_lock.md`,然后字面替换到每一份 `svg_output/*.svg`。工具的范围**故意收得很窄**——只支持 `colors.*`(HEX 值,大小写不敏感替换)和 `typography.font_family`(属性级)。其他字段(字号、图标、图片、画布)**有意不支持**——它们的替换需要属性级或语义级理解,风险/收益不值得做批量传播。这些情况手动改 `spec_lock.md` 然后重做受影响的页面。
diff --git a/skills/ppt-master/references/artifact-ownership.md b/skills/ppt-master/references/artifact-ownership.md
index 9b9d290c..6b42bd20 100644
--- a/skills/ppt-master/references/artifact-ownership.md
+++ b/skills/ppt-master/references/artifact-ownership.md
@@ -19,13 +19,13 @@ Global artifact ownership rules for PPT Master projects.
| `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, and resource plan authored from the final confirmation plus source analysis | Strategist writes and audits it against every confirmed field before lock projection; humans and later roles read it for intent |
-| `spec_lock.md` | Execution projection | Machine-readable colors, typography, 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 projects the route-specific contract from the audited Design Spec without making another design decision; `page-context` projects the current-page subset for Executor. Executor may add a new adaptive Layout identity only on a structured mirror/layout route while authoring the page that first needs it. |
-| `project_manager.py page-context` stdout | Derived per-page context | Read-only model-facing projection of current `design_spec.md`, `spec_lock.md`, and selected template assets | Generate immediately before each page with `--bundle`; never edit or persist it as a replacement source of truth. Flat bundles contain context only; layout adds the complete selected prototype; mirror adds that prototype plus the minimal text-slot view. |
-| `analysis/page-context/P<NN>.usage.json` | Derived context telemetry | Actual model-facing bundle size by page and component | `page-context --record-usage` deterministically replaces that page's snapshot; `page-context-report` summarizes current snapshots. Use token data to evaluate later context tooling, never as content or an execution contract. |
+| `spec_lock.md` | Execution projection | Machine-readable colors, typography, 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 projects the route-specific contract from the audited Design Spec without making another design decision; `page-context` deliberately repeats its compact global projection per page as an anti-drift guard and adds current-page routing values. Executor may add a new adaptive Layout identity only on a structured mirror/layout route while authoring the page that first needs it. |
+| `project_manager.py page-context` stdout | Derived per-page context | Read-only model-facing lock projection + 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 lock guard. `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. |
| `images/` | Runtime image pool | User, extracted, AI, web, formula, slice, EMF/WMF assets | Step 5 writes here; `analysis/image_analysis.csv` derives from current contents |
| `icons/` | Project icon inventory | Icons copied by `icon_sync.py` for this project | Executor uses locked project icons; exporter may fall back to global library only as documented |
-| `templates/` | Project template reference | Step 3 imported specs, template SVGs, and non-image assets | Strategist/Executor read only when Step 3 is triggered |
-| `templates/template_execution_manifest.json` (`v1`) + `templates/template_execution/*.text-slots.json` (`v2-min`) | Template execution index | Compact prototype roster/source-import summary plus per-prototype `selector`, `role`, `current_text`, `text_segments`, and `tspan_count`; the sidecar's top-level integrity hash is tool-only | Read the roster once; `page-context --bundle` validates and strips the tool hash, then includes the selected minimal projection and complete prototype for mirror, or the complete prototype alone for layout. Missing, malformed, or stale derived sidecars fall back to the complete SVG. Attributes, topology, and hashes remain tool-validated; never author from either JSON artifact alone. |
+| `templates/` | Project template reference | Step 3 imported specs, template SVGs, and non-image assets | Strategist reads the template Design Spec and actual SVG roster during planning. Continuous Executor reuses that context; fresh Executor reads the Design Spec once and each selected complete SVG only before first use or after its SHA changes. |
+| `templates/template_execution_manifest.json` (`v1`) + `templates/template_execution/*.text-slots.json` (`v2-min`) | Derived template index | Compact prototype/source-import summary plus per-prototype text-slot diagnostics; the sidecar integrity hash is tool-only | Materialization may publish these deterministic records, but page-context does not inject or require them and models do not read them during page authoring. The complete prototype SVG is the sole visual/template authority; never author from either JSON artifact. |
| `<import_workspace>/svg/` | Imported native-payload backing | Complete PPTX-derived metadata, hidden carriers, fallback evidence, and source structure | Keep immutable; create-template materialization may resolve a validated source ref against these files, but models do not edit or bulk-read them |
| `<import_workspace>/svg-flat/` | Optional complete-page verification backing | Self-contained visual composition generated only by explicit `--inheritance-mode both` | Keep immutable when requested; never use as authoring or materialization input |
| `<import_workspace>/authoring-svg/` | Template-creation author source | Layered editable SVG IR for imported Master, Layout, and Slide objects | Template_Designer reads and edits this bundle; final template SVGs are materialized from it rather than copied from lossless backing |
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index c0dd28aa..c8b46d37 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -31,15 +31,19 @@ Before the first SVG page, output a confirmation listing: the compact communicat
### 2.1 Per-page execution context (Mandatory)
-**Hard rule**: Before generating **each** SVG page, load its canonical projection and record the model-facing context size:
+Before the first SVG, retain `design_spec.md`: continuous execution reuses planning context; fresh/resumed execution reads it once.
+
+**Hard rule**: Before generating **each** SVG page, load its canonical current-page delta and record its model-facing size:
```bash
-python3 skills/ppt-master/scripts/project_manager.py page-context <project_path> P<NN> --bundle --record-usage
+python3 skills/ppt-master/scripts/project_manager.py page-context <project_path> P<NN> --record-usage
```
-Use the bundle's communication, canvas, mode/style, conditional `mode_behavior` / `visual_style_behavior`, colors, typography, icons, current §IX brief/locks, and optional `global.template_application`. The latter governs which template content stays, changes, or moves; reuse/adherence select exporter mechanics only. This projection overrides neither facts, locks, nor technical constraints. After an approved lock change, rerun it before drawing the affected page.
+`global` deliberately repeats the sub-1000-token lock projection as an anti-drift guard; `lock_source.sha256` binds its version. `page_context` is the current §IX/resource/template/chart delta. For every `reference_set` entry—project/template Design Spec or selected prototype/chart SVG—reuse an in-context path + SHA; read it once only when absent or changed.
+
+Use lock values literally and optional `Template Application` from the retained Design Spec. 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 bundle carries page intent and locked execution values, 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 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.
**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-chart.md b/skills/ppt-master/references/executor-chart.md
index 4820fd29..6faf91ae 100644
--- a/skills/ppt-master/references/executor-chart.md
+++ b/skills/ppt-master/references/executor-chart.md
@@ -8,7 +8,7 @@ Conditional Executor authority for data charts, chart-catalog adaptations, chart
## 1. Reference Loading and Per-page Selection
-Read each selected chart SVG once before its first use. If a later page introduces a chart absent from the initial selection, read that file once and continue.
+For each selected `templates/charts/<key>.svg`, use its Skill-relative `reference_set` path + SHA: read once before first use or after change, otherwise reuse it. Never load the full catalog.
**Per-page chart reference — `page_charts` section**:
diff --git a/skills/ppt-master/references/executor-structured.md b/skills/ppt-master/references/executor-structured.md
index 05c32664..2b94c8ef 100644
--- a/skills/ppt-master/references/executor-structured.md
+++ b/skills/ppt-master/references/executor-structured.md
@@ -12,15 +12,15 @@ Conditional Executor authority for `template_reuse_scope: mirror|layout` with `p
| Context | Load policy |
|---|---|
-| Chosen template's `templates/design_spec.md` capabilities | Once before page generation |
-| `templates/template_execution_manifest.json`, when present | Once for prototype roster/orientation |
-| Current page context and selected prototype | Run [`executor-base.md`](./executor-base.md) §2.1 immediately before that page |
+| `templates/design_spec.md` | Strategist reads once; continuous Executor reuses it, fresh Executor reads it once |
+| Current page delta | Run [`executor-base.md`](./executor-base.md) §2.1 immediately before that page |
+| Selected prototype SVG | Read once on an absent/changed `reference_set` path + SHA; otherwise reuse it |
-**Hard rule**: The current-page bundle carries the selected complete prototype SVG. A `mirror` bundle also carries the selected `ppt-master.template-text-slots.v2-min` view; a `layout` bundle omits that mirror-only view. Never author a structured page from the roster or sidecar alone.
+**Hard rule**: Page-context carries no prototype payload. `reference_set` identifies the authoritative complete SVG; never author from a roster, manifest, sidecar, filename, or summary alone.
-**Missing or malformed derived sidecar** → continue from the complete prototype SVG in the bundle. Missing derived metadata alone does not invalidate a legacy workspace or authorize changing text topology.
+Manifest/text-slot files are derived tool metadata, not model inputs. Missing metadata neither invalidates a legacy workspace nor permits text-topology changes.
-**Exception**: If the user adds a page or swaps its prototype mid-deck, update the owning planning mapping and regenerate that page's bundle before authoring it.
+**Mapping change**: update the owning plan and regenerate that page's delta; load only a new/changed prototype fingerprint.
Resolve the per-page template SVG from `page_context.template.prototype`; the owning `spec_lock.md page_layouts` row remains authoritative. There is no filename/page-type fallback.
@@ -51,14 +51,14 @@ Resolve the per-page template SVG from `page_context.template.prototype`; the ow
When `spec_lock.md` records the AI-derived `template_reuse_scope: mirror`, Executor switches to a literal replacement path. The workspace capability `replication_mode: mirror` is a prerequisite, not the trigger by itself:
1. **Per-page reference selection** — Strategist selects one mirror page per project page via `spec_lock.md page_layouts` (e.g., `P04: 015_content`). The basename is the mirror filename without extension; Strategist made this choice by reading `design_spec.md §V Page Roster` descriptions, not by guessing.
-2. **Copy, don't fill** — open the referenced full mirror SVG immediately before authoring the page. Copy it as the starting point, then edit slide-specific text in place. Preserve every non-text element and every `data-pptx-*` structure attribute verbatim.
-3. **What you may edit** — decide the semantic slot mapping and replacement text only. Change only visible string values already carried by `<text>` and `<tspan>` nodes that express slide-specific content (title, body, captions, KPI labels, dates, page numbers). Keep the number, order, nesting relationship, and **all attributes** of every `<text>` / `<tspan>` node unchanged. Never merge or split nodes, move a string between nodes, add a new tspan, or delete an empty carrier. The minimal sidecar exposes only `selector`, `role`, `current_text`, `text_segments`, and `tspan_count`; `svg_quality_checker.py` and export validate attributes, topology, and prototype hashes internally.
+2. **Copy, don't fill** — use the retained full mirror SVG as the starting point, then edit slide-specific text in place. Preserve every non-text element and every `data-pptx-*` structure attribute verbatim. Do not reopen the same path + SHA merely because another page selects it.
+3. **What you may edit** — decide the semantic slot mapping and replacement text only. Change only visible string values already carried by `<text>` and `<tspan>` nodes that express slide-specific content (title, body, captions, KPI labels, dates, page numbers). Keep the number, order, nesting relationship, and **all attributes** of every `<text>` / `<tspan>` node unchanged. Never merge or split nodes, move a string between nodes, add a new tspan, or delete an empty carrier. `svg_quality_checker.py` and export validate attributes, topology, and prototype hashes against the complete prototype internally.
4. **What you must not touch** — element positions, sizes, fonts, colors, fills, strokes, gradients, **which image each `<image>` points at**, `<g>` grouping, sprite-sheet `<svg viewBox>` wrappers, decorative `<rect>` / `<path>` / `<circle>` / `<polygon>` shapes, `<use data-icon="...">` markers, embedded chart data structures. Mirror's value is preserving the source deck's visual identity — any geometric / decorative drift defeats the purpose. **The `href` path is not the image**: normalizing a bare `href="cover_bg.png"` to `href="../images/<name>"` (when Step 3 relocated the asset to `images/`) points at the *same* image and changes nothing visual — that is an allowed path fix, not a fidelity edit. Leaving the bare href as-is is also fine; the exporter and live preview resolve bare hrefs against `images/` either way.
5. **Content fit** — if the replacement needs a different number of text segments/items, do not merge/split nodes, drop sourced content, or restructure the grid. Select a better mirror prototype and update the planning mappings, or report `warning: P<NN> content does not fit mirror reference <basename>; choose another prototype or change template_reuse_scope to layout/style`.
6. **Visible text editing** — mirror SVGs may keep literal source text rather than `{{...}}` authoring markers. Edit values in place while retaining imported semantic `data-pptx-placeholder` identity and exact text topology.
7. **Output filename** — follow the standard project SVG naming convention (`<NN>_<page_name>.svg` where `<NN>` matches the project page index, not the mirror source index). The mirror filename is the *reference*, not the *output*.
-**Detecting mirror mode**: read `page_context.template.reuse_scope` from the current page-context bundle. `replication_mode: mirror` in the installed template only determines whether that derived scope is legal; it must never force mirror behavior when the lock records `layout` or `style`.
+**Detecting mirror mode**: read `page_context.template.reuse_scope` from the current page delta. `replication_mode: mirror` in the installed template only determines whether that derived scope is legal; it must never force mirror behavior when the lock records `layout` or `style`.
**Mirror + chart pages**: chart structures inside a mirror SVG are already drawn (axis, series, labels). Treat them as visual references — replace the data labels and series text content to match the project's chart spec, but do not redraw the chart from a `templates/charts/<name>.svg` baseline. A mirror template's `page_charts` entries are normally absent for this reason.
@@ -126,7 +126,7 @@ The exporter writes these solid fills as real Master/Layout/Slide `p:bg`, not se
**Per-page template lookup — `page_layouts` section (`mirror` / `layout` only)**:
-Before drawing each page, use the bundled `page_context.template.prototype` to identify the inherited basename (the full prototype is included under §1.0):
+Before drawing each page, use `page_context.template.prototype` to identify the inherited basename. Its matching `reference_set` entry supplies the complete SVG's path and SHA; §1.0 owns whether that file must be read or can be reused from the active context:
- Entry present (e.g., `P04: 03a_content_image_text`) → inherit the corresponding full SVG. The basename **must match** an actual file in the chosen template directory. If it does not, stop before drawing and report the invalid mapping; neither `strict` nor `adaptive` may fall back to free design inside a structured template deck.
- No entry for this page with `template_reuse_scope: mirror|layout` → stop before drawing and report the missing Strategist mapping. Adaptive mode still requires one selected complete template SVG; flexibility applies to the post-design output Layout, not to whether an input prototype exists.
diff --git a/skills/ppt-master/references/strategist-template.md b/skills/ppt-master/references/strategist-template.md
index cb8b3539..d570390d 100644
--- a/skills/ppt-master/references/strategist-template.md
+++ b/skills/ppt-master/references/strategist-template.md
@@ -16,7 +16,8 @@ Conditional extension for applying an installed Brand/Layout/Deck workspace to S
**No template-mode confirmation**: Never ask the user to select `template_reuse_scope`, `template_adherence`, `mirror`, `layout`, `style`, `strict`, or `adaptive`. These are internal execution values for the current exporter. The user communicates intent in natural language; explicit instructions such as “全部原样保留”, “从中选合适的页面”, “可以重组”, or “只参考视觉” are authoritative. Without an explicit instruction, Strategist decides.
-Immediately before authoring the Stage-2 solution, inspect:
+Immediately before authoring the Stage-2 solution, load each relevant template
+resource once per path + SHA and inspect:
- the installed `design_spec.md`, actual Page Roster, and relevant SVG prototypes;
- the current communication contract, source obligations, planned page count, and content shape of every planned page;
@@ -51,7 +52,7 @@ Write only the derived values to `spec_lock.md pptx_structure`; omit `template_a
## 2. Scenario Fit and Inherited Design
-**Mandatory — inspect the stored resource at the decision point**: For an installed `kind: deck`, re-read `<project_path>/templates/design_spec.md` and compare its descriptive Template Overview with the confirmed audience, intent, outcome, delivery context, artifact afterlife, and source obligations. Compare the actual Page Roster and SVG prototypes with required narrative roles, content shapes, slots, and capacity. The template describes what exists; it never overrides the current project and it does not own required/optional/repeatable or fixed/replaceable/example-only policy. For `kind: layout`, compare only structural roles, slots, and capacity.
+**Mandatory — decide from the §1 inspection**: For an installed `kind: deck`, compare the retained Template Overview with the confirmed audience, intent, outcome, delivery context, artifact afterlife, and source obligations. Compare the retained Page Roster/relevant SVG prototypes with required narrative roles, content shapes, slots, and capacity. Reopen a resource only when its path + SHA changed. The template describes what exists; it never overrides the current project or own required/optional/repeatable or fixed/replaceable/example-only policy. For `kind: layout`, compare only structural roles, slots, and capacity.
| Internal scope | Appropriate when |
|---|---|
diff --git a/skills/ppt-master/scripts/README.md b/skills/ppt-master/scripts/README.md
index 6fef40bf..5e925b99 100644
--- a/skills/ppt-master/scripts/README.md
+++ b/skills/ppt-master/scripts/README.md
@@ -76,15 +76,16 @@ python3 scripts/project_manager.py import-sources <project_path> <source_files_o
python3 scripts/project_manager.py scaffold-spec <project_path>
python3 scripts/project_manager.py scaffold-lock <project_path>
python3 scripts/project_manager.py validate <project_path>
-python3 scripts/project_manager.py page-context <project_path> P07 --bundle --record-usage
+python3 scripts/project_manager.py page-context <project_path> P07 --record-usage
python3 scripts/project_manager.py page-context-report <project_path>
```
-`page-context` prints a read-only current-page projection by default. The
-optional bundle adds the complete selected prototype for structured layout
-reuse and, for mirror reuse, a minimal text-slot sidecar. `--record-usage`
-requires `--bundle` and writes one derived snapshot under
-`analysis/page-context/`; exact `o200k_base` token counts are optional and
+`page-context` prints a read-only compact current-page projection. Its global
+lock projection repeats per page as an anti-drift guard; large Design Specs,
+prototype, and `templates/charts/` references are emitted only as scoped
+path/SHA fingerprints and are read once per execution context. `--bundle` is a
+deprecated compatibility no-op. `--record-usage` writes one derived snapshot
+under `analysis/page-context/`; exact `o200k_base` token counts are optional and
degrade to `tokens: null` when `tiktoken` is absent.
Chart candidate recall:
@@ -148,11 +149,10 @@ are stored there as short `data-pptx-native-ref` records. Structural metadata
stays inline, while checker, template-structure validation, and export hydrate
both layers in memory. Legacy inline payload and v1 payload-only stores remain
readable. The v1 execution manifest points to per-prototype
-`ppt-master.template-text-slots.v2-min` sidecars. Those sidecars expose only
-text selectors, semantic roles, current/segmented text, and tspan counts;
-page-context validates and strips their top-level tool integrity hash before
-model output, while checker and export validate output attributes, topology,
-and resource hashes against the complete prototype internally. Bitmap assets
+`ppt-master.template-text-slots.v2-min` diagnostic sidecars. They are derived
+tool metadata and are not injected into model context. Checker and export
+validate output attributes, topology, and resource hashes against the complete
+prototype internally. Bitmap assets
go to `images/`; other referenced source assets go to `templates/assets/`.
The destination must be empty, and the command does not write
`templates/design_spec.md`; Template_Designer owns that authored brief.
diff --git a/skills/ppt-master/scripts/docs/project.md b/skills/ppt-master/scripts/docs/project.md
index fd9d75c3..e34db98c 100644
--- a/skills/ppt-master/scripts/docs/project.md
+++ b/skills/ppt-master/scripts/docs/project.md
@@ -17,7 +17,7 @@ python3 scripts/project_manager.py scaffold-spec <project_path>
python3 scripts/project_manager.py scaffold-lock <project_path>
python3 scripts/project_manager.py validate <project_path>
python3 scripts/project_manager.py info <project_path>
-python3 scripts/project_manager.py page-context <project_path> P07 [--bundle] [--pretty] [--record-usage]
+python3 scripts/project_manager.py page-context <project_path> P07 [--pretty] [--record-usage]
python3 scripts/project_manager.py page-context-report <project_path>
```
@@ -48,10 +48,12 @@ Notes:
non-`none` `image_usage` source must appear in at least one `## images` row
of the lock (`provided` maps to `user`; `ai` is also satisfied by `slice`).
The design schema is structural lint for
- the human-readable brief; the lock schema owns machine execution values. For structured template use,
- validation also compares the lock's Master/Layout identities with the actual
- template SVG roots. Versioned scaffolds carry the schema marker. Markerless
- legacy artifacts are left on their prior validation path with a warning;
+ the human-readable brief; the lock schema owns machine execution values. For
+ structured template use, strict input prototypes must match their assigned
+ Master/Layout; adaptive input prototypes retain the assigned Master while a
+ new output Layout is validated only after its generated SVG exists. Versioned
+ scaffolds carry the schema marker. Markerless legacy artifacts are left on
+ their prior validation path with a warning;
malformed or unsupported markers are errors.
- PPTX-family inputs are enriched automatically under `analysis/` with
per-deck `<stem>.identity.json` / `<stem>.slide_library.json` plus the shared
@@ -61,20 +63,24 @@ Notes:
### Per-page execution view
-`page-context` projects `design_spec.md` and `spec_lock.md` into one current-page
-view on stdout. The default command is read-only; `--pretty` changes JSON
-formatting only. Before projection it revalidates only the machine lock and any
-selected template-root identities; design-brief values are not treated as a
-second lock. When present, the human-readable `Template Application` prose from
-`design_spec.md §I` is projected as `global.template_application`. Slide
-headings at H3–H6 remain readable by the projector.
-`--bundle` appends only the route-selected authoring payloads:
-
-| Project mode | Bundle contents |
-|---|---|
-| `flat` | page context |
-| structured `layout` | page context + complete selected prototype SVG |
-| structured `mirror` | page context + `text-slots.v2-min` + complete selected prototype SVG |
+`page-context` projects `design_spec.md` and `spec_lock.md` into one compact
+current-page view on stdout. The default command is read-only; `--pretty`
+changes JSON formatting only. Before projection it revalidates the machine lock
+and selected template-root identities; design-brief values are not treated as
+a second lock. Slide headings at H3–H6 remain readable by the projector.
+
+The output deliberately repeats the bounded `global` lock projection on every
+page as an anti-drift guard. `lock_source` binds that projection to the current
+`spec_lock.md` SHA. `page_context` contains the current §IX brief, rhythm,
+resources, and conditional template/chart assignment. `reference_set` contains
+only `kind`, scoped path, SHA, and `once-per-execution-context` policy for the
+project/template Design Specs and selected prototype/chart SVGs. A model reads
+a referenced file only when that exact path + SHA is absent from its active
+context or has changed, then reuses the retained understanding on later pages.
+
+The deprecated `--bundle` flag remains accepted as a compatibility no-op. It
+never appends a Design Spec, prototype SVG, chart SVG, manifest, or text-slot
+sidecar to stdout.
The projection keeps project-specific forbidden rules; universal SVG and icon
rules remain in the always-loaded execution core. Image rows are selected from
@@ -84,27 +90,21 @@ page, the view excludes those assigned images. Any still-unassigned legacy
image remains in a compatibility subset; `confirmed-none` is emitted only when
all locked images have a deterministic assignment elsewhere.
-Mirror materialization publishes `ppt-master.template-text-slots.v2-min` with
-only `selector`, `role`, `current_text`, `text_segments`, and `tspan_count` per
-text node. Its top-level integrity hash covers selectors plus immutable text
-and tspan topology/attributes. `page-context` recomputes that hash and every
-model-visible field from the complete prototype before stripping the hash from
-the bundle. A legacy v1 sidecar receives the same checks and is projected to the
-same model-facing shape in memory; the workspace is not rewritten. The complete
-SVG remains in the bundle. Checker and structured export validate output
-attributes, text/tspan topology, and referenced-resource hashes internally, so
-authoring supplies only semantic choices and edits only the existing visible
-text values.
-
-`--record-usage` requires `--bundle` and writes a derived snapshot to
-`analysis/page-context/P<NN>.usage.json`. It hashes every input and measures the
-exact controlled stdout plus each component; expected-but-absent optional inputs
-are recorded so later artifact creation invalidates the snapshot. `tiktoken` is
+Mirror materialization may publish deterministic
+`ppt-master.template-text-slots.v2-min` diagnostics. They are not page-context
+or model inputs. The complete SVG remains the sole template authority; checker
+and structured export validate output attributes, text/tspan topology, and
+referenced-resource hashes against it internally.
+
+`--record-usage` writes a derived snapshot to
+`analysis/page-context/P<NN>.usage.json`. It hashes every input, measures the
+exact compact stdout, and records the reference fingerprints. `tiktoken` is
loaded lazily with `o200k_base`; when unavailable, the command still succeeds
and records bytes, characters, hashes, and `tokens: null`.
`page-context-report` summarizes only fresh snapshots and identifies stale or
-token-unavailable pages. The telemetry does not include source-material reads
-or session-level prompt references.
+token-unavailable pages plus unique referenced files. The telemetry does not
+measure the once-loaded reference payloads, source-material reads, or other
+session-level prompt references.
Common formats:
- `ppt169`
@@ -123,7 +123,7 @@ python3 scripts/project_manager.py scaffold-spec projects/my_presentation_ppt169
python3 scripts/project_manager.py scaffold-lock projects/my_presentation_ppt169_20251116
python3 scripts/project_manager.py validate projects/my_presentation_ppt169_20251116
python3 scripts/project_manager.py info projects/my_presentation_ppt169_20251116
-python3 scripts/project_manager.py page-context projects/my_presentation_ppt169_20251116 P07 --bundle --record-usage
+python3 scripts/project_manager.py page-context projects/my_presentation_ppt169_20251116 P07 --record-usage
python3 scripts/project_manager.py page-context-report projects/my_presentation_ppt169_20251116
```
diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.md
index 1db68ace..5b751798 100644
--- a/skills/ppt-master/scripts/docs/svg-pipeline.md
+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md
@@ -170,14 +170,14 @@ The published `ppt-master.template-execution-manifest.v1` roster points to one
compact `ppt-master.template-text-slots.v2-min` sidecar per prototype. Each text
slot contains only `selector`, `role`, `current_text`, `text_segments`, and
`tspan_count`; a top-level tool hash covers its selectors and immutable
-text/tspan topology and attributes. A current-page mirror bundle still includes
-the complete prototype SVG. Page projection recomputes the hash and projected
-fields against that prototype, then strips the hash from model context. The
-model chooses semantics and edits only existing visible text values, while
-checker and structured export validate output attributes, text/tspan topology,
-and referenced-resource hashes against the prototype. Runtime page projection
-accepts legacy v1 text-slot sidecars and reduces them to v2-min without
-rewriting the workspace.
+text/tspan topology and attributes. These records are deterministic tool
+diagnostics, not page-authoring inputs. Page-context emits only the complete
+prototype's path and SHA for that reference, so the model reads the SVG once
+per execution context and reuses it until the SHA changes. The model chooses
+semantics and edits only existing visible text values, while checker and
+structured export validate output attributes, text/tspan topology, and
+referenced-resource hashes against
+the prototype.
The output routes reusable vectors once to `icons/imported/`, bitmaps to
`images/`, and other referenced files to `templates/assets/`. The JSON report
diff --git a/skills/ppt-master/workflows/create-template.md b/skills/ppt-master/workflows/create-template.md
index 7a9f7fef..a637fdbd 100644
--- a/skills/ppt-master/workflows/create-template.md
+++ b/skills/ppt-master/workflows/create-template.md
@@ -525,14 +525,15 @@ SVGs, `icons/imported/`, referenced `images/` / `templates/assets/`, and one
deduplicated `templates/native_payloads.json.gz` store when supported native
payload or repeated restoration metadata exists. It also writes
`templates/template_execution_manifest.json` with schema
-`ppt-master.template-execution-manifest.v1`, a compact model-readable prototype
+`ppt-master.template-execution-manifest.v1`, a compact tool-readable prototype
roster and grouped source-import warning summary. Each prototype points to one
`templates/template_execution/*.text-slots.json` sidecar with schema
-`ppt-master.template-text-slots.v2-min`. Each slot contains only
-`selector`, `role`, `current_text`, `text_segments`, and `tspan_count`; the complete
-prototype remains authoritative. Page-context verifies the top-level tool hash
-and strips it before model output; validators/export own attribute and topology
-checks. Template SVGs and imported
+`ppt-master.template-text-slots.v2-min`. Each slot contains only `selector`,
+`role`, `current_text`, `text_segments`, and `tspan_count`; the complete
+prototype remains authoritative. The manifest and sidecars are deterministic
+tool diagnostics; page-context does not inject or require them, and models do
+not read them during page authoring. Validators/export own attribute and
+topology checks. Template SVGs and imported
vectors keep content-hash payload references plus short
`data-pptx-native-ref` attribute-record ids. Structural Master/Layout,
placeholder, layer, and editable-object fields remain inline. The command does
@@ -693,7 +694,7 @@ This checker validates the authoring contract, not the compiled OOXML package. T
- [ ] `standard` / `fidelity` output SVGs and their Master/Layout/slot contracts were newly authored without preserving or distilling source topology
- [ ] Every additional authored Master represents a distinct reusable design family, not one Layout or an equivalent duplicate; every declared Master owns at least one emitted Layout and every declared Layout has at least one emitted prototype
- [ ] Mirror output preserves source slide order, Master/Layout identity and parentage, placeholder facts, and ownership; fixed-layer group expansion is mechanical and pixel-equivalent, and the Source Preservation Map lists every source slide
-- [ ] Mirror materialization wrote one compact `ppt-master.template-execution-manifest.v1` roster and one linked `ppt-master.template-text-slots.v2-min` sidecar per prototype; each slot has only `selector`, `role`, `current_text`, `text_segments`, and `tspan_count`; page-context verifies and strips the tool hash, while validation/export check the complete prototype
+- [ ] Mirror materialization wrote one compact `ppt-master.template-execution-manifest.v1` roster and one linked `ppt-master.template-text-slots.v2-min` diagnostic sidecar per prototype; each slot has only `selector`, `role`, `current_text`, `text_segments`, and `tspan_count`; neither artifact is injected into page authoring, while validation/export check the complete prototype
- [ ] Mirror roots preserve source inherited-shape visibility with canonical lowercase `data-pptx-show-master-shapes` and `data-pptx-show-inherited-shapes`; same-key Layouts agree on the former, while each Slide retains its own latter value
- [ ] Mirror preflight covered the complete source graph; each unused Layout has one `layout_<layout_key>.svg` definition prototype and each otherwise-unused Master is retained through at least one such Layout
- [ ] For `standard` / `fidelity`, no duplicate-Layout-contract warning remains; mirror may keep equivalent source Layout identities when the preservation map explains them
diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.md
index bb509257..68346f42 100644
--- a/skills/ppt-master/workflows/generate-pptx.md
+++ b/skills/ppt-master/workflows/generate-pptx.md
@@ -12,7 +12,7 @@ description: Generate PPTX route authority for source intake, planning, SVG auth
- The current main agent hand-writes every SVG page; never delegate page generation or run a Python, Node, or shell generator over `svg_output/`.
- Generate pages sequentially, one page at a time, in one continuous pass; grouped page batches are forbidden.
-- Before each page, generate its canonical page-context bundle and apply the projected communication, design, resource, rhythm, chart, and conditional template mappings.
+- Before each page, load compact page-context; its lock projection guards drift while unchanged large references stay in context.
- `preset_shape_svg.py` may provide one stdout fragment only after the main agent chooses its semantic role, frame, and paint; it cannot choose layout or write a page.
### SVG Page-Design Boundary
@@ -367,17 +367,17 @@ python3 ${SKILL_DIR}/scripts/svg_editor/server.py <project_path> --live --daemon
- **Do NOT read or apply submitted annotations during generation.** Users may annotate at any time, but Executor proceeds without touching them. The window to apply annotations opens only after Step 7 completes — see [`workflows/stages/live-preview.md`](stages/live-preview.md).
- The editor also supports **staged direct edits** (text content + SVG element attributes previewed immediately, then written to `svg_output/` only when the user clicks **Apply changes**; `Ctrl+Z` / Undo drops staged edits) alongside annotation; re-export stays chat-driven. Full scope and editor details: see [`workflows/stages/live-preview.md`](stages/live-preview.md) Notes.
-**Conditional pre-generation reads**: On a structured route, follow `executor-structured.md` to read the template capabilities and compact execution roster once; the selected complete layout/mirror prototype arrives in each page bundle. Flat routes skip those template reads. When `spec_lock.page_charts` or §VII names selected chart templates, follow `executor-chart.md` and read those distinct chart SVGs once before the first affected page. A summary or sidecar never substitutes for the selected full SVG.
+**Conditional reference reads**: Follow `executor-structured.md` for template Design Spec/prototypes and `executor-chart.md` for `templates/charts/<key>.svg`. Both reuse unchanged `reference_set` path + SHA fingerprints; flat routes skip template reads. Summaries and sidecars never replace full SVGs.
> Image facts: trust the `analysis/image_analysis.csv` regenerated at the end of Step 5. If `images/` changed since (the user swapped or added files), re-run `python3 ${SKILL_DIR}/scripts/analyze_images.py <project_path>/images` before laying images out — facts are re-derived on use, never a stale store (Step 4 image-facts note).
**Per-page context load (Mandatory)**: before **each** SVG page, run:
```bash
-python3 skills/ppt-master/scripts/project_manager.py page-context <project_path> P<NN> --bundle --record-usage
+python3 skills/ppt-master/scripts/project_manager.py page-context <project_path> P<NN> --record-usage
```
-Use this projection for communication, optional `global.template_application`, current §IX `Core message` + `Audience move`, locked resources, and current-page assignments. Flat bundles contain page context; `layout` adds the selected complete prototype; `mirror` also adds its minimal text-slot view. The projection replaces neither gate artifacts nor source facts. See [`executor-base.md`](../references/executor-base.md) §2.1 and [`executor-structured.md`](../references/executor-structured.md) §1.0.
+Use `global` as the lock drift guard, `page_context` as the page delta, and `reference_set` under the Executor load policy. The retained Design Spec owns optional `Template Application`. This replaces neither gate artifacts nor source facts. See [`executor-base.md`](../references/executor-base.md) §2.1.
> ⚠️ **Main-agent only**: SVG generation MUST stay in the current main agent — page design depends on full upstream context. Do NOT delegate to sub-agents.
> ⚠️ **Generation rhythm**: generate pages sequentially, one at a time, in the same continuous context. Do NOT batch (e.g., 5 per group).
@@ -386,7 +386,7 @@ Use this projection for communication, optional `global.template_application`, c
Each completed SVG MUST be a standalone, complete representation of that slide's visible design. Template SVGs and locked planning artifacts may guide construction, but export must not reach back to them to add visible objects omitted from `svg_output/`. Speaker notes, animation, narration, transitions, and direct native-PPTX workflows remain separately owned artifacts/capabilities. When a page actually needs a literal stock shape, load and apply [`native-shape-authoring.md`](../references/native-shape-authoring.md) before drawing it. Diagram relationships remain Shape-first; do not infer a preset from contour similarity.
-`template_reuse_scope: mirror|layout` pages MUST start from the complete `page_layouts` SVG, keep inherited visible objects, and preserve root Master/Layout identity plus stable atoms/slots. Strict preserves that reusable contract; under `layout`, `global.template_application` may still authorize carrier text/tspan reflow inside unchanged slot bounds. Adaptive assigns a new Layout key/name and updates `spec_lock.md` when fixed atoms or slot topology/bounds change. `mirror` changes only visible text values while preserving text/tspan topology and attributes. `style` follows the flat paragraph below without structure metadata.
+`template_reuse_scope: mirror|layout` pages MUST start from the complete `page_layouts` SVG, keep inherited visible objects, and preserve root Master/Layout identity plus stable atoms/slots. Strict preserves that reusable contract; under `layout`, the once-loaded Design Spec's `Template Application` may still authorize carrier text/tspan reflow inside unchanged slot bounds. Adaptive assigns a new Layout key/name and updates `spec_lock.md` when fixed atoms or slot topology/bounds change. `mirror` changes only visible text values while preserving text/tspan topology and attributes. `style` follows the flat paragraph below without structure metadata.
`template_reuse_scope: style`, free-design, and brand-only pages use `pptx_structure.mode: flat`. Draw the complete page directly: keep backgrounds, repeated chrome, headings, text, images, and decoration as ordinary Slide-local SVG content. Do not plan `pptx_masters` / `pptx_layouts` / `page_pptx_layouts`, do not add root Master/Layout identity, and do not add `data-pptx-layer` or `data-pptx-placeholder` metadata. Group logical content normally with top-level `<g id>` elements. Export materializes one clean project-owned Master plus one Blank Layout, applies the locked theme colors/fonts/title-body defaults, removes stock content placeholders and unused built-in Layouts, and retains only the standard date/footer/slide-number capability hooks. It does not promote or deduplicate page content.
diff --git a/skills/ppt-master/workflows/stages/resume-execute.md b/skills/ppt-master/workflows/stages/resume-execute.md
index b2f62a6b..38293d49 100644
--- a/skills/ppt-master/workflows/stages/resume-execute.md
+++ b/skills/ppt-master/workflows/stages/resume-execute.md
@@ -31,7 +31,8 @@ Verify the project's planning-session artifacts before doing anything else:
| `<project_path>/spec_lock.md` | Always | Strategist's execution contract; `page-context` projects its current-page values |
| `<project_path>/design_spec.md` | Always | Section IX page outline; `page-context` projects the current page block |
| `<project_path>/images/` plus files whose row status requires existence | `spec_lock images` references any image | `Existing` / `Generated` / `Sourced` / `Rendered` files must exist; an absent `Needs-Manual` file remains allowed until the Step 7 readiness gate |
-| `<project_path>/templates/` | `spec_lock page_layouts` / `page_charts` references any | Layout / mirror prototypes and chart SVGs required by execution |
+| `<project_path>/templates/` | `spec_lock page_layouts` references any | Layout / mirror prototypes required by execution |
+| `skills/ppt-master/templates/charts/` | `spec_lock page_charts` references any | Shared chart SVGs selected by key |
If any required artifact is missing, report it and stop this stage. Do not enter Step 6 or invent a replacement artifact. Recover by artifact owner:
@@ -51,8 +52,8 @@ Then jump to `### Step 6: Executor Phase` and run the documented pipeline:
- Read the Step 6 flat core (`executor-base`, `shared-standards-core`, and the locked mode / visual-style files), then only the branches selected by its condition table
- Design Parameter Confirmation
-- Pre-generation compact template-roster read when structured, plus each distinct selected chart SVG once
-- Per-page `python3 skills/ppt-master/scripts/project_manager.py page-context <project_path> P<NN> --bundle --record-usage` load + sequential page generation
+- Read the project Design Spec and, when structured, the template Design Spec once; retain both in the fresh execution context
+- Per-page `python3 skills/ppt-master/scripts/project_manager.py page-context <project_path> P<NN> --record-usage` load + sequential page generation; the lock projection repeats intentionally, while each prototype/chart SVG is loaded only before its first use or after its SHA changes
- Quality Check Gate
- Speaker notes generation
- Step 7: Post-processing & Export (`total_md_split` → `finalize_svg` → `svg_to_pptx`)