HTML over WebSockets vs SPA — Pacote Multi-Arquivo para ADR de Adoção de Server-Driven UI (Event-Driven) — 5 Arquivos

Pacote multi-arquivo (5 arquivos) para decidir, com critérios objetivos, entre adotar HTML over WebSockets (server-driven UI, estilo Phoenix LiveView / Django LiveView / Blazor / Reverb) ou manter uma SPA tradicional (REST + JSON + framework JS) — e, se o "over the wire" já estiver decidido, escolher o transporte certo: HTTP/htmx, SSE ou WebSocket. O assunto está em alta: o ensaio "HTML over WebSockets: real-time SPAs with barely any JavaScript" (Andros Fenollosa) chegou ao Top 7 do Hacker News em Ago/2026, reacendendo o debate arquitetural entre render server-side e client-side.

Este NÃO é um prompt solto. É um pacote completo, no padrão usado por engenheiros para levar um agente a ~99% de precisão numa tarefa real, com 5 arquivos complementares:

• 01-prompt-principal.md — o prompt reusável que transforma o LLM num Arquiteto de Software Sênior especializado em event-driven/server-driven UI. Define persona, objetivo, schema de saída EXATO (ADR de adoção com 9 seções + matriz Opções × Critérios) e um passo a passo de raciocínio de 9 etapas. • 02-regras-e-restricoes.md — guardrails numerados e imperativos: zero alucinação de benchmarks/frameworks, proibição de viés "WebSocket é sempre melhor", estado sempre explícito, formato de erro JSON padronizado e os casos de borda (recurso que "não precisa" real-time, app público indexável, firewall que bloqueia WS, offline-first, escala massiva de leitura, SPA já madura). • 03-contexto-e-exemplos.md — glossário do domínio (SPA vs HTML over the wire, transporte HTTP/SSE/WS, estado server-side, broadcast/pub-sub, sticky sessions) + 2 exemplos few-shot completos, sendo um caso difícil/borda (produto híbrido com SEO + painel + firewalls de clientes). • 04-harness-de-verificacao.md — checklist de autoverificação de 12 itens que o modelo roda antes de entregar + 10 critérios objetivos de aceite (A1–A10) que VOCÊ usa para validar a decisão antes do PR. • 05-templates-de-variacao.md — 4 variações: ADR-Lite rápido, adaptação por stack (Phoenix, Django, Laravel/Reverb, Blazor/SignalR), formato curto × longo e decisão de transporte isolada.

O resultado é um ADR (Architecture Decision Record) acionável que diz — com critérios mensuráveis, trade-offs e casos de teste — se o seu produto deve adotar WebSocket, outra variante over the wire, ou manter a SPA; e detalha as implicações event-driven: onde o estado vive, como o broadcast/fan-out funciona, sticky sessions, memória por conexão e o papel do pub/sub/mensageria multi-nó. Inclui 3 diagramas SVG do conceito (comparação SPA×LiveView, arquitetura de broadcast e matriz de transporte).

Compatível com agentes de saída estruturada (GPT-4o/4, Claude, Gemini). Ideal para plataformas web, times que avaliam LiveView/htmx para real-time, e arquitetos que precisam formalizar a decisão entre render server-side e SPA em um ADR revisável.