Padrões
Padrões e manutenção das docs
Mantenha identidade, comportamento, evidência e planejamento em seus lugares.
Documente comportamento verificável
A hierarquia PLAT → SYS → MOD → FEAT organiza o produto. Cada página identifica finalidade, estado, origem e vínculos. Uma feature descreve pré-condições, fluxo, alternativas, pós-condições, regras e critérios de aceite. Dados, APIs e operação precisam de limites explícitos. No Orkastery, o número de uma FEAT nova sai de ork roadmap feat, reservado entre máquinas; nunca do maior número da sua branch. Decisões de arquitetura ficam em ADRs numerados, com contexto, critérios, opções comparadas e a decisão; a ADR-001 diz onde mora a rede das máquinas de uma pessoa.
ork roadmap feat --thread <thread>
ork docs verificar
ork docs sincronizarSepare plano de disponibilidade
O roadmap registra problema, objetivo, escopo, dependências, decisões e critérios de validação. Código mesclado, testes aprovados, deploy e exposição ao usuário são fatos diferentes. Nos sites, o roadmap aparece somente como resumo mensal com link para a fonte.
O estado do código acompanha o git nos dois sentidos: codigo: Mesclado exige o commit do merge na base, e o merge ship(<thread>) da thread do item exige codigo: Mesclado. O ork docs verificar reprova a divergência (docs.paridade.merge) e o índice que não bate com o frontmatter (docs.paridade.indice); no PR, com --pr, os dois só avisam, porque a divergência é da main. O ork docs sincronizar --escrever, num PR de docs depois do merge, corrige os dois.
No Orkastery, ork docs sincronizar atualiza o estado do código a partir do ledger e do git, e a seção sdlc a partir da thread; nunca mexe em ciclo, documentação, deploy, exposição ou habilitação. Na worktree de uma thread, só toca o item dela; --so escolhe os itens e --todos volta a todos. Fechar a thread solta a reserva do item ou a passa para outra thread aberta do mesmo item.
Revisão editorial e visual
Use caixa de frase nos títulos e rótulos; preserve siglas, comandos e nomes próprios. Diagramas têm título, descrição e sequência legível sem depender da cor. Os índices e modelos orientam a edição; os ativos de marca permanecem na origem e não representam funcionalidades adicionais.
O snapshot público registra caminhos relativos e hashes. Sincronizar uma fonte alterada invalida as revisões afetadas. A revisão das três línguas é explícita e o build funciona com o snapshot versionado, sem buscar conteúdo remoto.
Contrato não é resultado medido
Os contratos KG1 fixam grafo e benchmark separadamente. O grafo conserva proveniência e restrições de acesso e recalcula identidades pelo conteúdo. O benchmark fixa pares A/B, tarefas, controles, tentativas e fontes de medida. Corpus sintético valida o contrato; não demonstra economia de tokens, latência ou significância. Uma medida ausente fica null com motivo. A extração do KG2, o índice com consulta do KG3 e o índice incremental do KG4, com os mesmos bytes da extração completa, vieram sem mudar o contrato. O KG4 também mediu a parte determinística e fixou o protocolo da rodada paga como not-run; a rodada paga continua pendente, e nenhum número publicado é economia medida. Os analisadores do KG3, o typescript e o micromark, passaram a ser dependências do pacote, com versão exata, sem mudar os rótulos ork.ts-ast e ork.md-structure. Na versão 0.6.10, a consulta por nó do KG3 passou a trazer o sha256 e o blob do Git de cada fonte citada, que o contrato KG1 já põe em cada evidência, e, em cada aresta, se as fontes dela conferem com a árvore, sem mudar o contrato.