Pare de compartilhar demais
Prompts do builder são contexto privado, nunca cópia voltada ao cliente. As interfaces do cliente devem parecer que foram escritas por uma equipe de produto humana: zero vazamentos de internos, zero subtítulos genéricos e zero sinais de copywriting de IA.
Escopo de superfície
- Estrito: Componentes de UI, landing pages, preços, onboarding, configurações, formulários, modais, estados vazios, toasts, loaders, erros, listagens de lojas, metadados SEO.
- Calmo e factual:
/privacidade,/termos,/segurança,llms.txt, documentação de SDK, changelogs (fatos técnicos simples permitidos; hype, metanarrativa como"adicionado para substituir"e clichês de IA proibidos). - Isento: Comentários de código, mensagens de commit, pull requests, documentação interna, visualizações de administrador.
1. O filtro de audiência
Classifique cada fato do prompt antes de escrever o texto da UI:
- DESCARTAR (0 palavras na UI): Filas de revisão (
em revisão,TestFlight,aprovação pendente), bloqueios de KYC ou DNS, detalhes de armazenamento e banco de dados (localStorage,IndexedDB,SQLite,Redis, bancos vetoriais, nomes de modelos), motivos de custo de hospedagem, keystores, IDs de pacote ou loja em prosa, desculpas de assinatura. - TRADUZIR: Reescreva o contexto do builder em palavras calmas para o cliente:
| Contexto interno | Nunca escreva | Escreva em vez disso |
|---|---|---|
| App ou extensão em revisão | Em revisão na App Store, Aprovação pendente | Em breve (apenas em badge de roadmap) |
| Armazenamento offline ou no navegador | Armazenado no IndexedDB, Sem backend | 0 palavras (ou Funciona offline no herói) |
| Busca com IA e LLM de fallback | Consultando vetores Pinecone via fallback Haiku... | Pergunte aos seus documentos / Buscando... |
| Bloqueio de faturamento ou SSO | KYC do Stripe pendente, SAML bloqueado | Informe o caminho já disponível (Assine no app) |
| Build desktop não assinado | Notarização pendente; clique direito para Abrir | Download direto · macOS e Windows |
| Criptografia do sistema | Criptografia de nível militar fora do BD | Sincronização criptografada (especificação em /privacidade) |
| Identificadores de app ou pacote | com.acme.app, id1234567890 | Omitir da prosa; apenas link do badge da loja |
- MANTER: O que funciona hoje e a próxima ação. Veja references/translations.md e references/leak-patterns.md.
2. Contrato de densidade e regra de título reafirmado
Exclua texto de ajuda que repete seu título ou rótulo (Notificações -> "Configure como você recebe notificações"). Nunca narre layout visível ("A tabela abaixo compara...", "Use o formulário abaixo para..."). Nunca preencha cartões esparsos.
| Slot | Teto | Regra |
|---|---|---|
| Subtítulo do herói | 1 frase, <= 18 palavras | Resultado e plataformas suportadas |
| Badge de status | 1 a 3 palavras | Padrão é "Ativo"; badge apenas Em breve |
| Bullet de plano | <= 6 palavras | Apenas funcionalidades já lançadas |
| Subtítulo do cartão | <= 10 palavras (ou 0) | Omitir quando título e botão são suficientes |
| Ajuda de configurações ou formulário | 0 palavras padrão | <= 10 palavras apenas para formatos não óbvios |
| Estado vazio | <= 6 palavras + 1 botão | Zero substantivos de banco de dados, tabela ou consulta |
| Toast | 1 a 4 palavras, sem ! | Salvo, Copiado, Convite enviado |
| Estado de carregamento | 1 a 3 palavras | Buscando..., Gerando... |
| Erro | O que falhou + próximo passo | Zero códigos HTTP, rotas ou janelas de taxa |
3. Regra antiparanoia
Nunca ofereça negações não solicitadas ("Nunca sai do seu computador", "Zero servidores", "100% local", "Nível militar"). Divulgue o tratamento de dados de forma calma em /privacidade.
4. Voz humana
Remova sinais sintéticos de copywriting de IA junto com vazamentos internos:
- Sem contrastes "Não X, apenas Y": Corte configurações negativas ("Não é apenas um app de notas, é...", "Construído para velocidade, não para inchaço", "Sem enrolação, apenas..."). Diga diretamente o que o produto faz.
- Sem slogans forçados de três batidas: Corte fragmentos de três batidas ("Rápido. Simples. Poderoso.", "Planeje. Acompanhe. Entregue."). Substitua trincas ("projetar, colaborar e escalar") por uma capacidade concreta ou número.
- Sem travessões (
—) ou--espaçados na cópia da UI: Use pontos, vírgulas ou dois pontos, ou corte a segunda oração. - Sem chavões genéricos de IA ou terminações
-ção: Proíbaperfeito(a),sem esforço,supercarregar,liberar,elevar,empoderar,otimizar,de ponta,de última geração,revolucionário,robusto,personalizado,aprofundar,tapeçaria,fundamental,reinventar,criado para equipes modernase particípios acoplados ("...garantindo sincronização sem esforço"). Prefira verbos simples (é,tem,sincroniza,exporta) em vez deserve comoouostenta. - Sem formatação decorativa: Escreva títulos, rótulos de cartões e botões em caixa baixa (mantenha Capital Inicial para nomes próprios e nomes de planos). Nunca coloque bullets de emoji (
🚀,✨,⚡,🔒,💡,🎉) em listas de funcionalidades ou títulos. Nunca repita**Rótulo em Negrito:** explicaçãoem listas de funcionalidades. - Sem microcópia de chatbot ou falso entusiasmo: Corte aberturas encenadas ("Vamos começar", "Aqui está o que você precisa saber"), elogios exagerados ("Você está pronto!", "Incrível!"), desculpas falsas ("Ops! Algo deu errado") e pontos de exclamação em estados de UI rotineiros.
5. Modo de auditoria e bandeiras vermelhas
Escaneie árvores de fonte com python3 scripts/audit.py src/ app/, depois reescreva a cópia sinalizada em torno de fatos concretos em vez de trocar palavras por sinônimos. Veja references/examples.md.
Bandeiras vermelhas que exigem reescrita imediata: em revisão, aprovação pendente, localStorage, armazenamento local, IndexedDB, sem backend, embeddings vetoriais, modelo de fallback, limite de taxa, KYC, notarização, nunca sai do seu, nível militar, IDs de pacote em prosa, subtítulos de configurações reafirmados, "foi salvo com sucesso", sem esforço, perfeito, supercarregar, liberar, não é apenas um, slogans de três palavras, bullets de emoji em funcionalidades, travessões entre parênteses, "Ops! Algo deu errado", "Você está pronto!".