Proposta aberta · v0.1 experimental

Português Técnico Essencial

Uma proposta aberta para documentação técnica em português. Regras de escrita e vocabulário consistente, com foco em reduzir a ambiguidade das instruções.

v0.1Versão experimental. Disponível para avaliação e uso em projetos piloto.
Exemplo de aplicaçãoProcedimento técnico

antes ambíguo

O operador deverá efetuar a verificação do nível e, caso seja necessário, proceder com o completamento do reservatório, sendo que o motor deve estar desligado.

depois verificável

  1. Desligue o motor.
  2. Verifique o nível do reservatório.
  3. Se o nível estiver abaixo da marca MÍN, adicione fluido e pare quando o nível alcançar a marca MÁX.
↳Ação direta. Condição explícita. Resultado que pode ser conferido.
R006 · R011 · R014 · R021 · R026pte-100:0.1
A proposta

Menos margem para interpretações.

O PTE-100 parte de um problema simples: uma instrução pode estar gramaticalmente correta e ainda assim permitir interpretações operacionais diferentes.

01Uma interpretação operacional

Quem age, o que faz, em que ordem e sob quais condições.

02Uma forma por conceito

Um termo consistente para cada conceito, conforme o vocabulário do projeto.

03Segurança antes da brevidade

Uma frase pode repetir o termo quando isso evita um risco.

Como funciona

Três níveis de aplicação.

Os níveis são cumulativos. Comece pela estrutura, avance para a clareza e acrescente contexto e metadados para busca, tradução e uso por IA. O nível PTE-IA organiza o conteúdo; não executa IA.

01

PTE-Estrutura

Organiza títulos, alertas, listas, dados e referências.

R031–R046
02

PTE-Claro

Controla vocabulário, frases e procedimentos.

R001–R030
03

PTE-IA

Adiciona contexto, metadados, IDs e proveniência.

R047–R050
O núcleo

50 regras experimentais organizadas por assunto.

O catálogo v0.1 transforma decisões editoriais em regras legíveis por pessoas e ferramentas. A fonte canônica é YAML; o catálogo humano é gerado a partir dela.

Explorar o catálogo
Ferramenta de revisão

Revise documentos com o PTE-Lint.

O PTE-Lint é um MVP offline para Markdown e texto simples, com saída em texto, JSON e SARIF. Ele preserva o arquivo original, identifica a regra e sugere um caminho de revisão.

21 regras automáticas0 rede por padrão3 formatos de saída

As outras 29 regras têm modo assistido especificado, mas ainda não são verificadas pelo motor. O lint auxilia a revisão; não certifica segurança ou correção técnica.

O revisor local abre no navegador, usa o mesmo motor e aceita Markdown, texto simples e PDF com camada de texto. OCR e IA integrada estão fora do MVP.

Começar com o revisor local
pte-lint / exemplo ilustrativooffline

$ bin/pte-lint check procedure.md

analisando 1 arquivo · perfil pte-claro

R014 condição de execução posterior à ação

  Substitua o fusível se o indicador permanecer apagado.

↳ Mova a condição para antes da ação.

✓ análise concluída · 1 diagnóstico explicável

Skills para agentes

Leve a revisão para seu projeto.

Baixe duas skills com fontes PTE-100 v0.1: revisão documental e avaliação de evidências para piloto. O pack inclui o PTE-Lint opcional para Markdown e texto, sem precisar clonar o repositório.

Copie as pastas completas para o diretório de skills do seu agente e peça a revisão em pt-BR. O lint verifica 21 regras; as outras 29 precisam de avaliação com evidência e revisão humana.

Baixar pack de skills Como instalar e usar Conferir SHA-256 do ZIP

O PTE-Lint roda offline. Um agente com modelo remoto pode enviar documentos ao provedor: para conteúdo confidencial, configure um modelo local ou siga sua política de dados. O pack não certifica conformidade ou segurança.

A proposta é pública

Participe do desenvolvimento.

O PTE-100 ainda está em versão experimental. Use em pilotos, registre falsos positivos e envie evidências pelos formulários de contribuição.

Como contribuir Participar das discussões