v2.12.1 — structured plans + stdin support

v2.12.1 — structured plans + stdin support across all 9 plan CLIs

UX patch — eliminates intermediate Python build-scripts AND disposable plan.json files.

Two problems with v2.12.0

1. Per-test Python build-script overhead — using carousel_prompt_builder required writing an intermediate Python script that imported the builder and dumped a plan.json. Bloat per iteration.
2. Disposable plan.json files — every test created plan-v2.json / plan-v3.json / lattice-plan.json etc. — a graveyard of one-off artifacts.

Both fixed.

Structured-content items (carousel-builder)

skills.carousel.plan.v1 plan items now accept TWO shapes:

// Legacy (back-compat):
{"index": 1, "label": "...", "prompt": "<full prompt>", "kwargs": {...}}

// New — structured content:
{"index": 2, "label": "...", "role": "framework",
 "content": {"framework_name": "...", "boxes": [...]}, "kwargs": {...}}

When a plan item has role + content, the CLI internally calls carousel_prompt_builder.build_slide_prompt() at execution time. The plan also accepts top-level lang and slide_marker_style fields applied uniformly across slides.

No Python script needed — structured content goes straight in the JSON. All 9 roles supported (hook / point / framework / data / steps / comparison / quote / myth-vs-truth / cta), each routed to its matching dataclass.

--plan-file - reads from stdin (all 9 plan-driven CLIs)

carousel, cover, flyer, avatar, thumbnail, banner, meme, logo, quote, reel all support --plan-file -. Pipe a heredoc straight into the CLI — no intermediate file needed for one-off tests / iterations. Production workflows can still use file-based plans.

Full workflow now

Claude (in conversation) assembles structured plan
  → heredoc
  → stdin
  → CLI builder
  → batch generates
  → PNG files

Zero disposable artifacts on disk between the prompt and the deliverable.

Notes

• 39 skills total (unchanged). Pure UX patch.
• Other plan-driven skills (cover-maker, flyer-maker, avatar-maker, etc.) get stdin support but DON'T yet have structured-content mode — they still need full per-item prompts. Adding structured shape to them is a future enhancement.
• Validated end-to-end with a 3-slide SaaS promo deck (gradient-mesh-modern style, hook → framework → cta) generated via heredoc — no files created.

Generated with Claude Code.