Luiz Silva
bf9be375e2
- 55 arquivos .md renomeados para sem extensão - Convenção: artefatos de conhecimento sem extensão, scripts (.sh) e dados (.json) mantêm extensão - Scripts atualizados: gerar-manifesto.sh, atualizar-agente.sh, atualizar-agente.global.sh, gerar-agent-json.sh, verificar-linhas.sh - Documentação reescrita: AGENTS, README, EXTEND para refletir uso como submodule .agent direto - manifesto.json regenerado v3.0.0 - Todas as referências internas entre artefatos atualizadas BREAKING CHANGE: arquivos não possuem mais extensão .md
169 lines
No EOL
3.4 KiB
Text
169 lines
No EOL
3.4 KiB
Text
---
|
|
type: rule
|
|
name: escrita-natural
|
|
trigger: context_match
|
|
description: Garantir escrita natural, fluida e humana em textos comerciais e de comunicação, evitando linguagem robótica ou excessivamente genérica.
|
|
scope: global
|
|
updatedAt: "2026-06-01"
|
|
ativacao: >
|
|
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. |