Skip to content

Codify the visual playbook: themes, layout engine, image-first, genbg tool - #7

Open
pdurlej wants to merge 1 commit into
masterfrom
claude/visual-playbook
Open

Codify the visual playbook: themes, layout engine, image-first, genbg tool#7
pdurlej wants to merge 1 commit into
masterfrom
claude/visual-playbook

Conversation

@pdurlej

@pdurlej pdurlej commented May 29, 2026

Copy link
Copy Markdown
Owner

Why

This codifies everything we validated by live testing this session into the corpus, and sets the north-star positioning you described: hand the model a brief or voice note, get back a deck you can present in ten minutes without shame. Not "out-dazzle PowerPoint" — that race is explicitly abandoned here.

North star, written into the skill

iA Presenter is a typesetter, not a canvas. The LLM reasons about words and structure (its strength), never pixels (its weakness) — which is exactly why it fits. Use iA for talk-first, speaker-delivered decks; use PowerPoint when the artifact must dazzle standalone with no speaker. Aim editorial, not decorative.

New skill references

  • VISUAL-DESIGN.md — what iA is/isn't; the iA-vs-PowerPoint decision table; the three real levers (images, theme, rhythm); honest limits (big type is theme-bound; no shapes/cards/charts); the default "no-shame" recipe.
  • LAYOUT-ENGINE.md — cells drive the ~18 auto-layouts; blank line = new cell; 4+ cells → grid (verified); image-in-own-cell fills the slide. This is how an LLM "designs" without seeing pixels.
  • THEMES.md — set template/preset in info.json (verified: basel dark vs garamond light render distinctly from the package); choose by tone; custom themes (CSS) flagged as the high-ceiling lever (coming next).

New tool

  • tools/genbg.py — generate abstract gradient backgrounds and bundle them. Since iA won't fetch remote URLs and an LLM has no photos, this is the LLM-autonomous path to full-bleed colour. 8 palettes + custom --from/--to, dependency-free.

Corpus updates (grounded in live findings)

  • Syntax → Images: rewritten to the verified truth — images are flush-left, root-relative (/assets/…), and must be bundled; remote URLs render nothing. Replaces the old "verify in-app" hedging.
  • SKILL.md: art-direction core rules (9–11) + links to the new references and tools.
  • WORKFLOW.md: new Stage 4b — Art Direction.
  • tools/README.md: documents genbg.py.

Verification

ialint is clean across examples 01/02/04 and all golden candidates. The only findings are in examples/03-anti-patterns.md, which contains anti-patterns by design (the deliberate TAB-indented-table demo, etc.).

Next

Per your steer: this is the codification pass. Next is the deep research into how great presentations are actually made + a signature custom .iatheme (the high-ceiling lever) that you'll install once — the thing that makes every generated deck look like your house style.

https://claude.ai/code/session_01VVNdm2YJ8dnhQuWsm3AkAk


Generated by Claude Code

Encode everything validated by live testing this session into the corpus,
and set the north-star positioning (talk-first, present without shame in
minutes; do not try to out-PowerPoint PowerPoint).

New skill references:
- VISUAL-DESIGN.md: iA is a typesetter not a canvas; when to use iA vs
  PowerPoint; the three real levers (images, theme, rhythm); honest limits
- LAYOUT-ENGINE.md: cells drive the ~18 auto-layouts; blank line = new
  cell; 4+ cells -> grid (verified); image-in-own-cell fills the slide
- THEMES.md: set template/preset in info.json (verified basel/garamond);
  choose by tone; custom themes (CSS) as the high-ceiling lever

New tool:
- tools/genbg.py: generate abstract gradient backgrounds and bundle them
  (the LLM-autonomous path to full-bleed colour, since remote URLs fail)

Corpus updates grounded in live findings:
- syntax Images section: images flush-left, root-relative (/assets), MUST
  be bundled; remote URLs render nothing (replaces the old soft hedging)
- SKILL.md: art-direction core rules + links to the new references/tools
- WORKFLOW.md: new Stage 4b Art Direction
- tools/README.md: document genbg
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants