chimera-run-the-projects-own-gate-command

Você está prestes a rodar o gate de qualidade do projeto — lint, checagem de tipos, testes — e reportar o resultado como evidência de que uma mudança é segura. A tentação é estreitá-lo ("eu só toquei em chimera/") ou apertá-lo ("--strict certamente é melhor").

Não se aplica a exploração. Rodar pytest tests/test_governed_surfaces.py -x enquanto se itera sobre um arquivo é a coisa certa a fazer; a regra é sobre o que você pode então chamar de gate. Uma execução estreitada é um apoio para depurar, nunca a verificação.

1. Encontre onde o comando está escrito, e nomeie UMA fonte como canônica. No Chimera é o alvo check do Makefile — make check — porque um alvo é executável e uma linha em prosa é uma cópia de um. As três checagens que ele roda são ruff check ., mypy chimera e pytest -q.
2. Rode a forma canônica byte a byte. Sem argumento de caminho a mais, sem flag a mais, sem trocar o runner. Cuidado: uma cópia em prosa pode diferir de maneiras que parecem cosméticas e não são: Makefile:21 o embrulha como uv run --no-sync, CONTRIBUTING.md:105 como uv run --extra dev --extra desktop. Mesma ferramenta, ambientes diferentes — que é exatamente por que uma delas tem de ser a fonte.
3. Se duas fontes discordarem, trate o workflow de CI como autoridade, rode aquele, e conserte o doc desatualizado no mesmo PR — o CONTRIBUTING.md carregou uma linha errada com mypy --strict por um tempo, e uma instrução desatualizada se propaga para todo mundo que a lê.
4. Se o comando canônico não roda no seu ambiente, diga que o gate não rodou. No Windows o .venv local está quebrado (o litellm quer Rust/MSVC), então o gate roda no WSL — mudar o shell é permitido, editar o comando não é.
5. Reporte o comando e a saída dele na íntegra, não um resumo de como foi.

O comando canônico costuma ser o mais lento, e uma regra que proíbe a variante rápida empurra na direção de não rodar nada. Esse é um desfecho pior que uma execução estreitada honestamente rotulada.

Meça o custo antes de decidir que a regra é barata, e meça de novo conforme a suíte cresce. O primeiro rascunho deste card dizia que a suíte completa do Chimera levava "uns quinze segundos" — um número que foi verdade uma vez e tinha derivado para uns 100 segundos ao longo de quatro execuções medidas na época em que o card foi escrito. Um card sobre não improvisar comandos é um mau lugar para publicar um número que não sobrevive a rodar o comando.

E a própria receita pode estar errada. Segui-la à risca significa herdar os pontos cegos dela: make check não vai te dizer que um teste lê um bench/local_lift/results/paired.json que está no gitignore e que um clone novo não tem. A correção para um gate ruim é mudar a receita num PR, não rodar em silêncio um gate privado melhor — uma melhoria privada protege exatamente uma pessoa e deixa o CI, e todo mundo mais, no comando antigo.