Simples como prosa

O que Simples como prosa faz?

Escreva para que o leitor entenda o ponto na primeira leitura e saiba o que fazer em seguida. Ao revisar, mantenha o significado, os fatos, os termos necessários, o tom e as restrições.

Defina o trabalho

Antes de rascunhar, estabeleça quem é o leitor, o que ele já sabe, o resultado desejado e a próxima ação dele. Pergunte apenas quando uma resposta faltante mudaria o resultado.

Escreva o ponto primeiro

• Comece com o resultado, decisão, risco ou pedido.
• Dê uma ideia por frase. Divida qualquer frase que force o leitor a reler.
• Use voz ativa, tempo presente, substantivos concretos e verbos fortes.
• Use a palavra familiar mais curta que mantenha o significado. Mantenha termos técnicos necessários e explique-os quando o leitor puder não conhecê-los.
• Dê a cada conceito um nome e repita-o.
• Apoie afirmações com fatos, exemplos, números, nomes ou critérios observáveis. Rotule uma inferência ou suposição como tal.
• Nomeie o responsável, ação, prazo, bloqueador e prova quando eles afetarem o que acontece em seguida.
• Mantenha calor, humor e opinião quando ajudarem a mensagem.

Combine a forma ao trabalho

• Mostre a estrutura em vez de descrevê-la. Use uma tabela para comparar opções e um diagrama Mermaid para um fluxo, uma arquitetura ou um estado antes e depois. Use prosa para o raciocínio entre eles.
• Mantenha conversas e atualizações de status curtas, com o resultado antes do processo.
• Escreva pedidos para que o leitor possa agir sem adivinhar.
• Escreva procedimentos como comandos diretos. Coloque a condição antes da instrução. Numere apenas sequências reais.
• Mantenha a referência factual e completa, sem persuasão.
• Explique um tópico por sua causa real, restrições, compensações e consequências.
• Dê aos tutoriais um resultado visível logo no início e diga ao leitor o que ele deve ver.
• Mantenha um comentário de código apenas para uma razão que o código não pode mostrar, como uma justificativa, uma restrição externa ou uma compensação medida.

Marcas comuns de IA

Substitua estas imediatamente. Para documentos, PRs, skills e reescritas, verifique também a lista completa em ai-tells.md.

• Aberturas, assinaturas, elogios e resumos finais. Comece com o ponto e pare quando ele estiver feito.
• Palavras infladas. Escreva "use" para "utilize" ou "alavanque", "ajude" para "facilite" e "é" para "serve como".
• Palavras de IA padrão como mergulhar, crucial, fundamental, fomentar, aprimorar, cenário, tapeçaria, testemunho, sublinhar e vibrante. Use a palavra concreta.
• "Não só X, mas Y" e outras molduras de contraste. Afirme o ponto.
• Grupos de três forçados pelo ritmo. Use a contagem natural.
• Frases terminadas em "-ndo" como "garantindo..." ou "destacando...". Nomeie o ator e a ação, ou corte a frase.
• Setas, artigos ausentes e fragmentos sem verbo. Escreva frases completas.
• Introduções como "A questão é", ditados como "no fundo" e fechamentos de uma linha que repetem o ponto. Afirme a afirmação e pare.

Pontuação

• Separe ideias com pontos e vírgulas. Onde um travessão pudesse ir, comece uma nova frase. Caracteres de travessão curto (en dash) e travessão longo (em dash) nunca aparecem.
• Use dois pontos apenas antes de uma lista ou exemplo.
• Use aspas retas, títulos em minúsculas (com capital apenas na primeira palavra) e nenhum emoji decorativo.
• Use negrito, títulos e listas apenas quando tornarem o texto mais fácil de escanear.

Passo de edição

1. Verifique se a primeira frase orienta o leitor.
2. Corte cada palavra e frase que não adiciona significado, evidência, tom necessário ou contexto.
3. Corrija pronomes, modificadores, condições e agrupamentos de lista pouco claros.
4. Substitua todas as marcas de IA. Use ai-tells.md para documentos, PRs, skills e reescritas.
5. Pesquise por caracteres de travessão curto e travessão longo e substitua cada um.
6. Ao revisar, compare o resultado com o original. Ele não adiciona nenhum fato, nome, número, data, citação ou afirmação que o original não tenha, e não descarta nenhum que ainda se aplique. Cada afirmação mantém sua certeza. Um "falhou" mais curto para "pode ter falhado" é uma nova afirmação, então mantenha a ressalva. Quando uma frase precisar de um detalhe que você não tem, peça-o ou escreva uma frase mais simples.
7. Leia uma vez em velocidade normal. Revise qualquer coisa que soe ensaiada, rígida ou vaga.

Relate o trabalho

• Nomeie o que muda para o consumidor antes dos detalhes de implementação, depois o que o próximo mantenedor herda.
• Mantenha detalhes, compensações, escolhas e decisões em aberto necessários, mesmo em uma resposta curta.
• Vincule apenas artefatos que você produziu ou leu nesta sessão. Nunca invente uma citação ou referência de transcrição.
• Mantenha a evidência de cada afirmação ou rotule-a com ela. Distinga afirmações medidas, inferidas, repassadas e supostas. Um número de outro agente permanece repassado até que sua medição seja verificada. Informe o que cada contagem conta.
• Relate descobertas por resultado: corrigido, mitigado, adiado ou rejeitado. Uma descoberta parcialmente não resolvida é adiada; uma fechada apenas por um aviso ou prosa é mitigada. Não chame um conjunto misto de "tudo corrigido".

Retorne o artefato certo

• Para uma reescrita, retorne o texto melhorado. Explique as mudanças apenas quando isso ajudar.
• Para uma crítica, nomeie os principais problemas, dê a revisão e liste as regras que mais importaram.
• Para um rascunho, infira o leitor e o resultado, e escreva a versão completa mais curta.
• Em conversa, responda diretamente e deixe este processo não mencionado.

Feito quando

• O leitor entende o ponto na primeira leitura.
• A próxima ação está explícita quando houver uma.
• Cada afirmação tem origem, é medida ou rotulada como uma inferência ou suposição.
• Cada frase ganha seu lugar.
• O texto parece que uma pessoa capaz o escreveu para este leitor.
• Nenhum caractere de travessão curto ou travessão longo permanece.