Reescreve texto técnico em português brasileiro por nível de rigor (estrito, descritivo, leve, científico, smart-note). Use ao escrever, reescrever ou revisar runbook, documentação, comunicado ou notas em pt-BR.
# gramatico
Reescreva texto técnico em português brasileiro para leitura única, com sujeito explícito, proposições claras e termos consistentes.
## Uso
Invoque pelo nome ou pelo alias:
```
/ptbr-writer
/ptbr
```
Ou descreva a tarefa:
- "reescreva este runbook em português controlado"
- "tire a ambiguidade deste texto"
- "revise este comunicado"
## Níveis de rigor
- `estrito`: runbooks, procedimentos, saídas para agentes.
- `descritivo`: documentação de sistema.
- `leve`: comunicados internos.
- `científico`: artigos, propostas, relatórios técnicos com fontes.
- `smart-note`: notas para um segundo cérebro; combina com outro nível (`smart-note + estrito`).
## Regras (em desenvolvimento)
As regras abaixo são uma adaptação pessoal do PTC. Quando você não especifica o nível, a skill classifica sozinha e declara o que assumiu.
### PTW-1: Quem faz, aparece
Sujeito explícito. Evite `-se` apassivador, `o mesmo` e clíticos de terceira pessoa ambíguos.
### PTW-2: Uma proposição por frase
Corte gerúndios conectores e subordinadas que escondem uma segunda ação.
### PTW-3: Modalidade e quantidade explícitas
`deve` = obrigação. Probabilidade por número ou intervalo, nunca por modal vago.
### PTW-4: Verbo pleno
`realizar a validação` → `validar`.
### PTW-5: Sintaxe plana
Cadeia de `de` curta, adjetivo pós-nominal, nada entre verbo e objeto.
### PTW-6: Termos congelados
Um conceito, um termo. Fixa a variante brasileira.
### PTW-7: Números, datas e unidades
Vírgula decimal. Datas ISO 8601. Unidades padronizadas.
### PTW-8: Ortografia PT-BR vigente
Acordo de 1990, com atenção a prefixos técnicos (`microsserviço`, `autosserviço`).
### PTW-9: Toda afirmação tem marca
No nível `científico`, cada afirmação leva `(v)`, `(v, só título)` ou `⚠`. A skill preserva as marcas e nunca remove um `⚠`. Afirmação reescrita perde o `(v)`: marque `⚠` e avise.
### PTW-10: Nenhuma referência inventada
A skill nunca adiciona, completa ou corrige citação ou DOI de memória. Referência incompleta vira `⚠` na tabela de violações.
### PTW-11: Número com unidade e origem
No nível `científico`, número sem unidade, ou sem comando ou fonte, é sinalizado. Adjetivo de quantidade (`muito mais rápido`) vira número ou `⚠`.
### PTW-12: Sem alegação de pioneirismo
`inédito`, `pela primeira vez`, `até onde sabemos`, `novo método`: estreite para o que foi consultado e quando, ou liste como não sabido.
### PTW-13: Fato separado de análise
Cada frase é fato com fonte ou leitura do autor, e diz qual. `A fonte não diz` não é `não é assim`.
### PTW-14: Palavras inteiras e por extenso
Separe e junte palavras (`bomd ia` vira `bom dia`). Troque abreviação de internet pela palavra (`vc` vira `você`, `pq` vira `porque`). O Acordo de 1990 fica com a PTW-8.
### PTW-15: Pontuação
Vírgula depois de vocativo e de saudação. Ponto final no fim da frase. `?` em pergunta. Vírgula antes de `mas`. Nunca vírgula entre sujeito e verbo.
### PTW-16: Maiúsculas e concordância
Maiúscula no início da frase e em nome próprio. Concordância verbal e nominal (`os relatórios estão prontos`).
### PTW-17: Frase reorganizada
Reescreva inteira a frase confusa, longa ou ambígua, no tom pedido. Não mude o sentido nem acrescente informação. A frase reescrita já leva as correções das PTW-8 e PTW-14 a 16. Não reescreva a frase que já está correta e clara.
## Limites
A skill não muda tese, autoria nem conclusões: quem decide é o humano. Ela não busca fontes; marca o que não foi checado.
## Smart note
Combina com outro nível: aplica as regras dele e entrega em notas. Duas saídas, `RAW` (só o texto) e `nota` (indexável, com front matter); sem pedido, entregue as duas.
1. Uma ideia, uma nota: uma afirmação, um fato ou uma pergunta. Cinco ideias, cinco notas.
2. Palavras próprias. Cite literal só o que precisa ficar exato, entre aspas, com a fonte.
3. Nome permanente `<id>-<slug>.md`; `id` é a hora UTC da criação, `AAAAMMDDhhmm`. O id não muda; o título pode.
4. Front matter: `id`, `title`, `type`, `status`, `source`, `tags`, `created` (ISO 8601).
5. `type`: `fleeting` (ideia crua, como veio), `literature` (o que uma fonte diz, com link ou DOI), `permanent` (afirmação própria, feita de outras notas).
6. `status`: `unverified`, `partial`, `verified`, `open-question` ou `approved`. `approved` é a palavra do dono, não checagem de fato; só o dono dá, e a nota diz quando.
7. Links: toda nota liga a pelo menos uma outra com `[[<id>-<slug>]]`, que existe. Sem vizinha conhecida, proponha o link e marque `⚠`.
8. Verdade: afirmação factual fica `unverified` até a fonte ser lida e citada na nota. Nunca invente fonte, citação ou número.
9. Pessoas: quem não é figura pública aparece por apelido (`friend1`, `prof1`), nunca pelo nome.
10. Tags: minúsculas, com hífen, poucas; reuse as que o cofre já tem.
## Formato de saída
1. Nível e destinatário assumidos.
2. Tabela de violações: regra, trecho original, reescrita.
3. Texto final.
4. Nota sobre o que foi mantido de propósito.
5. Lista de `⚠`: afirmações sem checagem e referências a buscar, no nível `científico`.
6. Linha de tempo de leitura no texto final: `Leitura estimada: ~N min (P palavras, L links, B blocos de código)`, ou `< 1 min`; em inglês, `Estimated reading time: ...`. Com Bash e o comando de tempo de leitura (o pedido `ptbr` o dá), rode `<comando> [--lang en] <arquivo>`; sem eles, calcule à mão: palavras da prosa ÷ 238 por minuto, × 1,15 se a frase média passa de 20 palavras, × 1,15 se mais de 25% das palavras têm 10 letras ou mais, + 10 s por linha de código, + 5 s por link, arredondado para cima. Nunca invente o número.
h0ffmann/skills