Padrões táticos

Comandos curtos para operar os kits sem depender de memória implícita. Ajuste caminhos ao diretório emitido e leia o plano antes de usar --apply. As dicas marcadas como novo na 2.6.0 exigem a versão 2.6.0 ou posterior.

1. Inventarie antes de criar

rg --files | rg '(^|/)(name|termo)'

2. Meça a árvore Git sem confundir não rastreado

git status --short --branch

3. Separe mudança local do último commit

git diff --stat && git diff --cached --stat

4. Encontre a decisão, não só a implementação

rg -n -i 'decisão|decision|rejeitad|supersed' docs . --glob '*.md'

5. Execute o preflight antes do done gate

python frameworks/operator-kit-*/scripts/preflight.py --project .

6. Faça o critério falhar antes da correção

python -m pytest caminho/do/teste.py::test_caso -q

7. Valide sintaxe Python isoladamente

python -m py_compile caminho/do/script.py

8. Rode o self-test do artefato

python caminho/do/script.py --self-test

9. Feche múltiplos critérios com AND

python frameworks/operator-kit-*/scripts/done_gate.py "python -m pytest -q" "python -m py_compile app.py"

10. Declare parcial sem pintar de verde

python frameworks/operator-kit-*/scripts/done_gate.py "python -m pytest -q" --declare-partial "falta validar o destino externo"

11. Instale um kit primeiro em modo plano

python installers/kit-forge-*/kit_doctor.py install --kit <kit> --target . --host claude-code

12. Aplique a instalação somente após ler o plano

python installers/kit-forge-*/kit_doctor.py install --kit <kit> --target . --host claude-code --apply

13. Instale skills namespaced no Codex

python installers/kit-forge-*/kit_doctor.py install --kit <kit> --target . --host codex --apply

14. Verifique integridade de um kit emitido

python installers/kit-forge-*/kit_doctor.py verify <kit>

15. Liste instalações registradas

python installers/kit-forge-*/kit_doctor.py registry

16. Escolha checker de outro provider

python multi-session/lane-kit-*/scripts/checker_router.py --maker claude --require

17. Veja as lanes sem editar o registry

python multi-session/lane-kit-*/scripts/lane_board.py --help

18. Conte itens com uma régua explícita

python frameworks/operator-kit-*/scripts/live_count.py --help

19. Procure erros silenciosos comuns

rg -n 'except\s+Exception|catch\s*\(|\.catch\(' --glob '*.py' --glob '*.js' --glob '*.ts'

20. Confirme a conta GitHub ativa

gh api user --jq .login

21. Compare o remoto antes de enviar

git ls-remote origin refs/heads/main

22. Liste MCPs por host

claude mcp list && codex mcp list

23. Gere o catálogo a partir da árvore

python installers/kit-forge-*/tools/catalog_md.py . --write

24. Valide todas as skills publicadas

find . -type d -name skills -exec python installers/kit-forge-*/tools/skill_lint.py --all {} \;

25. Registre uma execução end-to-end como evidência (novo na 2.6.0)

python -m hpp evidence run --id smoke-page --artifact out/report.html --artifact out/smoke.log -- python examples/evidence/smoke_page.py

26. Re-derive um bundle a partir dos arquivos em disco (novo na 2.6.0)

python -m hpp evidence verify "$(ls -t .hpp/evidence/smoke-page-*.json | head -1)"

27. Meça um retriever antes de confiar nele (novo na 2.6.0)

python -m hpp retrieval eval examples/retrieval/suite.json --retriever-command '["python", "examples/retrieval/keyword_retriever.py"]'

28. Confira que toda citação resolve (novo na 2.6.0)

python -m hpp cite check --text examples/citations/answer.md --context examples/citations/context.json

29. Meça um decisor antes de confiar nele (novo na 2.6.0)

python -m hpp decide eval examples/typed-decisions/gotcha-family-suite.json --decider-command '["python", "examples/typed-decisions/baseline_decider.py"]'

30. Best-of-N é pass@N: escolha um e ainda verifique (novo na 2.6.0)

python multi-session/lane-kit-*/scripts/lane_board.py compete --task T-1 --items T-1a,T-1b --lane lead --model claude-opus-5-5
python multi-session/lane-kit-*/scripts/lane_board.py select --task T-1 --winner T-1a --lane review --model gpt-5.6-sol --reason "smaller diff, same tests"