Design Review
Review the rendered marketing page like a strict design director and conversion
reviewer. Lead with concrete issues that make the page generic, unclear,
untrustworthy, inaccessible, slow, or hard to act on. Do not rewrite the whole
page unless the concept is fundamentally wrong.
Inputs
Prefer all of these:
- The creative brief and chosen direction from
design-creative-director.
- The rendered URL or static HTML.
- Desktop and mobile screenshots.
- The changed files or diff.
- The target conversion goal and SEO intent.
If screenshots are missing and the site can run locally, ensure the review has
a claimed task (create a basic one when needed), then render it and capture into
that task's screenshots/ directory before judging — the viewports and sections
to capture are in references/screenshot-checklist.md. If rendering is blocked,
say so and review the code with lower confidence.
Review Passes
Template smoke test.
Use references/quality-rubric.md. Flag any split hero, generic feature grid,
decorative gradient/blob, fake dashboard, vague SaaS copy, stock metaphor, or
one-note palette.
First-viewport test.
In five seconds, can a buyer tell that emisar lets an infrastructure agent keep
working inside explicit bounds, why that is safer than the alternative, and what
to do next? The first viewport must also feel specific to this product. Treat
approvals and audit as proof of control, not the headline outcome.
Narrative and conversion test.
Check the page argument: claim, mechanism, proof, comparison, objections,
trust/security, and CTA. Identify missing proof and weak transitions.
Visual craft test.
Inspect hierarchy, alignment, rhythm, typography, image treatment, spacing,
responsive behavior, and whether the art direction is carried through every
section. Then run the design-interface-polish micro-craft pass for the
small details that read as unfinished, checked against design-system §3.
Usability and accessibility test.
Check scan path, CTA clarity, keyboard/focus states, contrast, reduced motion,
text fit, alt text, mobile ergonomics, and no horizontal overflow.
SEO and performance test.
Check initial HTML content, one H1, title/meta, semantic sections, internal
links, schema candidates, image weight/dimensions, layout shift, and whether
motion/visuals hurt load or comprehension.
Implementation fit.
Check the code matches existing Phoenix/HEEx/Tailwind patterns, keeps marketing
pages server-rendered, avoids unnecessary dependencies, and remains maintainable.
Severity
- BLOCKER: generic concept, false/security-risk claim, broken responsive layout,
inaccessible primary action, SEO/crawl breakage, or page cannot ship.
- MAJOR: weak proof, confusing narrative, visible layout/craft failure, poor mobile
experience, heavy asset/motion problem, or likely conversion loss.
- MINOR: polish issue, copy tightening, inconsistent detail, missing secondary
state, or small SEO/accessibility improvement.
- NIT: optional refinement that does not materially affect clarity or trust.
Output
Verdict: SHIP | SHIP-AFTER-FIXES | RETHINK
Summary: <2-3 sentences>
Findings:
- SEVERITY file:line or viewport - issue - why it matters - concrete fix
Scores:
- Distinctiveness: 1-5
- Clarity: 1-5
- Trust/proof: 1-5
- Visual craft: 1-5
- UX/accessibility: 1-5
- SEO/performance: 1-5
Fix order:
1. <highest leverage fix>
2. <next>
Keep the critique tied to rendered evidence. If the page is clean, say so and list
only residual risks worth acting on.
1---2name: design-review3description: Adversarial art-direction, UX, copy, SEO, accessibility, and implementation review for emisar marketing website pages. Use before shipping public marketing pages, after LLM-generated redesigns, when a page feels generic or overdesigned, or when rendered screenshots need critique against an agency-quality bar.4---56# Design Review78Review the rendered marketing page like a strict design director and conversion9reviewer. Lead with concrete issues that make the page generic, unclear,10untrustworthy, inaccessible, slow, or hard to act on. Do not rewrite the whole11page unless the concept is fundamentally wrong.1213## Inputs1415Prefer all of these:1617- The creative brief and chosen direction from `design-creative-director`.18- The rendered URL or static HTML.19- Desktop and mobile screenshots.20- The changed files or diff.21- The target conversion goal and SEO intent.2223If screenshots are missing and the site can run locally, ensure the review has24a claimed task (create a basic one when needed), then render it and capture into25that task's `screenshots/` directory before judging — the viewports and sections26to capture are in `references/screenshot-checklist.md`. If rendering is blocked,27say so and review the code with lower confidence.2829## Review Passes30311. **Template smoke test.**32 Use `references/quality-rubric.md`. Flag any split hero, generic feature grid,33 decorative gradient/blob, fake dashboard, vague SaaS copy, stock metaphor, or34 one-note palette.35362. **First-viewport test.**37 In five seconds, can a buyer tell that emisar lets an infrastructure agent keep38 working inside explicit bounds, why that is safer than the alternative, and what39 to do next? The first viewport must also feel specific to this product. Treat40 approvals and audit as proof of control, not the headline outcome.41423. **Narrative and conversion test.**43 Check the page argument: claim, mechanism, proof, comparison, objections,44 trust/security, and CTA. Identify missing proof and weak transitions.45464. **Visual craft test.**47 Inspect hierarchy, alignment, rhythm, typography, image treatment, spacing,48 responsive behavior, and whether the art direction is carried through every49 section. Then run the `design-interface-polish` micro-craft pass for the50 small details that read as unfinished, checked against design-system §3.51525. **Usability and accessibility test.**53 Check scan path, CTA clarity, keyboard/focus states, contrast, reduced motion,54 text fit, alt text, mobile ergonomics, and no horizontal overflow.55566. **SEO and performance test.**57 Check initial HTML content, one H1, title/meta, semantic sections, internal58 links, schema candidates, image weight/dimensions, layout shift, and whether59 motion/visuals hurt load or comprehension.60617. **Implementation fit.**62 Check the code matches existing Phoenix/HEEx/Tailwind patterns, keeps marketing63 pages server-rendered, avoids unnecessary dependencies, and remains maintainable.6465## Severity6667- BLOCKER: generic concept, false/security-risk claim, broken responsive layout,68 inaccessible primary action, SEO/crawl breakage, or page cannot ship.69- MAJOR: weak proof, confusing narrative, visible layout/craft failure, poor mobile70 experience, heavy asset/motion problem, or likely conversion loss.71- MINOR: polish issue, copy tightening, inconsistent detail, missing secondary72 state, or small SEO/accessibility improvement.73- NIT: optional refinement that does not materially affect clarity or trust.7475## Output7677```78Verdict: SHIP | SHIP-AFTER-FIXES | RETHINK79Summary: <2-3 sentences>8081Findings:82- SEVERITY file:line or viewport - issue - why it matters - concrete fix8384Scores:85- Distinctiveness: 1-586- Clarity: 1-587- Trust/proof: 1-588- Visual craft: 1-589- UX/accessibility: 1-590- SEO/performance: 1-59192Fix order:931. <highest leverage fix>942. <next>95```9697Keep the critique tied to rendered evidence. If the page is clean, say so and list98only residual risks worth acting on.