gramatico

_{instalar · usar · níveis · regras · desenvolvimento · créditos · versões · o site}

🇬🇧 Read in English

em um minuto

• Reescreve texto técnico em português brasileiro para leitura única: sujeito explícito, uma proposição por frase, termos consistentes. Serve a texto que pessoas e agentes leem.
• Cada pedido passa por um nível de rigor, e a skill declara o nível que assumiu.
• Não muda tese, autoria nem conclusão, e não busca fontes. Marca com ⚠ o que não checou.

Como ler esta figura

Em uma frase. Você escreve ptbr: …, e a skill escreve um texto por nível e por idioma.

Como ler. Da esquerda para a direita. A faixa de cima é o caminho de todo pedido; a de baixo, a configuração e os arquivos. A borda laranja marca onde você entra e o que você recebe.

Fora da figura. As regras, o nível smart-note e o pedido ptbr reconfigurar.

Evidência. docs/archify/em-um-minuto.json, a fonte da figura.

instalar

A versão oficial é a v0.4.1. Num terminal:

claude plugin install gramatico --marketplace piabrota/gramatico#v0.4.1

Para fixar a versão num repositório, ponha no .claude/settings.json dele o marketplace piabrota/gramatico com "ref": "v0.4.1" em extraKnownMarketplaces e ative gramatico@gramatico em enabledPlugins. Para atualizar, troque a tag.

OpenCode

O script scripts/install-opencode.sh instala as skills e o plugin do ask-levels a partir de uma tag. ⚠ Ele entra na próxima release; até lá, rode o script de um clone.

Chrome

Uma extensão, ainda sem release, sublinha no campo onde você escreve o que o nível pede para mudar.

1. Rode just ext-build.
2. Em chrome://extensions, ligue o Modo do desenvolvedor e carregue extension/dist/.
3. No popup, escolha o provider e o modelo e clique em Salvar.

Nada muda no texto sem o seu clique em Aceitar. O vermelho marca ortografia, pontuação, concordância e as demais regras; o amarelo, uma frase reorganizada (cartão Reescrita). Nas configurações: o tom, o quanto corrigir, a espera e a lista "nunca corrigir" (Sempre ignorar). O Firefox 128+ usa just ext-build-firefox (guia). Os providers:

• Claude ou DeepSeek: com a sua chave.
• Ollama (local): just ext-ollama serve um modelo nesta máquina, sem chave.
• Ollaya (local, só aponta): just ext-ollaya serve um modelo de decisão. Ele aponta a regra que cada frase quebra e não escreve a troca.
• Ollaya + Ollama: com o Ollama, a chave Ollaya escolhe o estilo faz o Ollaya escolher o tom (conciso, socrático, amigável) em que o Ollama escreve.

⚠ Os providers locais não foram medidos em pt-BR.

Desktop

Um app para Linux, macOS e Windows (Tauri 2, Rust na janela e no núcleo): você cola um texto, escolhe o nível e clica em Revisar. Ele usa a revisão da extensão, com os mesmos providers, sublinhados e cartões. A release traz os instaladores, com o .sha256 de cada um (⚠ ainda não rodou numa tag); o do macOS é arm64, sem notarização: abra por Privacidade e Segurança → Abrir Mesmo Assim.

1. Rode just app-bootstrap: instala o Rust, o tauri-cli e o wasm-bindgen-cli fixados em app/.tools.
2. Rode just app-dev para abrir o app, ou just app-build para gerar o instalador deste sistema.
3. Em Configurações, escolha o provider e o modelo e clique em Salvar.

A chave fica no settings.json da pasta de configuração do app, com modo 0600. just app-screenshot tira a foto da janela com um provider falso, sem chave e sem rede.

Android

O mesmo app no Android, ainda sem release, com uma sobreposição: em qualquer app, ela revisa o campo em que você digita, sublinha o que uma regra pede para mudar e abre as correções por um selo no canto do campo (Aceitar, Ignorar, Pausar neste app). No Android só há a Claude: o texto vai do celular à Anthropic, com a sua chave. Campos de senha nunca são lidos. A chave fica fora do backup; num APK de debug, adb shell run-as a lê.

1. Rode just app-android-bootstrap: precisa do Android SDK (ANDROID_HOME) e de um JDK 17 ou mais novo.
2. Rode just app-android-build e instale o APK de app/target/android com adb install.
3. No app, cole a chave da Claude em Configurações e toque em Ativar nas configurações do Android.

