haipipe-display-poster

name	haipipe-display-poster
description	Render a conference poster (article + tcbposter LaTeX → A0/A1 PDF + editable PPTX + SVG) from a CONTENT PLAN — a markdown plan plus a figures folder, per ref/content-plan-spec.md. Source-agnostic: it never opens a paper. Use when user says "做海报", "制作海报", "conference poster", "make poster", "生成poster", "poster session", or hands over a poster content plan to lay out. To build one from a compiled paper, run /paper-poster — it extracts the plan, then calls this.
argument-hint	[content-plan.md or venue overrides]
allowed-tools	Bash(*), Read, Write, Edit, Grep, Glob, Agent, mcp__codex__codex, mcp__codex__codex-reply
metadata	{"version":"0.2.0","last_updated":"2026-07-24","summary":"Content plan + figures/ → tcbposter → A0/A1 PDF + PPTX + SVG. Renders what it is given; never reads the source it came from."}

Display: Poster Renderer

Render a poster from: $ARGUMENTS

Context

This is a renderer. It takes a finished content plan — a markdown file plus a folder of figures, shaped per ../../ref/content-plan-spec.md — and lays it out as a print-ready poster.

It never opens the source the content came from. No main.tex, no sections/*.tex, no assumption that a paper exists anywhere. A paper, a grant application, a project write-up, or a plan you typed by hand all render the same way. Deciding what goes on the poster already happened upstream; this skill decides how it looks.

• From a compiled paper → run /paper-poster, which extracts the plan and then calls this.
• Already have a plan → run this directly.

Unlike papers (dense prose, 8-15 pages), posters are visual-first: one page, 3-4 columns, bullet points only, figures dominant. A good poster tells the story in 60 seconds.

Constants

• VENUE = NeurIPS — Target venue, determines color scheme. Supported: NeurIPS, ICML, ICLR, AAAI, ACL, EMNLP, CVPR, ECCV, GENERIC. Override via argument (e.g., /paper-poster "— venue: ICML").
• POSTER_SIZE = A0 — Paper size. Options: A0 (841x1189mm, default), A1 (594x841mm).
• ORIENTATION = landscape — Orientation. Options: landscape (default), portrait.
• COLUMNS = 4 — Number of content columns. Typical: 4 for landscape A0 (IMRAD), 3 for portrait A0 (research consensus), 2 for portrait A1. Portrait A0 should NEVER use 4 columns — text becomes too narrow and unreadable.
• PLAN = poster-content-plan.md — The content plan to render. Shape: ref/content-plan-spec.md. venue, size, orientation, columns declared inside the plan override the constants above.
• FIGURES_DIR = figures/ — Folder holding every image the plan names. A figure: with no matching file is an error, not a guess.
• OUTPUT_DIR = poster/ — Output directory for all poster files.
• REVIEWER_MODEL = gpt-5.4 — Model used via Codex MCP for poster review.
• AUTO_PROCEED = false — At each checkpoint, always wait for explicit user confirmation. Set true only if user explicitly requests fully autonomous mode.
• COMPILER = latexmk — LaTeX build tool.
• ENGINE = pdflatex — LaTeX engine. Use xelatex for CJK text.

💡 Override: /paper-poster "paper/" — venue: CVPR, size: A1, orientation: portrait, columns: 3

Venue Color Schemes

Use deep, saturated colors for primary — pastel/light colors wash out on large posters viewed from distance. Each venue uses a 3-color system: primary (dark, for title bar), secondary (medium, for section headers), accent (contrast, for highlights).

Venue	Primary	Secondary	Accent	Background	Text
NeurIPS	#4C1D95 (deep purple)	#6D28D9 (purple)	#2563EB (blue)	#F5F3FF	#1F2937
ICML	#7F1D1D (deep maroon)	#B91C1C (red)	#1E40AF (blue)	#EDD5D5	#111827
ICLR	#065F46 (deep green)	#059669 (green)	#0284C7 (blue)	#F0FDF4	#1F2937
CVPR	#1E3A8A (deep blue)	#2563EB (blue)	#7C3AED (purple)	#F8FAFC	#1F2937
AAAI	#0C4A6E (deep navy)	#0369A1 (blue)	#DC2626 (red)	#F0F9FF	#1F2937
ACL	#155E75 (deep teal)	#0891B2 (teal)	#7C3AED (purple)	#F0FDFA	#1F2937
EMNLP	#713F12 (deep amber)	#D97706 (amber)	#2563EB (blue)	#FFFBEB	#1F2937
ECCV	#701A75 (deep fuchsia)	#C026D3 (fuchsia)	#0891B2 (teal)	#FDF4FF	#1F2937
GENERIC	(deep slate)

⚠️ Color lesson: Never use light/pastel colors (e.g., #8B5CF6) as primary — they look washed out on A0 posters. Always use the darkest shade as primary for the title bar.

State Persistence (Compact Recovery)

Poster generation can be long. Persist state to poster/POSTER_STATE.json after each phase:

{
  "phase": 3,
  "venue": "NeurIPS",
  "poster_size": "A0",
  "orientation": "landscape",
  "columns": 4,
  "figures_selected": ["architecture.pdf", "results.pdf"],
  "codex_thread_id": "019cfcf4-...",
  "status": "in_progress",
  "timestamp": "2026-03-18T15:00:00"
}

On startup: if POSTER_STATE.json exists with "status": "in_progress" and within 24h → resume from saved phase. Otherwise → fresh start.

Critical LaTeX Architecture Decisions

⚠️ MUST use article class, NEVER beamer class. The beamer class consumes too many TeX grouping levels for its overlay/mode system. Combined with tcbposter's enhanced style on 8+ posterboxes, this triggers ! TeX capacity exceeded, sorry [grouping levels=255]. The article class + geometry package for custom page size is the correct approach. This was validated through 5 failed compilation attempts with beamer before switching to article.

⚠️ NEVER use adjustbox package. It may not be installed in minimal TeX distributions. Use plain \includegraphics[width=0.96\linewidth]{file} instead. Do NOT use max height option (requires adjustbox).

Template Foundation

\documentclass{article}
% A0 landscape: paperwidth=1189mm,paperheight=841mm
% A0 portrait:  paperwidth=841mm,paperheight=1189mm
\usepackage[paperwidth=1189mm,paperheight=841mm,margin=0mm]{geometry}
\usepackage{tcolorbox}
\tcbuselibrary{poster,skins,fitting}
\usepackage{graphicx}
\usepackage{amsmath,amssymb}
\usepackage{enumitem}
\usepackage[table]{xcolor}  % MUST use [table] option for \rowcolor in tables
\usepackage{lmodern}
\usepackage[T1]{fontenc}
\pagestyle{empty}

⚠️ NEVER use \usepackage[most]{tcolorbox} — it pulls in listingsutf8.sty which may not be installed. Always use \tcbuselibrary{poster,skins,fitting} explicitly.

⚠️ Use [table]{xcolor} not plain {xcolor} — needed for \rowcolor in benchmark tables. The colortbl package is loaded automatically by this option.

tcbposter Layout Rules (Critical)

⚠️ The #1 cause of poster failures is content overflow. tcbposter uses a fixed grid — content that exceeds the box is silently clipped with no compilation error. You will NOT see any warning; the poster will simply be cut off.

⚠️ The #2 cause is large whitespace gaps. Using too few rows (e.g., rows=5) creates ~168mm per row on A0 landscape. If title text only needs 120mm, the remaining 48mm is wasted whitespace. Solution: use rows=20 for fine-grained control (~42mm per row). Adjust row distribution to match content density: after trimming text, reduce row allocation proportionally, since cards with valign=top show all whitespace at the bottom.

Grid System: rows=20 (Critical)

Use rows=20 for A0 landscape. Each row ≈ 42mm, giving precise control over section heights.

Recommended row allocation for 4-column A0 landscape:

Section	Rows	Height	Row range
Title bar	3	~126mm	top to row4
Stat banner	2	~84mm	row4 to row6
Body content	14	~588mm	row6 to bottom

Key principle: Always use between=rowN and rowM syntax (not below=name) for precise vertical placement. The below= syntax lets tcolorbox auto-place, which often leaves unwanted gaps.

Row Count Guidance

Poster Size	Orientation	Recommended rows	Columns	Row height
A0	landscape	20	4	~42mm
A0	portrait	20	3	~59mm
A1	landscape	16	3	~37mm
A1	portrait	20	2	~30mm

Portrait A0 Layout (3 columns, rows=20)

⚠️ Portrait A0 posters use 2-3 columns, NEVER 4. Research consensus: "Two columns is typical for a poster with a portrait orientation" (Colin Purrington, NYU poster guides). At 841mm width, 4 columns give only ~195mm per column — too narrow for readable text at poster-session distance. 3 columns (~260mm each) is the recommended default for content-rich papers. Use 2 columns for simpler posters or when figures need more horizontal space.

For portrait posters (841x1189mm), use a 3-column, 3-row-band layout:

Section	Rows	Row range	Content
Title bar	4	top to row4	Title + authors + venue (span=3)
Stat banner	2	row4 to row6	3 headline stat callouts (span=3)
Row A	5	row6 to row11	Background+Motivation, Method (hero fig), Key Results (fig)
Row B	5	row11 to row16	Contributions, Equations+Ablation, Result 2 (fig+table)
Row C	4	row16 to bottom	References+QR, Setup+Benchmarks, Key Takeaways

3-column portrait layout diagram:

┌─────────────────────────────────────┐
│         TITLE BAR (span=3)          │
├─────────────────────────────────────┤
│   Stat 1   │   Stat 2   │  Stat 3  │
├────────────┼────────────┼──────────┤
│ Background │  Method    │ Result 1 │
│ & Motiv.   │ (hero fig) │ (figure) │
├────────────┼────────────┼──────────┤
│ Contribu-  │ Equations  │ Result 2 │
│ tions      │ & Ablation │ (fig+tbl)│
├────────────┼────────────┼──────────┤
│ References │  Setup &   │   Key    │
│ + QR Code  │ Benchmarks │Takeaways │
└────────────┴────────────┴──────────┘

⚠️ All 3 columns in each row band share the same row boundaries. This ensures cross-column alignment. Never mix row6 to row11 in one column with row6 to row10 in another — it creates visual misalignment.

⚠️ Use spacing=0mm for tight layouts. Card separation is handled by card styles (left accent stripe, drop shadow), not grid spacing. Grid spacing > 2mm creates visible gaps between rows.

Modern Card Design System (Left Accent Stripe)

Instead of rounded boxes with colored headers, use a left accent stripe design. This is cleaner, more modern, and avoids the "PowerPoint box" look.

Define 4 card styles using the venue's 3-color system:

% Tinted card backgrounds (NOT pure white — adds warmth)
\definecolor{redbg}{HTML}{FFF5F3}     % warm pink tint for redcard
\definecolor{bluebg}{HTML}{F0F4FF}    % cool blue tint for bluecard
\definecolor{darkbg}{HTML}{FDF6F3}    % warm cream tint for darkcard
\definecolor{redtitlebg}{HTML}{FDEAE8}   % title bar tint
\definecolor{bluetitlebg}{HTML}{E4ECFF}
\definecolor{darktitlebg}{HTML}{F5E8E2}

\tcbset{
  redcard/.style={
    enhanced, arc=0pt, boxrule=0pt, colback=redbg,
    borderline west={5pt}{0pt}{secondary},
    left=16pt, right=14pt, top=4pt, bottom=4pt,
    fonttitle=\fontsize{40}{48}\selectfont\bfseries\color{secondary},
    coltitle=secondary, colbacktitle=redtitlebg,
    toptitle=6pt, bottomtitle=6pt,
    titlerule=2pt, titlerule style={secondary!50},
    valign=top, drop shadow={opacity=0.18},
  },
  bluecard/.style={...same pattern with accent color and bluebg...},
  darkcard/.style={...same pattern with primary color and darkbg...},
  highlightcard/.style={
    enhanced, arc=0pt, boxrule=0pt, colback=primary!18!white,
    borderline west={6pt}{0pt}{primary},
    fonttitle=...\color{white}, colbacktitle=primary,
    ...
  },
}

Card assignment pattern (creates visual rhythm):

• redcard (secondary stripe): Background, Key Idea, Ablation, References, Setup
• bluecard (accent stripe): Result 1, Result 2, Benchmarks, Analysis
• darkcard (primary stripe): Contributions, Method
• highlightcard (primary fill): Key Takeaways / Conclusion

⚠️ Card backgrounds must NOT be pure white (#FFFFFF). Use subtle tints matching the card's color family. Pure white cards on a tinted poster background look disconnected. The tint should be barely visible but adds cohesion.

Figure + Caption Macro

Define a consistent macro for all figures to ensure uniform spacing:

\newcommand{\posterfig}[3]{%
  \centering\includegraphics[width=#1\linewidth]{#2}\\[3mm]
  {\fontsize{26}{32}\selectfont\color{textgray}\textit{#3}}\vspace{2mm}%
}
% Usage: \posterfig{0.96}{figures/results.png}{Caption text here.}

⚠️ Inconsistent figure-text spacing is the #1 visual flaw in generated posters. The \posterfig macro enforces uniform 3mm gap + 2mm bottom padding across all figures.

Content Colorbox Intensity

Inside cards, use \colorbox{color!N} for highlighted blocks. The intensity N must be 18-25% (not 8-12% which is too faint):

% TOO FAINT (invisible on print):
\colorbox{primary!8}{\parbox{...}{...}}

% CORRECT (visible, distinct):
\colorbox{primary!20}{\parbox{0.94\linewidth}{...}}
\colorbox{accent!20}{\parbox{0.94\linewidth}{...}}
\colorbox{secondary!20}{\parbox{0.94\linewidth}{...}}

Similarly, \rowcolor in tables should use 15% intensity: \rowcolor{primary!15}.

Font Size Rules (A0 at article class — NO scale factor)

⚠️ Critical: When using article class (not beamerposter), there is NO automatic scale factor. All font sizes are literal. A poster viewed from 1.5m needs much larger fonts than you think.

Element	Font size	Leading	Example
Title	90pt	108pt	\fontsize{90}{108}\selectfont
Author line	42pt	50pt	\fontsize{42}{50}\selectfont
Section headers	42pt	50pt	via fonttitle=\fontsize{42}{50}...
Sub-headers	38pt	46pt	\subheader{}{} command
Body text	34pt	44pt	\fontsize{34}{44}\selectfont
Stat callout numbers	72pt	86pt	\fontsize{72}{86}\selectfont
Stat callout labels	30pt	36pt	\fontsize{30}{36}\selectfont
Equations	32pt	40pt	\fontsize{32}{40}\selectfont
Table cells	30pt	38pt	\fontsize{30}{38}\selectfont
Figure captions	28pt	34pt	\fontsize{28}{34}\selectfont
References	30pt	40pt	\fontsize{30}{40}\selectfont

⚠️ Lesson learned from testing: Body text at 20pt on A0 is unreadable from more than 0.5m. 34pt is the minimum for comfortable reading at poster-session distance.

Content Budget

Total target: 300-500 words (excluding figure captions and stat callout numbers).

⚠️ The #1 content mistake is too much text. A poster is NOT a paper summary — it's a visual guide. Each bullet should be a key phrase (5-8 words), not a sentence. If you find yourself writing full sentences, you're putting too much text.

⚠️ Content density calibration: When in doubt, use LESS text. It's much easier to add a few words than to trim dense paragraphs. Target ~70% fill per card (some breathing room), NOT 100%.

Box type	Max bullets	Max words	Figure?	Style
Background	3	40-60	No	Short bullets + 1 key insight colorbox
Key Idea / Architecture	0-1	20-30	Yes (hero fig)	Figure dominant + 2 one-liner colorboxes
Contributions	3-4	60-80	No	Numbered, 1 line each
Method	2-3	40-60	No	2 equation colorboxes + 3 short bullets
Results (each)	2-3	30-50	Yes (figure)	Figure + 2-3 one-line colorboxes
Ablation	3	30-40	No	3 colorboxes, 2 lines each max
Analysis	3	30-50	Yes (figure)	Figure + 3 one-line colorboxes
References	4-5	30-40	No	Author (year). Short title. Venue
Setup	4-5	30-40	No	5 one-liner colorboxes
Benchmarks	0	20	No	Table + 1-line caption
Key Takeaways	3	30-40	No	3 short items + code link

Bullet point rules:

• Maximum 8 words per bullet when possible
• Use $\Rightarrow$ and $\to$ for causal arrows instead of words
• Numbers > words: "42% less memory" not "reduces memory usage by 42 percent"
• Colorbox labels: "vs. Depth: 4L CoE ≈ 12L MoE, 42% less memory" (one line)

Recommended 4-Column IMRAD Layout

┌──────────────────────────────────────────────────────────┐
│                    TITLE BAR (span=4)                     │
│     Title (90pt) + Authors (42pt) + Venue + GitHub        │
├──────────────────────────────────────────────────────────┤
│  Stat 1  │  Stat 2  │  Stat 3  │  Stat 4  │  STAT BANNER│
├──────────┼──────────┼──────────┼──────────┤             │
│Background│ Dataset  │Architectu│ Result 2 │             │
│    &     │    &     │   re     │  + Table │             │
│Motivation│Paradigms │ Overview │  + Stats │             │
│    +     │  + Fig   │  + Fig   │  + Fig   │             │
│Contributi│          │──────────│──────────│             │
│   ons    │──────────│ Result 1 │ Ablation │             │
│──────────│Computat. │  + Fig   │──────────│             │
│References│ Models   │  + Table │Conclusion│             │
│ + QR Code│+ Equations│ + Bullets│ + Future │             │
└──────────┴──────────┴──────────┴──────────┘

Workflow

Phase 0: Input Validation & Setup

1. Check prerequisites:

   which pdflatex && which latexmk
   

   If LaTeX is NOT installed, follow the install recipe in ref/texlive-setup.md — Homebrew options, the no-sudo user-directory TeX Live install, and the required tlmgr packages — then re-run the check above.

2. Verify the content plan and its figures:

   ls $PLAN                       # the plan must exist
   ls $FIGURES_DIR                # and the folder it draws figures from
   grep -n '^figure:' $PLAN       # every named figure must be present below
   

   Check the plan parses into the shape in ref/content-plan-spec.md: a title, ## Stat callouts, and ### boxes each carrying a col:. Then confirm every figure: names a file that is actually in $FIGURES_DIR.

   ⛔ If anything is missing, stop and say exactly what. Do not go looking for a paper, do not infer content from a source document, do not invent a figure. This skill renders the plan it was handed; filling gaps is upstream's job (/paper-poster for a paper).

3. Backup existing poster: if poster/ exists, copy to poster-backup-{timestamp}/

4. Create output directory: mkdir -p poster/figures

5. Copy figures into the poster directory:

   # IMPORTANT: Use cp, NOT ln -sf (symlinks)
   # pdflatex often fails to resolve symlinks across directories
   cp $FIGURES_DIR/<figure named in the plan> poster/figures/
   

Phase 1: Read the Content Plan

The selection already happened upstream — this skill does not choose what goes on the poster. Parse $PLAN into the boxes it declares and carry them straight into layout:

• Header — title, authors, and the overrides (venue, size, orientation, columns, link). Plan values win over the Constants above.
• ## Stat callouts — 3-4 headline numbers. These span all columns and replace an abstract paragraph entirely; a poster with a wall of abstract text fails the 60-second test.
• ### boxes — each carries col: (which column), an optional figure: + caption:, an optional stats: table, and its bullets. Render them in the order given.

Do not rewrite the prose. Word budgets, citation honesty, and de-AI polish were the plan author's job (see ref/content-plan-spec.md). If a box overruns its column, report it at the checkpoint rather than silently trimming — the fix belongs in the plan.

🚦 Checkpoint:

📋 Content plan read:
- Title: [title]
- Venue: [VENUE] ([POSTER_SIZE] [ORIENTATION])
- Layout: [COLUMNS] columns, rows=20
- Stat callouts: [N]
- Boxes: Col1=[N], Col2=[N], Col3=[N], Col4=[N]
- Figures referenced: [N] (all present in FIGURES_DIR ✓)
- Prose word count: [N]

Proceed with this layout?

⛔ STOP HERE and wait for user response.

State: Write POSTER_STATE.json with phase: 1.

Phase 2: Figure Placement & Layout

Which figures appear was decided in the plan — every figure: line names one, and Phase 0 already checked each exists. This phase places them, it does not re-select them.

1. Resolve each figure: named in the plan against $FIGURES_DIR:

   ls -la $FIGURES_DIR/*.{pdf,png,jpg,svg} 2>/dev/null
   

2. Copy them into poster/figures/ (cp, never symlink) + convert PDF→PNG at 300 DPI for PPTX

3. Place each into the box that named it, in the column that box declared (col:)

4. Lay out the columns from the plan's box order. The classic IMRAD arrangement, when the plan follows it:

   • Col 1: Background & Motivation + Contributions + References & QR
   • Col 2: Dataset & Paradigms (fig) + Computational Models (equations)
   • Col 3: Architecture (fig) + Result 1 (fig + stat table)
   • Col 4: Result 2 (fig + stat table) + Ablation + Conclusion

   A plan that groups its boxes differently is rendered as given — the col: values are the layout, not a suggestion.

Phase 3: Generate Poster LaTeX

Create poster/main.tex using article class + geometry + tcbposter.

⚠️ Large file handling: if the Write tool fails on main.tex due to file size, use Bash (cat << 'EOF' > file) silently.

Template structure (validated through testing): start from ref/poster-template.tex — copy it to poster/main.tex, substitute the VENUE_* color HEX placeholders from the venue table, and fill the content cards (title bar + stats banner scaffold and the card-style/\posterfig/colorbox usage hints are all in the template).

Key formatting rules:

• Title: 84pt, bold, primary background, white text
• Author line: 36pt, white text
• Section headers: 40pt via fonttitle — colored text on tinted title background
• Body text: 34pt with 44pt leading — \fontsize{34}{44}\selectfont
• Figures: via \posterfig{0.96}{figures/name.png}{Caption} macro
• Stat callout numbers: 66pt in primary color on stathighlight background
• Tables: \renewcommand{\arraystretch}{1.6} with \rowcolor{primary!15} zebra striping
• Equations in colorboxes: use $\displaystyle ...$ (inline), NOT \[...\] (display math adds margins that cause overfull hbox)

Posterbox pattern (using card styles):

\posterbox[redcard, title={Section Title}
]{name=uniquename, column=N, between=rowA and rowB}{
  \fontsize{34}{44}\selectfont
  \begin{itemize}[itemsep=12pt]
    \item Key point one
    \item Key point two
  \end{itemize}
}

⚠️ Equations in narrow colorboxes: Display math \[...\] adds horizontal margins that cause overfull hbox errors inside \colorbox{\parbox{}}. Always use $\displaystyle ...$ with \centering instead. Reduce equation font to 26-28pt inside colorboxes.

🚦 Checkpoint:

🖼️ Poster LaTeX generated:
- Template: article + tcbposter (rows=20)
- Layout: [COLUMNS] columns, [ORIENTATION] [POSTER_SIZE]
- Colors: [VENUE] theme (primary: [HEX] / secondary: [HEX] / accent: [HEX])
- Figures: [N] embedded
- Font sizes: title=90pt, body=34pt, headers=42pt
- Word count: ~[N] words

Compile now?

⛔ STOP HERE and wait for user response.

State: Write POSTER_STATE.json with phase: 3.

Phase 4: Compile Poster

cd poster && latexmk -pdf -interaction=nonstopmode main.tex

⚠️ If using user-directory TeX Live, prepend PATH: export PATH="$HOME/texlive/YYYY/bin/universal-darwin:$PATH"

Error handling loop (max 3 attempts):

1. Parse error log for the first error
2. Fix the most likely cause:
   • grouping levels=255 → STOP. Switch from beamer to article class. This is not fixable by removing styles.
   • Missing package → tlmgr install <package>
   • File not found: adjustbox.sty → Remove \usepackage{adjustbox} and any max height options
   • File not found → verify poster/figures/ has the file (not a broken symlink)
   • Overfull boxes → reduce text or figure size
3. Recompile

Common missing packages (install proactively if not present):

tlmgr install type1cm pdfcol tikzfill

Verification:

pdfinfo poster/main.pdf
# Check: Pages: 1, Page size: ~3370.39 x 2383.94 pts (A0 landscape)

Visual inspection after compilation:

1. All 4 columns have content visible to the bottom — no silent clipping
2. No large whitespace gaps between title/stats and body content
3. Figures are fully visible, not cut off
4. Text is readable (zoom to 100% = actual A0 size)

Phase 5: Visual Review via Claude + Gemini (Iterative Refinement)

This phase uses Claude visual assessment on rendered poster images to iteratively refine layout, readability, and visual hierarchy — similar to the haipipe-display-illustration-gemini skill's review loop.

Step 1: Render poster to PNG preview

import fitz
doc = fitz.open('poster/main.pdf')
page = doc[0]
pix = page.get_pixmap(dpi=200)  # 200 DPI for visual review (higher than 150 preview)
pix.save('poster/poster_review.png')
doc.close()

Step 2: Claude visual assessment

Read the rendered poster/poster_review.png and perform a STRICT visual review with the following rubric (score 1-10):

Critical checks (must all pass, any failure = score ≤ 5):

1. Content accuracy — No fabricated data, all numbers match paper
2. Text readability — All text readable at simulated 1.5m distance (no text too small)
3. No clipping — All content visible, no cut-off figures or text
4. Column alignment — Row bands align across all columns

Secondary checks (affect score 6-10): 5. Visual hierarchy — Title → stat banner → body flow is immediately clear 6. Figure prominence — Figures occupy 40-50% of content area 7. Color coherence — Card tints, accent stripes, and venue colors work harmoniously 8. Whitespace balance — No large empty gaps, no overly cramped sections 9. Information density — Can understand the contribution in 60 seconds 10. Overall aesthetics — Would you be proud to present this at a top venue?

Scoring:

• 9-10: Print-ready, no changes needed
• 7-8: Minor tweaks (spacing, font size adjustments)
• 5-6: Needs revision (layout issues, readability problems)
• 1-4: Major issues (clipping, fabricated data, broken layout)

Step 3: Iterative refinement loop

MAX_ITERATIONS = 5
SCORE_THRESHOLD = 9

for iteration in 1..MAX_ITERATIONS:
    1. Render poster to poster/poster_v{iteration}.png (200 DPI)
    2. Claude reads the PNG and performs STRICT visual review
    3. Score the poster (1-10) with detailed feedback
    4. If score >= SCORE_THRESHOLD → PASS, proceed to Phase 6
    5. If score < SCORE_THRESHOLD:
       a. Identify top 3 issues (ranked by visual impact)
       b. Generate targeted LaTeX fixes for each issue
       c. Apply fixes to main.tex
       d. Recompile (Phase 4 error loop)
       e. Continue to next iteration
    6. Save all versions: poster/poster_v{iteration}.png

⚠️ All versions are preserved. Never overwrite previous renders. Save as poster_v1.png, poster_v2.png, etc. This allows comparison and rollback.

⚠️ Targeted fixes only. Each iteration should fix at most 3 specific issues. Do NOT rewrite the entire LaTeX — small, focused edits prevent regression.

Optional: Gemini visual generation (if mcp__illustrator__run is available):

For poster elements that need custom illustrations (e.g., hero architecture diagram, method workflow), use the Gemini illustration pipeline:

1. Write a detailed specification for the illustration
2. Call mcp__illustrator__run with the specification
3. Claude reviews the generated image for accuracy
4. Iterate until score ≥ 9 or max 3 attempts
5. Save final illustration to poster/figures/ and embed in LaTeX

Step 4: Save visual review log

Append all iteration scores and feedback to poster/POSTER_VISUAL_REVIEW.md:

# Visual Review Log

## Iteration 1 — Score: 7/10
- Issue 1: Title font too small (72pt → should be 84pt+)
- Issue 2: Results figure clipped at bottom
- Issue 3: Stat banner numbers not prominent enough
- Fixes applied: [list of changes]

## Iteration 2 — Score: 9/10
- All critical checks pass
- Minor: References column slightly shorter than others
- Decision: PASS — print-ready

Phase 6: Codex MCP Review

Send the poster content plan + key LaTeX sections to GPT-5.4 xhigh for review.

mcp__codex__codex:
  config: {"model_reasoning_effort": "xhigh"}
  prompt: |
    Review this academic conference poster for [VENUE].

    Evaluate using these criteria (score 1-5 each):

    1. **Information hierarchy** — Can someone understand the contribution in 60 seconds?
    2. **Text density** — Is it concise enough? (Target: 300-500 words total, bullet points only, NO abstract paragraph)
    3. **Figure prominence** — Are key results visually dominant? (Target: figures occupy 40-50% of area)
    4. **Column balance** — Are columns roughly equal height?
    5. **Readability** — Font sizes appropriate for 1.5m distance? (Title ≥90pt, body ≥34pt)
    6. **Narrative flow** — Does the poster tell a left-to-right story?
    7. **Whitespace** — Is content filling the space well? No large empty gaps?

    Poster content:
    [PASTE POSTER_CONTENT_PLAN.md]

    LaTeX source:
    [PASTE key sections of main.tex]

    Provide:
    - Score for each criterion
    - Top 3 actionable fixes (ranked by impact)
    - Overall: Ready to print? (Yes / Needs revision / Major issues)

Apply CRITICAL and MAJOR fixes to poster/main.tex. Recompile if changes were made.

Save review to poster/POSTER_REVIEW.md.

⚠️ Important: After applying review fixes, proceed to Phase 7 only when the poster is finalized. PPTX and SVG must be generated from the final LaTeX/PDF — never from an intermediate version.

Phase 7: Editable Format Export

⚠️ Generate PPTX and SVG only AFTER all revisions are complete. This phase runs last (after review fixes) to ensure all formats contain identical content.

7.1 PowerPoint (.pptx)

Generate a native PPTX using python-pptx (not pandoc — pandoc conversion is lossy):

python3 -c "import pptx" 2>/dev/null || pip install python-pptx

Write a Python script poster/generate_pptx.py that:

1. Creates a single-slide PPTX with poster dimensions (A0 landscape: 1189mm x 841mm)
2. Replicates the 4-column layout using positioned text boxes
3. Embeds PNG figures (from poster/figures/*.png)
4. Applies venue color scheme (primary/secondary/accent) to title bar and section headers
5. Keeps all text editable (not images of text)
6. Uses large font sizes matching the PDF (title 86pt, body 34pt, headers 42pt, stats 68pt)
7. Reads content from the FINAL main.tex — do NOT hardcode content separately

⚠️ PPTX font sizes must also be large. A common mistake is using small fonts (17-24pt) in the PPTX while the PDF has 34pt+. The PPTX is A0-sized so needs identical large fonts.

PPTX helper pattern:

def add_image(left, top, w, filename):
    """Add PNG image, auto-calculate height from aspect ratio."""
    path = os.path.join(FIG_DIR, filename)
    if not os.path.exists(path):
        txt(left, top, w, 60, f"[Image: {filename}]", ...)
        return top + 60
    pic = slide.shapes.add_picture(path, Mm(left), Mm(top), Mm(w))
    h_mm = pic.height / Mm(1)
    return top + h_mm

cd poster && python3 generate_pptx.py
# Output: poster/poster.pptx

7.2 SVG (for Adobe Illustrator)

Convert the compiled PDF to editable SVG. Preferred method: PyMuPDF (always available via pip, no brew/system install needed):

# Preferred: PyMuPDF (pip install pymupdf) — always works, no system deps
python3 -c "import fitz" 2>/dev/null || pip install pymupdf
python3 -c "
import fitz
doc = fitz.open('poster/main.pdf')
page = doc[0]
svg = page.get_svg_image()
with open('poster/poster.svg', 'w') as f:
    f.write(svg)
doc.close()
print('SVG saved')
"

# Fallback 1: pdf2svg (if installed)
which pdf2svg && pdf2svg poster/main.pdf poster/poster.svg

# Fallback 2: inkscape
which inkscape && inkscape poster/main.pdf --export-type=svg --export-filename=poster/poster.svg

⚠️ SVG inherits all layout issues from PDF. If the PDF has whitespace gaps or clipped figures, the SVG will too. Always fix the PDF first.

💡 PyMuPDF bonus: Can also generate PNG previews for quick visual inspection:

pix = page.get_pixmap(dpi=150)
pix.save('poster/poster_preview.png')

7.3 Component-based PPTX (Recommended — PDF→independent shapes)

⚠️ This is the recommended PPTX export method. It produces pixel-perfect output (from PDF) while keeping each poster card as an independent, movable/resizable shape in PowerPoint. The python-pptx rebuild (6.1) loses card styles, shadows, and colorboxes; the full-page image (single PNG) cannot be manipulated at all. This method is the best of both worlds.

How it works: Crop each posterbox region from the compiled PDF at 300 DPI, then embed each crop as a separate picture shape in PPTX at its exact grid position. Result: 10-15 independent shapes that can be individually selected, moved, resized, or deleted in PowerPoint.

Run scripts/poster_components_pptx.py (crops each posterbox region from the PDF at 300 DPI and embeds it at its grid position → poster/poster_components.pptx) — edit its regions dict to match your main.tex grid before running.

⚠️ The regions dict must match your main.tex posterbox grid exactly. Parse the between=rowN and rowM values from each \posterbox to build this dict. If you add/remove cards in LaTeX, update the regions accordingly.

Output comparison:

File	Method	Components movable	Visual fidelity	Text editable	Size
poster.pptx	python-pptx rebuild	Yes	Approximate	Yes	~300 KB
poster_from_pdf.pptx	PDF→single image	No	Perfect	No	~3 MB
poster_components.pptx	PDF→per-card crops	Yes	Perfect	No	~2.5 MB

💡 Tip: To edit text in poster_components.pptx, add a text box on top of the card image and type your replacement text. The image underneath can be deleted or kept as reference.

Phase 8: Poster Speech Script

Generate poster/POSTER_SPEECH.md — a complete script for presenting the poster at a poster session.

Structure:

# Poster Presentation Script

**Paper**: [title]
**Venue**: [VENUE] [YEAR]
**Estimated time**: 2-3 minutes (quick walkthrough)

## Opening (15 seconds)
"Hi, thanks for stopping by! Let me give you a quick overview of our work..."

## Motivation (30 seconds)
[2-3 sentences explaining the problem and why it matters]

## Method (45 seconds)
[3-4 sentences walking through the hero figure and key approach]

## Key Results (30 seconds)
[2-3 sentences highlighting headline numbers from figures]

## Takeaway (15 seconds)
[1-2 sentences summarizing the contribution]

## Closing
"Happy to discuss any questions! Here's a QR code for the paper and code."

---

## Anticipated Q&A

### Q1-Q5: [Most likely questions + suggested answers]

Final Output Summary

📋 Poster generation complete:
- Type: [VENUE] poster ([POSTER_SIZE] [ORIENTATION])
- Files:
  poster/
  ├── main.tex                # LaTeX source (editable)
  ├── main.pdf                # Print-ready PDF (primary output)
  ├── poster_components.pptx  # PPTX with per-card movable shapes (recommended)
  ├── poster.pptx             # PPTX with editable text (approximate layout)
  ├── poster.svg              # Editable SVG (for Illustrator)
  ├── POSTER_CONTENT_PLAN.md
  ├── POSTER_REVIEW.md
  ├── POSTER_VISUAL_REVIEW.md
  ├── POSTER_SPEECH.md
  ├── POSTER_STATE.json
  ├── generate_pptx.py
  └── figures/                # PDF + PNG copies

Next steps:
1. Use poster_components.pptx for layout tweaks (move/resize cards)
2. Use poster.svg for fine vector editing in Illustrator
3. Practice with POSTER_SPEECH.md (target: 2-3 min walkthrough)
4. Print at A0 (300 DPI recommended)

💡 Feishu notifications are optional. If ~/.claude/feishu.json exists, send a notification on completion; otherwise skip.

Parameter Pass-Through

Parameters can be passed inline with — separator:

/paper-poster "paper/" — venue: CVPR, size: A1, orientation: portrait, columns: 3

Parameter	Default	Description
venue	NeurIPS	Conference for color scheme
size	A0	Paper size (A0/A1)
orientation	landscape	landscape/portrait
columns	4	Number of content columns
engine	pdflatex	LaTeX engine (pdflatex/xelatex)
auto proceed	false	Skip checkpoints