A oportunidade
A WorkOS lançou o protocolo auth.md e encontrei livre o domínio auth-md.com. Registrei, e no mesmo dia comecei a construir.
A aposta: se auth.md virar padrão (e tem cara de que vai), o site comunitário vai ranquear para todas as queries informacionais sobre o protocolo.
Stack
Astro 6 (100% estático), UnoCSS, deploy via Coolify no meu homelab, domínio no Cloudflare, analytics com GA4 + Plausible self-hosted.
O processo
Usei agentes para quase tudo.
Comecei escrevendo um CONTEXT.md com todas as decisões de design, escopo e stack. Depois usei a skill grill-with-docs do Matt Pocock para stress-testar o plano contra o próprio documento. O agente me questionou até fechar todas as pontas.
Com o plano fechado, parti para o design: estética blueprint reversa (fundo claro, linhas azuis, accent laranja) com diagramas SVG estáticos no estilo CAD (disponível no meu outro projeto DESIGNMD.APP).
O MVP ficou com 5 páginas: Home, What is auth.md, Specification, Install e Validator (placeholder). O foco de SEO/GEO foi na query “what is auth.md” como porta de entrada.
Deploy é push para GitLab, webhook dispara build no Coolify, nginx serve o estático.
Decisões que importaram
Inglês, porque o protocolo é global. Disclaimer claro no footer dizendo que é recurso independente, não oficial da WorkOS. O CTA principal é “instale a skill”, não “leia a spec”, porque quem instala volta ao site como referência. E logos dos early adopters na home, porque ver Resend e Cloudflare ali dá credibilidade instantânea.
Resultado
Site no ar em menos de 48h. Indexado no Google no mesmo dia. O investimento real foi o domínio. O resto foi tempo + agentes.