# Blueprint review checklist

## Non-negotiable authoring rules

- **Slide titles use Medium (500), which is also the maximum font weight.** No SemiBold, Bold, or heavier authored text. Use grayscale shades for extra hierarchy; historical screenshots do not override this rule.
- **Minimize text content specifically.** Keep slide text concise and tell the user in agent chat about meaningful information omitted or condensed. Preserve essential caveats and explicitly required content; do not make the remaining claims misleading.

## Structural gates

- The primary content hierarchy was decided before its gutter system.
- Exactly one outer gutter system follows the highest-level content bounds; inset content does not receive an extra nested perimeter.
- Outer lines extend to the slide edges.
- Junction markers use the source custom geometry, a visible stroke, and an opaque fill matching the local slide ground.
- Markers sit over the line crossing; they are not filled line-colored dots or transparent outlines.
- Primary dividers receive appropriate junction markers. Secondary list/table/metadata/chart rules do not automatically receive markers.
- Rule color supports the slide; it is not treated as a fixed blue palette requirement.
- The rejected montage and first generated deck did not influence the result.

## Content and rendering gates

- Blank foundations are actually blank apart from geometry.
- Finished slides have no template instructions, image-slot labels, or illustrative chart values masquerading as facts.
- Titles, body text, charts, and essential labels remain readable; no accidental overlap or clipping.
- Images are authentic and their crops serve the content. Artwork bleed is deliberate.
- Scientific claims, units, sources, limitations, and identities are preserved.
- The editable file is checked visually, not merely for node counts.

## Useful review cases

| Scenario | Expected result |
| --- | --- |
| Smaller two-by-two grid | Move the perimeter gutters inward; no double frame |
| Center split | Outlined hexes at the primary divider's boundary junctions |
| Right-hand supporting list | Hexes on the main split, plain internal rows |
| Deep-inset contact | Inward vertical gutters and central horizontal band |
| Colored cover artwork | Same structural logic with adapted rule color |
| Historical solid markers | Correct to stroke plus opaque background fill |

Record user corrections with source links and update every affected guide. A successful render does not prove aesthetic approval. Evaluation datasets, screenshots, review feedback, and promotion history belong in the separate fractal-testing repository; do not store new evaluation artifacts here.

## Mandatory second visual pass — horizontal and vertical alignment

Run this after content, source fidelity, overflow, and marker checks. Re-open the rendered slides with attention specifically on alignment and title weight. Do not stop after a bounds checker passes.

1. **Title weight:** slide titles must be Medium (500), not Regular, and nothing may exceed Medium. Inspect actual text ranges and overrides as well as the shared styles.
2. **Vertical alignment guides (x positions):** compare the left edges of titles, body blocks, captions, and related content across horizontal section boundaries. A section divider does not justify pushing the next block to the right. Check right edges where elements intentionally share a width.
3. **Horizontal alignment guides (y positions):** compare top edges and text baselines across peer columns, image/text sections, repeated panels, and table rows. Match equivalent elements unless the content calls for a deliberate offset.
4. **Section padding:** compare content insets from corresponding gutter boundaries. Use a consistent inset for equivalent regions; avoid independent, arbitrary padding for every section. Gutters themselves may move when hierarchy changes.
5. **Nested frames:** inspect absolute slide coordinates. Two children at local x=0 can still be misaligned because their parents start at different x positions. Auto-layout does not guarantee cross-section alignment.
6. **Visual confirmation:** at a whole-slide view, follow the implied alignment lines; then inspect close enough to judge typography and baselines. Treat arbitrary indentation as a defect. Intentional centering, chart axes, image crops, and a deeply inset composition are not automatically defects—judge them against the slide's hierarchy.
7. **Fix and recheck:** correct unintended offsets and wrong title weights, then render the changed slides again. Record which alignment relationships were checked and any deliberate exceptions. Do not claim alignment verification solely from zero overlap or overflow findings.

### User-supplied failure example


The title and lower section belong to the same overall left-aligned content system. The lower section is too far right, and the title is Regular rather than Medium. The inspected template had title x=116 and lower content-frame x=180: a 64 px unintended shift. Align the lower frame to the title's x anchor; do not add another gutter or move the divider to rationalize the error. This screenshot is a **negative example**, not a layout to copy.

## Secondary-pass focus: table structure and balanced spacing

- Inspect the user-adjusted table (template node `6:121`) as positive evidence before authoring tables.
- Confirm vertical rules separate columns and horizontal rules separate rows. Structural minimalism does not mean removing useful lines.
- Confirm hexes identify major section boundaries, rather than every cell intersection.
- Compare visible whitespace above and below every text line. Fix top-heavy or bottom-heavy padding; bounds and overlap checks cannot detect this defect.
- Check equal horizontal insets for equivalent cells, header/body alignment within each column, and shared vertical alignment across each row.
- Check repeated row heights and spacing for consistency. Allow different header or notes-band proportions only when intentional.
- For multiline cells, inspect the whole text block and the corresponding row's padding. Avoid centering each line independently or distorting one row to fit excess copy.
- Review the whole slide for balance among title, table, and notes sections. Re-render changed slides after adjusting positions or row heights.

### Notes and captions are part of the alignment system

The latest positive table reference (template node `6:121`), supplied at 12:31:40 PM, includes the corrected Medium title and retains the corrected notes-line alignment. Trace one vertical guide through the title, first-column text, and “Methods, definitions, and limitations” line: their left edges align. Do not assign a new arbitrary horizontal inset merely because the notes occupy another section. Also check the notes line's vertical placement and balanced breathing room within its own band. Apply this check to captions, source labels, and footnotes as well as main content.

## Secondary-pass focus: hierarchy and distribution

- Compare the number of semantic peer regions with the visible divisions. Four peer ideas must not accidentally read as two unrelated text stacks.
- Check balance inside each region and across the whole slide: equivalent cells have equivalent padding and shared baselines. Do not fix excess empty lower space by adding text. Reposition content or fit the gutter bounds.
- Confirm the title and first content column share a left anchor.
- Keep explanatory authoring detail in the guide when short slide statements suffice.
- “Secondary rows stay plain” means useful rules without automatic hexes, never an instruction to suppress rules.

See the construction-guide failure example described here: missing middle divider, top-clustered content, mismatched title/content anchors, Regular title, and excessive explanatory text.

## Topmost hierarchy only — explicit correction

Hexes mark only the TOPMOST level of hierarchy division. Identify that level explicitly before placing markers. In a title-plus-grid slide, title and grid are the top-level regions; grid cells are subordinate. Keep all useful grid lines, but omit hexes at their internal crossing and at the four places their dividers meet the grid boundary. Retain the four outer corners and the two title/grid boundary endpoints (six hexes total). A divider touching a top-level boundary does not itself become top-level.
