MarkitUI: construir páginas
Transforme um briefing, um sitemap, uma lista de páginas, um site de referência ou um site existente em páginas finalizadas no arquivo Figma MarkitUI do usuário. O fluxo é sempre:
bloco da biblioteca → bloco de projeto → página composta em um componente Breakpoint → frames {Page} / xl e {Page} / base desanexados (e {Page} / md se o usuário quiser tablet) em uma Seção por página → notas de handoff.
A própria documentação do arquivo é a fonte da verdade. No início de cada execução, leia os frames de documentação Compondo páginas, Layout e Breakpoints na página de Documentação, e o frame de documentação Navegação para a lista de categorias de blocos. Quando o site tiver um blog, changelog, histórias de clientes ou eventos, leia também o frame de documentação Páginas de arquivo na página Componentes de arquivo e o frame de documentação Montando páginas de arquivo e detalhe na página Blog (Arquivo / Post). Se algo neste skill discordar deles, siga o arquivo.
Antes de começar
- Trabalhe apenas na própria cópia do MarkitUI do usuário. Peça o link do Figma se você não o tiver.
- Escrever no Figma precisa do servidor MCP do Figma com acesso de escrita. Carregue as orientações do MCP do Figma para escrever em arquivos (seu skill
figma-use) antes da primeira edição, e crie uma sessão primeiro se o servidor solicitar. - Mude de páginas do Figma no máximo uma vez por script. Encontre páginas, componentes e coleções de variáveis pelo nome, não pelo ID.
- Blocos da biblioteca e componentes base são finais. Nunca os edite para fazer uma página funcionar. Se algo não puder ser feito com um bloco como ele é, informe o usuário e pergunte.
Perguntas iniciais
Antes de qualquer planejamento, pergunte o que o prompt do usuário já não esclarece, em uma mensagem (use perguntas de múltipla escolha onde a interface as oferecer). Pule uma pergunta apenas quando o prompt a responder de forma inequívoca.
-
A partir do que as páginas devem ser construídas?
- um briefing ou descrição do negócio
- um sitemap ou lista de páginas
- um site de referência a seguir (estrutura apenas, novo texto)
- o site existente deles para reconstruir (mantém o texto deles)
- qualquer outra coisa que eles tenham: capturas de tela, um documento, sites concorrentes, um wireframe
-
Variantes responsivas: quantas variantes de breakpoint cada bloco e página devem ter?
- xl + base (desktop e mobile; padrão, blocos da biblioteca estão prontos)
- xl + md + base (adiciona tablet: uma variante md em cada bloco de projeto e um frame md para cada página)
- md apenas para algumas páginas (eles nomeiam as páginas)
Dê a troca de uma linha de
references/responsive.md. Nunca adicione md sem um sim. -
Nome do projeto, usado em cada nome de componente (ex.:
Acme). -
Tipo de site: site de marketing, loja online, ou ambos.
-
Onde construir: uma nova página Figma no arquivo (ex.:
↳ Páginas Acme) a menos que o usuário nomeie uma. -
Texto: o texto real do usuário, texto escrito no estilo de um site de referência, ou texto placeholder crível.
-
Para lojas: país, moeda e formato de número, taxa de IVA ou imposto sobre vendas.
Em seguida, colete o que a fonte escolhida precisa: o briefing, o sitemap, ou a URL do site (e para um site de referência ou existente, leia references/existing-site.md).
Use blocos de projeto por padrão. Use blocos da biblioteca diretamente apenas se o usuário pedir um protótipo rápido ou uma única landing page.
Fluxo de trabalho
Fase 1: Plano de página (pare para aprovação). Leia references/page-planning.md. O plano declara os breakpoints que o usuário escolheu. Faça um inventário da biblioteca, escolha blocos para cada página e apresente a tabela do plano. Para páginas de Blog, Changelog, Histórias de Clientes ou Eventos & Webinars, leia references/content-types.md e planeje uma página de arquivo e um template de detalhe para cada uma. Quando a entrada for um site existente para reconstruir, leia references/existing-site.md primeiro; ele produz o mesmo plano. Pare e aguarde aprovação ou alterações.
Fase 2: Blocos de projeto. Leia references/project-blocks.md. Clone cada bloco da biblioteca escolhido em um bloco de projeto, renomeie-o e adapte-o no mestre. Construa a navbar, menus e footer também como blocos de projeto. Para blocos de arquivo, defina os componentes de arquivo (cabeçalho, barra lateral, paginação) no mestre do bloco de projeto como references/content-types.md descreve. Se o usuário escolheu md, leia references/responsive.md e adicione uma variante md a cada bloco de projeto que as páginas md usam.
Fase 3: Compor as páginas. Leia references/composing.md e references/content.md. Construa cada página em xl em um componente Breakpoint, duplique para base (e md, seguindo references/responsive.md), desanexe, nomeie, envolva em uma Seção e organize a tela.
Fase 4: Notas de handoff. Leia references/handoff.md. Adicione a anotação de rota a cada frame xl e anotações de comportamento e conteúdo onde um frame estático não pode mostrar o que acontece.
Verifique e relate. Leia references/checks.md. Execute as verificações do script, capture a tela de cada página em cada breakpoint que ela tem, corrija o que encontrar e então relate.
Arquivos de referência: leia cada um quando sua fase chegar
references/page-planning.md: anatomia da página, escolha de blocos, a tabela do plano. Fase 1.references/existing-site.md: reconstruindo um site existente. Fase 1, quando a entrada é um site ao vivo.references/content-types.md: páginas de arquivo e detalhe para Blog, Changelog, Histórias de Clientes e Eventos & Webinars; ArchiveHeader, ArchiveSidebar e ArchivePagination. Fases 1–3, quando o site tem algum deles.references/project-blocks.md: clonagem, nomeação, o que mudar no mestre, regras de design. Fase 2.references/responsive.md: a opção md, adicionando variantes md a blocos de projeto, montando páginas md com o componente Breakpoint. Perguntas iniciais, Fase 2 e Fase 3, quando md é escolhido.references/composing.md: componente Breakpoint, xl e base, desanexação, nomeação, layout da tela. Fase 3.references/content.md: texto, dados de loja, datas, imagens. Fase 3.references/handoff.md: formatos de anotação que desenvolvedores e o skill generate-code dependem. Fase 4.references/checks.md: auditoria, capturas de tela e o relatório. Último.
Inegociáveis
- Faça as perguntas iniciais que o prompt não responder, incluindo variantes responsivas, antes do planejamento.
- Pare após o plano e aguarde aprovação. Nunca construa páginas a partir de um plano não aprovado.
- Nunca edite blocos da biblioteca, componentes base ou componentes de arquivo; todas as alterações vão para blocos de projeto ou substituições de instância.
- Cada página tem um frame xl e um frame base (e um frame md se escolhido) construídos a partir dos mesmos blocos, e o Breakpoint de cada bloco corresponde ao seu frame.
- Tudo permanece nas variáveis e estilos de texto do MarkitUI. Sem cores, espaçamentos, raios ou configurações de fonte brutos.
- Texto real ou crível, nunca Lorem ipsum. Sem marcas ou logotipos reais que não sejam do usuário.
- Cada frame xl recebe uma anotação de rota no formato exato em
references/handoff.md.