vue-componentes/.agent/rules/escrita-natural.global.md

3.1 KiB

trigger description
always_on Garantir escrita natural, fluida e humana em textos técnicos e comerciais, evitando linguagem robótica ou excessivamente genérica.

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.