omd:landing — Landing Page Impactante de Página Única
Uma única página que se constrói com a rolagem e sobrecarrega o visitante. Não se trata de espalhar uma grade de cards, mas de um conceito visual que nasce no hero, se transforma em diferentes composições a cada seção e se fecha no CTA.
A base da marca é o DESIGN.md do projeto, a observação da composição vem do Landing Craft Codex (regras com ID LC-n), e as ações do produto e decisões locais são lidas do brief.
Localização do Codex — repositório: docs/design-excellence/landing-craft-codex.md · instalado: node_modules/oh-my-design-cli/docs/design-excellence/landing-craft-codex.md
(Se ambos não existirem, use node -p "require('path').dirname(require.resolve('oh-my-design-cli/package.json'))" para encontrar a raiz do pacote e leia docs/design-excellence/ abaixo dela).
Não inicie sem ter lido ambos.
Entrada
- Texto completo do
DESIGN.md(se for Core v2, use os marcadores §Scope·Foundations·Components·Content·Motion; se for legado, todas as seções). Use apenas os tokens que estão aqui — sem invenção. O pendente de.omd/preferences.mdsubstitui o DESIGN.md. - Pelo menos uma linha do brief: o que o visitante deve sentir + a ação que deve realizar. Se não houver, receba com um lote de perguntas (no máximo 5).
No modo não supervisionado (
unattended), escolha a primeira opção de cada pergunta e registre emtrace.mdcomoautoSelected. - Codex
landing-craft-codex.md— leia a tabela de regras na íntegra e, para esta execução, selecione os IDs de regras a serem aplicados e anote no storyboard.
Diretório da Execução (crie primeiro)
SLUG=$(printf '%s' "<brand-or-brief>" | tr '[:upper:] ' '[:lower:]-' | tr -cd 'a-z0-9-' | cut -c1-40)
RUN=.omd/runs/landing-$SLUG-$(date +%Y%m%d-%H%M)
mkdir -p "$RUN/assets" && printf '%s\n' "<texto original do brief>" > "$RUN/task.md"
<run> = $RUN acima. Toda a saída deve ser escrita dentro deste diretório (mesma convenção do omd-harness, acrescente uma linha em .omd/runs/INDEX.md).
Saída (apenas dentro do diretório de execução)
<run>/
concept.md Saída do diretor de arte — uma frase de conceito, mood, uso da paleta, direção dos assets, lista de proibições
storyboard.md Tabela de seções: ordem·propósito·altura da viewport·composição(LC-n)·plano de assets(pront)·coreografia de rolagem·esqueleto do copy
assets/ Imagens geradas (canal omd:media) + SVGs inline originais
render.html Arquivo único (0 requisições externas), responsivo a 1440·390, IntersectionObserver para revelar, pinned ≤1, reduced-motion
system.md Descrição do sistema de design desta página (incluindo caminhos de citação de tokens)
loop-trace.json Defeitos por rodada de autoavaliação (render-integrity·landing-integrity·designer-review), autoSelected
trace.md Prompt de imagem original, canal, custo, sha256, retentativas
Procedimento
1. Conceito (agente omd-art-director)
A partir dos fatos da marca no DESIGN.md (§1 Narrativa·§Principles·§Voice) e do brief, extraia uma frase de conceito.
O conceito não é uma lista de adjetivos, mas o que a página "mostra" (ex.: "um corte transversal da tubulação por onde o pagamento flui").
O diretor de arte escreve o conceito, mood, direção dos assets e proibições (anti-padrões do codex + reflexos de design gerado tipo Vercel) em concept.md.
Antes da build, coloque no mesmo arquivo uma tabela de escopo de aplicação:
Decisão | Tipo de fundamento (fato da marca/decisão autorizada do projeto/observação do codex) | Fonte·superfície alvo | Aplicação atual/motivo de não resolvido | Método de verificação.
A observação plana de um controle público é evidência desse controle, não base para proibir todos os objetos 3D ou iluminação da landing.
Não eleve uma direção de cena local a fato corporativo e não crie tokens não verificados. Se a fonte e o alvo são diferentes, deixe como motivo de revisão.
Para assets que já existem no prompt de chamada, descreva-os verbalmente para passar adiante (sujeito·composição·cor dominante·posição do espaço vazio, tamanho em pixels com sips -g pixelWidth -g pixelHeight).
O diretor de arte não abre arquivos de imagem com Read — há casos em que a sessão trava atrás de tool_result de imagem grande (dogfooding 2026-09-02).
2. Storyboard
6 a 8 seções. Cada seção deve ter (a) uma frase de propósito, (b) altura da viewport (citando a regra de ritmo de seção do codex),
(c) padrão de composição — nome do padrão da tabela do codex e LC-n (bleed / inset / stacked / split / pinned-reveal …),
(d) plano de assets — tipo (foto/render/ilustração/UI abstrata)·estado/significado do produto que ilumina·proporção·posicionamento·ocupação alvo da tela pelo sujeito·texto original do prompt de geração(trave os hex da paleta da marca no prompt),
(e) coreografia de rolagem (forma de revelação, duração·easing pelos tokens de Motion do DESIGN.md), (f) esqueleto do copy.
Defina um ponto de impacto — a seção onde a página atinge o ápice e a seção de espaço em branco imediatamente anterior.
Orçamento de Densidade (escreva numericamente — apenas descrever resulta em página vazia)
Quantidade e proporção sozinhas não provam uma cena significativa. Preserve os números abaixo, mas planeje para cada asset qual estado/significado do produto ele ilumina e a área ocupada pelo sujeito real (não pelo contêiner) e verifique no render. SVGs repetidos para preencher contagem, recortes/ampliações do mesmo papel em branco e imagens de satélite sem sentido são proibidos.
Fronteira com
omd-restraint(LC-59 Dial de Densidade). O piso abaixo se aplica integralmente quando o dial ≥ 6 (landing de showcase). Se dial ≤ 5 (página de produto·catálogo·documentação), os limites superiores doomd-restraint(≤ 5 fragmentos na primeira tela, ≤ 4 tamanhos de fonte, ≤ 2 CTAs …) prevalecem. Em qualquer caso, mantenha R1 (um foco)·R2 (fragmentos da primeira tela)·R10 (fato dito uma vez).
- Total de mídia ≥ vh da página × 1.0. Se a página tem 12vh, pelo menos 12 mídias. Conte imagens, vídeos e SVGs inline significativos (não conte ícones individuais — apenas itens ≥ 24px, que não são decorativos, mas conteúdo).
- Mídia no fold (primeira tela) ≥ 3 itens. Medição real do codex: o fold da affinity tem 8 itens.
- Se usar scroll horizontal (LC-15), itens ≥ 8. Scroll horizontal com 3~4 itens não é uma válvula de densidade, é uma linha vazia.
- Assets com movimento ≥ 1. Se
omd:setupconfigurou um canal de vídeo, useimage_to_videopara criar um loop de 6 segundos de um asset da seção. Emprefers-reduced-motion, substitua por uma imagem estática do mesmo frame (autoplay·muted·loop·playsinline). Se não houver canal, anote o fato emtrace.md— não pule silenciosamente. - Meta de tinta por seção ≥ 26% (limite inferior da faixa medida do codex 26–54%). Se insuficiente, ajuste padding, tamanho do sujeito ou expressão de estado necessária.
- Não unifique o padding vertical em um único vh fixo. A primeira saída tinha todas as seções com
18vh/24vh(mediana = máximo = 378px), sem ritmo. Reduza o padding em seções com baixa densidade e dê espaços grandes apenas antes e depois do ponto de impacto.
3. Assets
Execute os prompts do storyboard nos canais detectados por omd:media (sem canal → deixe o pacote de prompts e a fila manual em assets/QUEUE.md, e no lugar coloque placeholders SVG abstratos da paleta da marca — proibido stock·emoji).
Proibido gerar fotos de rostos, proibido gerar logotipos (wordmarks de texto). Registre o prompt·canal·custo de cada imagem em trace.md.
Gerações falhadas devem ser corrigidas conforme a causa; canais limitados·placeholders devem ser registrados em trace.md com a contagem real.
Se uma única cena original atende ao propósito, não crie duplicatas — renderize a revisão com essa composição. Deixe o não cumprimento do orçamento de densidade e as falhas do checker bruto como estão para enviar à revisão de fronteira de aplicação. A criação de uma revisão não é conclusão·waiver·PASS.
A proporção da imagem deve vir da proporção real do slot onde ela será inserida (sem valor padrão — omd:media §1).
4. Build
Arquivo único render.html. Use nomes de tokens do DESIGN.md diretamente como variáveis CSS (--color-…, --space-…).
Reset de estilos padrão do UA (margens de figure/blockquote — #78). Imagens por caminho relativo a assets/ ou data URI.
Movimento apenas com transform·opacity, no máximo 3 durações, tudo parado em @media (prefers-reduced-motion: reduce).
Largura máxima de texto·escala tipográfica·altura de seção dentro dos intervalos numéricos do codex.
Texto sobre foto deve ter um scrim (LC-36 "O impacto deve ser legível"): no hero·pinned stage·seções invertidas, nav·wordmark·lead·CTA·anéis de foco devem ter contraste WCAG 4.5:1 (normal)·3:1 (texto grande·UI) com os pixels de fundo; o meio é um scrim alfa de cor token (::before) e halo do anel de foco — o primeiro toss run recebeu BLOCK 6 por nav com 1.05:1 e wordmark com 1.07:1 sem scrim.
Tokens da série muted não devem ser usados em nenhum texto do corpo, incluindo sobrancelhas e avisos legais (3.0:1).
Revelações de scroll (opacity:0) devem ser visíveis em <noscript> e @media (scripting: none) — página vazia sem JS é defeito.
Requisitos de contraste·teclado e o objetivo de operabilidade por toque deste skill não são geometria de marca observada. Se combinações de tokens existentes não os satisfizerem, proponha a decisão local necessária na tabela de escopo e siga os limites de autoridade. Não dispense falhas de acessibilidade com base em consistência de marca.
5. Loop de Autoavaliação (máximo 3 rodadas — julgue após todas as verificações de aplicação)
No repositório com test-v2/tools/, use o caminho à esquerda; se não existir (pacote instalado), use o comando omd entre parênteses — são as mesmas ferramentas.
① node test-v2/tools/render-integrity.mjs <run>/render.html (instalado: omd check render <run>/render.html) # determinístico
② node test-v2/tools/landing-integrity.mjs <run>/render.html (instalado: omd check landing <run>/render.html) # regras mecânicas do codex
②′ node test-v2/tools/text-contrast.mjs <run>/render.html (instalado: omd check contrast <run>/render.html) # texto sobre foto·gradiente·anéis de foco·no-JS (série BLOCK das duas primeiras execuções)
③ Capturas de tela reais em 1440·390 da rota: compare cada borda de seção com hero·pico·ação·estado de resultado no storyboard
③-b Julgamento bruto do piso de densidade LI-24~26 (tinta na tela 12%·mídia no fold 3 itens·mídia 1 item/vh) junto com revisão de fronteira de aplicação
④ Spawn do subagente `omd-designer-review` (Agente, entrada: caminho absoluto de `<run>/render.html` + caminho do DESIGN.md do projeto + limite de 20 chamadas de ferramenta·15 min·esqueleto de review.md primeiro — conte apenas BLOCKs)
③ não termina só com a captura. O implementador deve olhar a imagem diretamente e verificar se o título·sujeito·controle correspondente·resultado entraram no frame. Não confunda um crop central de scrollIntoView de uma seção grande com o início da seção. Agrupe viewport·posição de scroll·estado·hash de saída, e tire novamente frames cortados. Verifique o percurso de scroll/câmera também com entrada real, não alegue continuidade apenas com seek de QA.
Deixe registrado o método de medição da área do sujeito por asset e o valor medido, comparando com a meta de ocupação. Se for estimativa, marque como estimativa.
Em páginas com ação, execute os itens de aplicação realmente: empty → erro inline de entrada inválida → correção → save → reload, entrada/saída/retorno por teclado, alvos de toque renderizados ≥44×44 CSS px (objetivo de operabilidade deste skill, exceto links inline no corpo), alternativa no-JS·reduced-motion. Erros devem verificar conexão de campo·focus·aria-invalid, resultado de save deve verificar o conteúdo correspondente e persistência. Itens não aplicáveis (ex.: página sem função de save) devem ter a justificativa na task anotada, e não substituir a ação por um alternador de estado de desenvolvedor.
Corrija apenas itens FAIL. Em loop-trace.json, registre defeitos por ferramenta·evidência de ação·verificação de frame·④BLOCK·itens não executados.
Mesmo que apenas ①② passem, não pule contraste·ação·tela real·revisão independente. A verificação só é concluída quando todas as verificações de aplicação forem concluídas e não houver FAIL/BLOCK não resolvidos.
Se os defeitos não diminuírem ou o mesmo ID de regra falhar 2 vezes consecutivas, pare o loop de correção e registre em omd:issue.
Interrupção não é sucesso; deixe as verificações não executadas. Preserve a revisão de conflito de origem e o julgamento bruto do checker como entidades separadas, não crie waivers arbitrários.
6. Demonstração
Use omd:showcase <run>/render.html para criar um vídeo de scroll (mp4/gif) (se não existir,
test-v2/content-runs/build-scroll-compare.mjs captura frames → ffmpeg). Garanta que um aviso não oficial apareça na parte inferior.
Diferencie entre vídeo de entrada real e montagem de frames estáticos. Relate a validação e a adoção visual pelo usuário como coisas separadas, e não afirme aprovação estética ou adoção concluída antes que o usuário adote o resultado.
Resumo de Aplicação do Codex (texto completo no codex; aqui, quais regras são vistas em cada etapa)
| Etapa | Regras | Números-chave (medidos, 5 sites) |
|---|---|---|
| Conceito·Fold | LC-1 | Assets da primeira tela cobrem 89 |
| Ritmo | LC-8~12, LC-14 | Página 10 |
| Composição·Espaço | LC-4~7 | 46 |
| Assets | LC-17~20, §6 tabela | 29 |
| Tipografia | LC-21~25 | display:body 3.0 |
| Cor·Transição | LC-26~28 | Mantenha um ground (252 ou 12); inversão em apenas uma seção (dispositivo de ênfase); tint ~240,240,252 |
| Movimento | LC-13, LC-29~32 | Uma duração dominante (100/300/320/400ms, 33 |
| Autoavaliação | LI-1~23 · #86 | landing-integrity.mjs faz julgamento mecânico (vh da página·proporção de seção·cobertura do fold·proporção de tipo·calha·duração·easing·snap·atributos de vídeo·host stock·grade uniforme de cards·h1) · text-contrast.mjs faz contraste de texto sobre foto·anéis de foco·no-JS |
Regras Rígidas
- Proibido inventar tokens ou fatos de marca que não estão no DESIGN.md. Proibido inventar regras de "gosto" que não estão no codex — julgamentos sem fundamento devem ser marcados como "suposição" em
concept.md. - Se números do codex e tokens do DESIGN.md colidirem, o DESIGN.md vence (ex.: codex LC-21 display:body 3.0×↑ vs Toss h1 36/body 14 = 2.57×). Primeiro verifique se os alvos de aplicação são os mesmos; se a faixa não for atingida, deixe o fundamento na tabela de escopo. Isso não é um PASS automático. Em DESIGN.md sem tokens de Motion (a maioria), use os valores do codex LC-29/30 (300/400ms, etc.) marcando como "extensão local".
- Proibido usar cópias reais de sites, capturas de tela ou logotipos originais. Proibido inventar números estatísticos.
- Crie apenas uma única página. Solicitações para criar várias páginas devem ser redirecionadas para
omd:autopilot(multipágina). - Este skill é um gerador. O julgamento é feito pelas ferramentas e pelo
omd-designer-review— não escreva "bom" sobre seu próprio trabalho.