just app-android-screenshot tira as fotos num emulador, com uma Claude falsa. ⚠ Num celular de verdade, com uma chave real, ainda não foi testado. Para a Play Store, um serviço de acessibilidade que não é para acessibilidade precisa de uma declaração do Google (⚠ a política não foi conferida aqui); o APK é de debug, para instalar à mão.

usar

Comando	Faz
/gramatico:ptbr	reescreve no nível pedido, ou classifica o texto e declara o nível
/gramatico:cientifico	texto científico com fontes: artigo, proposta, relatório
/gramatico:bipr	abre o PR do branch com o corpo em pt-BR e o espelho em inglês

Ou descreva a tarefa: "reescreva este runbook em português controlado".

Um pedido que começa com ptbr usa o ptbr-writer.toml. Na primeira vez, o Claude pergunta os níveis, os formatos, a pasta e os idiomas, e grava as respostas:

levels = ["estrito"]     # vazio: a skill classifica e declara o nível
formats = ["md", "pdf"]  # txt, md, pdf, notes
folder = "docs"
languages = ["pt-BR"]    # e/ou "asd-ste100"

Para mudar, edite o arquivo ou escreva ptbr reconfigurar. O pedido vence o arquivo: ptbr leve: ... usa leve. Os arquivos se chamam ptbr-writer-<data>-<objetivo>-<nível>.<ext>.

níveis

Nível	Uso
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

Warning

Um nível de autor, ainda planejado, imita o estilo e nunca copia texto (REUSE.md).

regras

As regras PTW-1 a PTW-17 estão na SKILL.md. A skill cientifico acrescenta as regras CIE. O site mostra cada regra com a sua origem, o roadmap, os projetos relacionados e as figuras:

• Fluxo do plugin do Claude Code
• Fluxo da extensão de navegador
• Fluxo do modelo local
• De onde vem o .pdf

O whitepaper, em 8 páginas, está em WHITEPAPER.pdf e, em inglês, em WHITEPAPER.en.pdf.

tempo de leitura

Todo texto que o plugin gera traz uma estimativa de leitura, calculada pelo binário ptbr-reading-time, nunca de cabeça. Este README tem um limite de 10 minutos, que o just quality confere.

desenvolvimento

Requisito: Nix com flakes. As regras para quem contribui, pessoa ou agente, estão no AGENTS.md.

nix develop      # o shell de desenvolvimento
just quality     # tudo o que o CI checa

créditos

• PTW-1 a PTW-8: o PTC de @kayquer (MIT).
• PTW-9 a PTW-13: a skill ouro-paper de marola-dev/marola-research e o "Audience and evidence" de h0ffmann/ww3-gpu.
• PTW-14 a PTW-17: pedido de @robkler.
• Skill científica: scientific-writing de K-Dense-AI/scientific-agent-skills (MIT, Copyright (c) 2025 K-Dense Inc.) e artigo de labdaps/labskills (MIT, Copyright (c) 2026 LABDAPS), em palavras próprias. Citação pedida: Kassis, T. et al. (2026), Scientific Agent Skills, arXiv:2609.00065.
• smart-note: Sönke Ahrens, Niklas Luhmann e Robert M. Pirsig. Retórica: Platão e Pirsig.
• Nível por autor: a skill orwell-writing de @tamdogood (MIT).
• Tempo de leitura: Brysbaert (2019), Journal of Memory and Language 109, 104047.
• Extensão de navegador: @robkler, no #51.
• Figuras: Archify, de @tt-a1i (MIT). Plugin e roteamento: marola-dev/marola-devkit, de @brunogbv.
• Ícone: um G desenhado à mão em Nix puro, com a caneta de piabrota/nix-os (drawings/pen.nix, vinda do pirsig); veja docs/drawings.
• Site: Lustre (MIT), a stdlib do Gleam (Apache-2.0), fontes do Google Fonts (SIL OFL), e a bandeira e a assinatura de Machado de Assis do Wikimedia Commons, em domínio público.

Os commits fixados de cada fonte estão no AGENTS.md.

licença

MPL-2.0. Veja LICENSE. Quem distribuir um arquivo modificado do gramatico publica esse arquivo sob a MPL. As versões anteriores à v0.3.0 continuam MIT. O que vem de terceiros mantém a licença e o aviso de cada um.

_{gramatico é um fork conceitual e independente do Português Técnico Controlado (PTC), de kayquer (MIT). A metodologia e as regras originais são de lá.}