Prompt

TL;DR: o prompt master em prompts/starlight-operator.md orquestra geração de briefs + Astro project per prospect. Vendedor referencia o prompt, Claude gera tudo, git push e Coolify deploya em <slug>.pandora.mukutu.cloud.

Localização

prompts/starlight-operator.md na raiz do repo starlight.

Versionado no git. Toda mudança = commit + tag v0.X.

Como o vendedor usa

4 passos por prospect:

1. cd 99-development/starlight
2. claude (CLI) ou abre Claude Code no IDE apontando pro repo
3. Cola no prompt inicial:

   “Leia prompts/starlight-operator.md e siga o workflow. Inputs: URL=https://exemplo.com.br, LinkedIn=https://linkedin.com/in/..., contexto=clínica estética em Pinheiros, 2 sócias, foco em harmonização.”

4. Aguarda Claude rodar (briefs + Astro project gerados em clientes/<slug>/) → git add clientes/<slug> && git commit -m "preview: <slug>" && git push. Coolify deploya em <slug>.pandora.mukutu.cloud.

Tools que o prompt assume

Tool	Uso
WebFetch	Lê site do prospect, LinkedIn público, Instagram público
Bash	Cria diretórios clientes/<slug>/ e clientes/<slug>/site/
Read / Write / Edit	Lê prompt, escreve briefs + arquivos Astro
Task (fan-out)	Subagents paralelos pra brand extract + copy + video script + Astro gen

Outputs esperados

6 briefs em clientes/<slug>/:

Arquivo	Conteúdo
brief.md	Briefing curto: posicionamento, ofertas, paleta, tom
brand-extract.md	O que foi extraído do site/LinkedIn: cores, fotos, vozes, ofertas atuais
copy.md	Hero, seções de oferta, FAQ, CTA
email.md	Email outbound (sequência de 3) com placeholder pro link do preview
dm.md	DM Instagram/LinkedIn curta
video-script.md	Roteiro do vídeo Loom de 60-90s

Astro project em clientes/<slug>/site/:

Arquivo	Função
package.json	Deps Astro + scripts dev/build
astro.config.mjs	Config base
tsconfig.json	TS strict
src/layouts/Layout.astro	HTML wrapper + meta tags + fonts
src/pages/index.astro	Landing renderizando hero + cards do copy.md
src/styles/global.css	Paleta extraída do brand-extract
public/favicon.svg	Placeholder ou logo extraído
.gitignore	Node/Astro defaults

Quando atualizar o prompt

• CEO revisa quality dos outputs (briefs + render do Astro) e marca pontos fracos
• Nova vertical (sai estética, entra F&B)
• Nova objeção recorrente que precisa ser endereçada na copy
• Padrão de email que está performando bem (ou mal)
• Template Astro melhorado (novo layout, nova seção, melhor performance)

Versionamento

• Commit no git por mudança significativa
• Tag v0.1, v0.2, … — registra qual versão gerou cada batch de previews
• README dentro de prompts/ lista changelog rápido

Iteração rápida

Cada mudança no prompt = todos os próximos prospects saem com a nova versão. Sem deploy do prompt, sem retrain, sem build. Esse é o leverage do v0 — o “produto” é texto markdown + Astro gerado on-demand.

Limites do v0 (pra justificar evolução futura)

• Claude Code tem rate limits (Pro/Max plan); volume grande pode estourar
• Sem telemetria estruturada de quality dos outputs — feedback é manual via CEO
• Sem retry automático em falha de WebFetch (vendedor precisa rodar de novo)
• Sem cache de brand-extract entre prospects similares
• Sem A/B test automatizado de variações de copy ou template Astro
• Deploy depende de git push manual (Opção A em Hosting)

Quando 2+ desses virarem gargalo real medido, considerar:

• Skill Claude Code dedicada
• MCP server pra brand extract com cache
• Pipeline batch (script Python que chama Claude API em loop)
• Script CLI de deploy via Coolify API (Opção B em Hosting)

→ Próximo: Hosting