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(image_gen): require manifest mode for in-pipeline ai images

hugohe31aa6774f5c33
diff --git a/AGENTS.md b/AGENTS.md
index 59be8aa4..25fb6e4d 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -57,6 +57,10 @@ python3 skills/ppt-master/scripts/project_manager.py validate <project_path>
# Image tools and SVG quality check
python3 skills/ppt-master/scripts/analyze_images.py <project_path>/images
+# In-pipeline AI image generation — manifest mode (required, even for 1 image):
+python3 skills/ppt-master/scripts/image_gen.py --manifest <project_path>/images/image_prompts.json
+python3 skills/ppt-master/scripts/image_gen.py --render-md <project_path>/images/image_prompts.json
+# Out-of-pipeline one-off / debug / single-image fixup only (no manifest, no sidecar):
python3 skills/ppt-master/scripts/image_gen.py "prompt" --aspect_ratio 16:9 --image_size 1K -o <project_path>/images
python3 skills/ppt-master/scripts/svg_editor/server.py <project_path> --live
python3 skills/ppt-master/scripts/svg_quality_checker.py <project_path>
diff --git a/CLAUDE.md b/CLAUDE.md
index ab3609f0..98cb60f2 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -57,6 +57,10 @@ python3 skills/ppt-master/scripts/project_manager.py validate <project_path>
# Image tools and SVG quality check
python3 skills/ppt-master/scripts/analyze_images.py <project_path>/images
+# In-pipeline AI image generation — manifest mode (required, even for 1 image):
+python3 skills/ppt-master/scripts/image_gen.py --manifest <project_path>/images/image_prompts.json
+python3 skills/ppt-master/scripts/image_gen.py --render-md <project_path>/images/image_prompts.json
+# Out-of-pipeline one-off / debug / single-image fixup only (no manifest, no sidecar):
python3 skills/ppt-master/scripts/image_gen.py "prompt" --aspect_ratio 16:9 --image_size 1K -o <project_path>/images
python3 skills/ppt-master/scripts/svg_editor/server.py <project_path> --live
python3 skills/ppt-master/scripts/svg_quality_checker.py <project_path>
diff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.md
index e1ee3597..405dcf49 100644
--- a/skills/ppt-master/SKILL.md
+++ b/skills/ppt-master/SKILL.md
@@ -239,12 +239,14 @@ Then **lazy-load the path-specific reference** for each row that actually needs
| Acquire Via | Load reference (only if any such row exists) | Run |
|---|---|---|
-| `ai` | `references/image-generator.md` | `python3 ${SKILL_DIR}/scripts/image_gen.py ...` |
+| `ai` | `references/image-generator.md` | `python3 ${SKILL_DIR}/scripts/image_gen.py --manifest <project_path>/images/image_prompts.json` |
| `web` | `references/image-searcher.md` | `python3 ${SKILL_DIR}/scripts/image_search.py ...` |
| `user` / `placeholder` | (skip) | (skip) |
A deck with only `ai` rows never loads `image-searcher.md`; a deck with only `web` rows never loads `image-generator.md`. A mixed deck loads both, processes each row through its own path, and writes both `image_prompts.json` and `image_sources.json`.
+> ⚠️ **In-pipeline ai path MUST use manifest mode** — even when only 1 ai row exists. Write `images/image_prompts.json` first, then run `image_gen.py --manifest`, then `image_gen.py --render-md` to produce the `image_prompts.md` sidecar. The positional form (`image_gen.py "prompt" ...`) is reserved for **out-of-pipeline one-off testing / single-image fixups** — it skips manifest + sidecar, leaving no audit trail.
+
Workflow:
1. Extract all rows with `Status: Pending` and `Acquire Via ∈ {ai, web}` from the design spec
@@ -255,6 +257,7 @@ Workflow:
```markdown
## ✅ Image Acquisition Phase Complete
- [x] image_prompts.json created (when any ai rows processed)
+- [x] image_prompts.md sidecar rendered (when any ai rows processed)
- [x] image_sources.json created (when any web rows processed)
- [x] Each row: status is `Generated` / `Sourced` / `Needs-Manual` (no `Pending` remaining)
```