Carousel Orchestrator
End-to-end pipeline: user request → Codex generation → visual review → iteration → delivery.
Step 1 — Parse the request
Extract from the user's message:
- Topic: what is the carousel about?
- Key points: explicit stats, ideas, or frameworks they want included
- CTA keyword: what should people comment? (infer if not given)
- Tone: default to brutalist-tech unless user says otherwise
- Platform: default to LinkedIn (1080×1350) unless specified
If topic is unclear, ask one question only: *"What's the main idea you want to get across?"*
Step 2 — Set up project directory
PROJECT=~/work/carousels/$(date +%Y-%m-%d)-<slug>
mkdir -p $PROJECT/src $PROJECT/dist/slides
cp -r ~/.agents/skills/carousel-designer/scripts $PROJECT/
cp -r ~/.agents/skills/carousel-designer/assets $PROJECT/
cd $PROJECT && npm install playwright 2>/dev/null || trueStep 3 — Spawn Codex
Read references/brief-template.md, fill it with parsed content, then:
codex exec --full-auto --workdir $PROJECT \
"$(cat filled-brief.md)"Wait for RENDER_COMPLETE in Codex output. Timeout: 5 minutes.
Step 4 — Visual review
Load each PNG in dist/slides/ with the image tool. Run every check in references/quality-checklist.md.
Decision:
- All checks pass → go to Step 6
- 1–3 issues → Step 5 (feedback loop)
- Major structural issues → rebuild (back to Step 3 with amended brief)
Max iterations: 3. After 3 loops, deliver best available and note issues to user.
Step 5 — Feedback loop
Format feedback as structured diffs — never prose:
slide_1.headline: clips right edge — reduce font-size 148px → 120px
slide_3.metric-card: missing shadow-[16px_16px_0_0_#8566AF]
slide_7.closing: no CTA keyword — add "Comment THROUGHPUT and I'll send it"Spawn Codex again with:
Fix the following issues in src/slides.html. Do not change slides not mentioned.
Re-run the render script when done. Print RENDER_COMPLETE.
[paste structured feedback]Return to Step 4.
Step 6 — Deliver
# Send PDF
message(send, filePath: $PROJECT/dist/carousel.pdf)
# Send cover slide preview
message(send, filePath: $PROJECT/dist/slides/01.png,
caption: "Carousel ready. 7 slides. Reply with any tweaks.")Reference files
references/brief-template.md— fill this before spawning Codexreferences/quality-checklist.md— run this on every PNG set
Platform specs
| Platform | Size | Slides | Format |
|---|---|---|---|
| 1080×1350 | 5–10 | PDF document carousel | |
| Instagram sq | 1080×1080 | 5–10 | Images |
| Instagram story | 1080×1920 | 3–7 | Images |
*(Instagram templates: not yet built — request when needed)*