@orkastery/cli 0.2.0

package/skills/reviewers/test-engineer/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: test-engineer
+description: "Reviewer de testes do CHECK: aplica testing-patterns.md sobre a suite da thread, confere que a suite verde foi ganha e nao afrouxada, e reporta cobertura com origem declarada."
+bucket: reviewers
+roteia: "ork verify <thread> | ork verify <thread> --baseline | references/testing-patterns.md"
+license: MIT
+---
+
+# Test Engineer
+
+## O que esta skill e
+
+Um roteador fino que aplica [testing-patterns.md](../../../references/testing-patterns.md) a suite
+da thread. Ele nao escreve o teste que falta: ele mostra qual falta e por que, e isso vira tarefa
+de GO. **Suite verde precisa ser ganha, nao declarada.**
+
+## Como rotear
+
+```bash
+ork verify <thread> --baseline     # gravada ANTES do GO
+ork verify <thread>                # reexecucao no HEAD real, comparada com a baseline
+git diff <base>...HEAD -- '*test*' # o que aconteceu com os testes no caminho
+```
+
+## Escopo e conduta
+
+1. **Comparar contra a baseline.** Sem baseline, falha nao distingue regressao de divida
+   pre-existente, e o relatorio vira discussao de culpa.
+2. **Procurar o afrouxamento**, nao so o vermelho: teste removido, teste marcado para pular,
+   assercao trocada pelo valor que o codigo produz hoje. **Ajustar o esperado ao observado e a
+   forma mais comum de transformar defeito em contrato.**
+3. **Exigir o teste que reproduz o defeito** em toda demanda de correcao, e exigir que ele falhasse
+   antes da correcao.
+4. **Reportar numero com origem:** `runtime_reported`, `estimated` ou `unavailable`. Lacuna e
+   publicada como lacuna, nunca como zero.
+
+## O que o nucleo verifica por voce
+
+`ork verify` reexecuta os comandos do manifesto e as claims no HEAD real e carimba o commit.
+Comando que passava na baseline e falha agora sai como `verify.regression`; o que ja falhava sai
+como divida declarada, com o nome do comando.
+
+## Racionalizacoes comuns
+
+| Desculpa | Realidade |
+|---|---|
+| "Esse teste era flaky, marquei para pular" | Pular teste e mudanca de escopo com registro. Sem registro, e o defeito saindo pela porta dos fundos. |
+| "Ajustei a assercao para o valor certo" | Certo segundo quem? Se o valor esperado mudou, a razao esta no PLAN. Ajustar o esperado ao observado transforma defeito em contrato. |
+| "O bug e obvio, o teste de reproducao e redundante" | Correcao cujo defeito nunca foi reproduzido nao prova que corrigiu nada. |
+| "Cobertura esta em uns 80 por cento" | Numero sem origem nao entra. Sem ferramenta, a cobertura sai `unavailable`, com o motivo. |
+| "So o caminho feliz basta, o resto e improvavel" | Suite que so exercita o sucesso mede otimismo. O caminho de falha e onde o usuario encontra o produto. |
+| "Rodei localmente e passou" | Passagem relatada nao e passagem. O que vale e a saida real da reexecucao no HEAD. |
+
+## Bandeiras vermelhas
+
+- Teste removido no mesmo commit que a correcao.
+- `skip` novo sem registro.
+- Assercao alterada sem razao escrita.
+- Cobertura reportada como numero redondo sem ferramenta na maquina.
+- Nenhuma baseline gravada antes do GO.
+
+## Verificacao antes de sair da revisao
+
+Baseline existente, suite reexecutada no HEAD real, diff de testes lido em busca de afrouxamento,
+teste de reproducao presente nas correcoes, e todo numero com origem declarada. Ver `TEST 1` a
+`TEST 12` e `DoD 7`.

package/skills/reviewers/web-performance-auditor/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: web-performance-auditor
+description: "Auditor de performance do CHECK: auditoria condicional que roda quando o alvo tem superficie sensivel a latencia e, quando nao tem, e dispensada por contrato escrito. Nao afirma performance sem medida."
+bucket: reviewers
+roteia: "references/performance-checklist.md | ork verify <thread>"
+license: MIT
+---
+
+# Web Performance Auditor
+
+## O que esta skill e
+
+Um roteador fino que aplica
+[performance-checklist.md](../../../references/performance-checklist.md) ao alvo da thread. Ela e
+**condicional e nunca ausente**: quando o alvo nao tem superficie sensivel a latencia, a secao
+existe e contem a dispensa escrita, com o motivo.
+
+## Como rotear
+
+```bash
+ork verify <thread>            # a suite, e o tempo real que ela leva
+git diff <base>...HEAD         # os lacos e o I/O que o diff introduziu
+```
+
+## Escopo e conduta
+
+1. **Decidir e registrar a aplicabilidade.** Dispensa escrita e resultado; auditoria ausente sem
+   linha nenhuma e lacuna.
+2. **Medir antes de afirmar.** Toda afirmacao de performance traz numero, unidade e como o numero
+   foi obtido. **"Ficou mais rapido" sem medida e opiniao, e opiniao nao passa em gate.**
+3. **Comparar na mesma maquina e no mesmo regime**, com repeticao suficiente para separar sinal de
+   ruido. Uma execucao unica vira `estimated`, nunca `runtime_reported`.
+4. **Medir o caminho do usuario**, nao o microbenchmark conveniente.
+5. **Declarar origem em todo numero**, e o que nao foi medido sai `unavailable` com o motivo, nunca
+   como zero.
+
+## O que o nucleo verifica por voce
+
+A mesma disciplina do gate de tokens do `ork`, que prefere dizer "nao medivel" a inventar uma
+ocupacao de janela: `runtime_reported`, `estimated`, `informada`, `unavailable`. Origem faz parte
+do dado, nao e enfeite do relatorio.
+
+## Racionalizacoes comuns
+
+| Desculpa | Realidade |
+|---|---|
+| "Ficou visivelmente mais rapido" | Sem numero, unidade e metodo, e opiniao. Opiniao nao passa em gate de performance. |
+| "Medi na minha maquina, deu melhor que a do CI" | Comparar maquinas diferentes e comparar maquinas, nao codigo. Mesmo hardware, mesmo regime, ou nao compara. |
+| "Rodei uma vez e ja deu para ver" | Uma execucao vira `estimated`. Sem repeticao nao da para separar ganho de ruido. |
+| "Nao tem interface web, entao pulo a secao" | A secao existe sempre. Sem superficie sensivel, ela contem a dispensa e o motivo. |
+| "Coloco zero onde nao consegui medir" | Zero e um dado, e um dado falso. O que nao foi medido sai `unavailable` com o motivo. |
+
+## Bandeiras vermelhas
+
+- Relatorio de CHECK sem secao de performance, nem mesmo com a dispensa.
+- Afirmacao de ganho sem numero e sem metodo.
+- Numero sem origem declarada.
+- Comparacao entre maquinas ou regimes diferentes apresentada como antes e depois.
+
+## Verificacao antes de sair da auditoria
+
+Aplicabilidade decidida e escrita, medidas com metodo e repeticao quando ha o que medir, caminho do
+usuario coberto, e todo numero com origem. Ver `PERF 1` a `PERF 10` e `DoD 9`.