3.4 KiB
| type | name | trigger | description | scope | updatedAt | ativacao |
|---|---|---|---|---|---|---|
| rule | escrita-natural | context_match | Garantir escrita natural, fluida e humana em textos comerciais e de comunicação, evitando linguagem robótica ou excessivamente genérica. | global | 2026-06-01 | Aplicar quando o agente estiver produzindo textos comerciais, de marketing, orçamentos, propostas, reels ou qualquer comunicação voltada ao público externo. NÃO aplicar em documentação técnica (ADRs, rules, JSDoc, regras de negócio). |
Regra: Escrita Estratégica e Natural
🎯 Objetivo
Produzir textos que:
- Mostrem domínio real do problema
- Se destaquem entre propostas genéricas
- Soem humanos, não institucionais
- Convençam com clareza e impacto
🧠 Princípios obrigatórios
1. Começar pelo problema real
Evitar introduções genéricas.
❌ "O presente projeto tem como objetivo..."
✅ "A falta de controle e rastreabilidade ainda compromete a gestão ambiental em muitos municípios."
2. Conectar problema → solução → impacto
Cada parágrafo deve seguir uma lógica clara:
- Qual é o problema?
- Como a solução resolve?
- O que muda na prática?
✅ Exemplo: "A ausência de conectividade em áreas rurais impede o registro adequado de vistorias. A solução permite coleta offline diretamente no celular. Como resultado, elimina perda de informação e reduz retrabalho."
3. Usar exemplos concretos (sempre que possível)
Todo conceito deve ser ancorado na prática.
❌ "A solução permite coleta de dados estruturados."
✅ "O técnico registra fotos, localização e dados da vistoria direto no celular, mesmo sem internet."
4. Escrever como quem vive o problema
O texto deve ter contexto real:
- campo
- operação
- prefeitura
- equipe técnica
✅ "Em prefeituras, a falta de integração entre sistemas gera retrabalho e perda de prazos."
5. Persuasão baseada em impacto real
Evitar adjetivos vazios.
❌ "Solução inovadora e eficiente"
✅ "A solução elimina falhas críticas e garante rastreabilidade completa das informações."
6. Linguagem natural (sem burocracia)
Preferir:
- "Com a solução..."
- "Na prática..."
- "Isso permite..."
- "Como resultado..."
Evitar:
- "Dessa forma"
- "Destarte"
- "O presente projeto"
7. Variar estrutura de frases (regra crítica)
Nunca repetir padrões como:
- "A solução permite..."
- "O sistema permite..."
Alternar com:
- "Na prática, o técnico..."
- "Com isso..."
- "Isso reduz..."
- "Como resultado..."
8. Parágrafos objetivos
- 2 a 4 linhas
- Uma ideia principal por parágrafo
- Explica bem sem ser longo
9. Tom humano e próximo
O texto deve parecer escrito por quem constrói a solução.
✅ "A solução resolve um problema real que impacta o dia a dia das equipes."
🚫 Proibido
- Texto genérico que serve para qualquer projeto
- Parágrafos longos sem exemplo
- Repetição de estrutura
- Uso de termos sem explicação prática
- Linguagem excessivamente institucional
🔍 Checklist final
Antes de finalizar:
- O problema está claro?
- Existe exemplo prático?
- O impacto está explícito?
- O texto soa humano?
- Há repetição de estrutura?
- Parece algo real ou genérico?
💡 Regra de ouro
Se o texto poderia ser usado por qualquer empresa → está errado.
Se parece que vem de quem vive o problema → está certo.