Squad de Sites — Case DorôTEA em 1 Semana

Squad Sites (Luminari)

O time de agentes que constrói o site. Abre com a frase de ativação "Que a experiência seja imaculada" e divide o trabalho entre frontend, QA e deploy.

Lyrak

A agente frontend da squad. Recebe o bundle do Claude Design com visual, intenção e specs, e escreve o código do site em Next.js.

Axikar

O agente de QA. Roda um checklist completo no site e dá o veredicto final: PASS ou FAIL com os pontos identificados.

Gravok

O agente de deploy. É o único agente autorizado a executar `git push` e publicar o código no GitHub para que a Vercel pegue.

Stack técnica

Next.js (framework de frontend) + GitHub (repositório e histórico do código) + Vercel (publicação e CI/CD automático) + domínio próprio (endereço do site com SSL).

Passo 1 — Gerar o KV de Site no Claude Design

No Claude Design (claude.ai/design), crie um projeto novo — não o do Design System — referencie o DS da clínica e peça o KV de Site com o conteúdo das seções de confiança: equipe, método, depoimentos, FAQ e CTA. O KV herda 100% do Design System, garantindo que o site nasça com a identidade certa sem retrabalho. Ao final, as telas do site aparecem no canvas — home, equipe, método, depoimentos, FAQ, contato. Erro comum: esquecer de referenciar o Design System; sem isso, o site sai fora da identidade.

Passo 2 — Handoff para o Claude Code

Com o KV aprovado, clique em "Send to Claude Code". O bundle leva visual, intenção e specs para a squad implementar sem briefing adicional. O resultado é o bundle empacotado, pronto para a squad Sites receber.

Passo 3 — Instalar a squad Sites na pasta do cliente

Vá ao Centro de Treinamento, abra o Claude Code e instale a squad na pasta do projeto. Se ainda não tem o Centro de Treinamento, clone o repositório team-os (github.com/joaoguirunas/team-os). Cada cliente tem sua própria pasta com os agentes instalados, isolando projetos e mantendo tudo organizado. O creator cria a pasta `.claude/`, instala os 10 agentes da Luminari e roda validação — aparece "squad Sites instalado em [caminho]". Erro comum: instalar na pasta errada; confirme o caminho antes de aprovar.

cd ~/empresa/claude-agent-teams
claude

/team-os-creator

Instala o squad Sites na pasta ~/empresa/sites-clientes/dorotea

Passo 4 — Inicializar a squad e jogar o bundle

Entre na pasta do cliente, abra o Claude e rode o team-os. Como é a primeira vez, ele detecta estado NEW e propõe um bootstrap (discovery + smart-memory) — aceite. Depois, coloque o bundle do Claude Design na pasta para dar trabalho à squad. Lyrak constrói o site em Next.js, Axikar valida com PASS ou FAIL, e o site roda localmente para revisão.

cd ~/empresa/sites-clientes/dorotea
claude

/team-os

Passo 5 — Criar o repositório no GitHub

Em github.com, clique no "+" → "New repository". Nome `site-dorotea`, Private, sem README, sem .gitignore, license "None". Crie. O GitHub é o "estado oficial" do projeto — histórico e seguro. É de lá que a Vercel publica. Os arquivos aparecem no GitHub; na primeira vez, o terminal pode pedir autenticação. Erro comum: travar na autenticação — configure uma chave SSH (docs.github.com/en/authentication) ou um Personal Access Token. Faz uma vez só.

git init
git add .
git commit -m "primeiro commit"
git branch -M main
git remote add origin git@github.com:seu-usuario/site-dorotea.git
git push -u origin main

Passo 6 — Deploy na Vercel

Em vercel.com → Add New → Import Git Repository → selecione `site-dorotea`. A Vercel detecta Next.js sozinha. Clique em Deploy. A partir daqui, todo `git push` na branch `main` republica o site automaticamente — sem subir arquivos manualmente. O deploy passa por "Building", "Deploying" e "Ready", e uma URL tipo `site-dorotea.vercel.app` fica no ar. Erro comum: achar que precisa subir arquivos manualmente — não, a Vercel puxa do GitHub.

Passo 7 — Domínio próprio e DNS

Na Vercel → Settings → Domains → adicione `dorotea.com.br`. A Vercel mostra o registro de DNS necessário. No registrador (ex: Registro.br), abra o editor de DNS e crie o registro indicado. O domínio próprio é o que dá cara profissional; o DNS é o que liga o endereço ao site. A propagação leva de 5 minutos a 24 horas (normalmente ~10 min); depois a Vercel gera o SSL grátis e o site abre em `https://dorotea.com.br`. Erro comum: esquecer o `www` — adicione `www.dorotea.com.br` como segundo domínio com redirect.

Tipo CNAME → aponta para cname.vercel-dns.com
(ou registro A para o IP que a Vercel indicar)