Git Hooks e Husky: bloque commits sem Frontmatter MDX válido
Publicado em 25 de Outubro de 2026 por David
Acabei de implantar 5 novos artigos no meu blog Next.js. O conteúdo está preciso, o ângulo é certeiro. No entanto, 48 horas depois, o Google Search Console está em alerta. Por quê? Porque um colaborador esqueceu a tag description no Frontmatter de um arquivo .mdx. Ou pior, escreveu titre em vez de title.
Resultado? Uma tag title vazia, um CTR em queda livre nos resultados de busca e, às vezes, até um crash no componente do lado do cliente por causa de um campo de data ausente. Tudo por um erro evitável.
O problema? Confiar na memória humana para o SEO técnico é como jogar roleta-russa com seu tráfego orgânico. As diretrizes no Notion? Ficam acumulando poeira. A única solução radical para proteger sua aquisição de clientes é a restrição: bloquear o erro antes mesmo que ele saia do computador da sua equipe.
O pre-commit hook: seu guardião SEO
No B2B, o orgânico depende de uma execução técnica impecável. Assim como o SEO dos seus documentos PDF determina a sobrevivência das suas publicações sociais, a estrutura dos seus arquivos MDX define sua indexação no Google. Um .mdx mal formatado resulta em uma tag title vazia, um CTR baixo e, às vezes, um componente que quebra no lado do cliente.
A solução? Husky. Essa ferramenta permite explorar os Git Hooks sem atrito. Combinando Husky com um controle na fase do pre-commit, você impede fisicamente o registro de um artigo que viole suas regras de SEO. O terminal pisca em vermelho, o commit é rejeitado e o redator corrige o texto em 30 segundos.
Trancar seu projeto em 20 minutos
Configurar um script que extrai e analisa o cabeçalho dos seus artigos no momento do commit leva apenas 20 minutos. A ferramenta escaneia os arquivos modificados e verifica a presença dos campos obrigatórios: título, resumo, data, imagem de capa.
Você pode ir além com uma validação rigorosa do comprimento. Se a meta description ultrapassar 160 caracteres, o script corta na hora. O commit falha imediatamente. Agora, mesmo que um desenvolvedor freelancer temporário no seu projeto esqueça uma tag, o arquivo corrompido não vai para produção.
A automação técnica deve servir à execução visual
Protegi a estrutura textual do meu blog. Cru, pragmático, implacável.
Mas o conteúdo B2B não vive apenas nos meus arquivos markdown. Para atrair leads qualificados e dominar o LinkedIn, preciso de visuais. Se protejo meu tempo com scripts no código, não vou desperdiçá-lo movendo manualmente blocos de texto no Figma por 3 horas. Meu processo criativo precisa da mesma rigidez que meu Git.
Les illustrations de ce blog sont généreusement mises à disposition par les photographes d' Unsplash.