Skip to content

docs(readme): funde as secoes duplicadas e tira os numeros da auditoria velha - #101

Merged
SouzaRodrigo61 merged 1 commit into
mainfrom
readme-tira-duplicacao
Aug 21, 2026
Merged

SouzaRodrigo61 merged 1 commit into
mainfrom
readme-tira-duplicacao

Conversation

@SouzaRodrigo61

Copy link
Copy Markdown
Owner

Limpeza que sobrou do #100.

Dois pares de seção diziam a mesma coisa

antes depois
Script library: .codemode/ per repo + The repo's script library, and when NOT to use codemode a segunda perdeu o que era duplicata; o útil (comandos de biblioteca, --json, replace_all_in_glob) migrou pra primeira, e o resto virou When NOT to use it — o título do que ela de fato é
What it actually saved, on real work + Measuring what it actually saved: codemode gain títulos quase idênticos pra assuntos diferentes. A segunda é sobre como se mede e o que a telemetria não grava → The telemetry behind those numbers

Números da auditoria velha, fora

"only 7% came from a library" e "17% of audited runs" ainda estavam lá. Substituídos pelo dado atual, que é mais forte porque liga desperdício a falha:

um terço das execuções reais usa uma primitiva só — e essas falham 36% das vezes, contra 5,6% das de 3+.

O one-liner é a coisa mais barata de errar e a mais provável de falhar.

Telemetria: faltava um campo e uma garantia

A descrição não mencionava prims_shell (primeira palavra do comando), que é o campo que responde "o que merece virar primitiva nativa?". Entrou junto com a garantia explícita de que argumento de comando nunca é gravadosh -c "curl -H Authorization: X" grava sh.

Verificação

190 testes. Cercas de código balanceadas, zero ocorrência dos números antigos.

🤖 Generated with Claude Code

https://claude.ai/code/session_01WWZKya94JfUtFcghwMzfjw

…ia velha

Sobraram dois pares redundantes depois do #100:

- "Script library: .codemode/ per repo" e "The repo's script library, and when
  NOT to use codemode" falavam da mesma coisa. O que a segunda tinha de util
  (os comandos de biblioteca, --json, replace_all_in_glob) migrou pra primeira;
  o resto virou uma secao com o titulo do que ela de fato e: "When NOT to use
  it".
- "What it actually saved, on real work" e "Measuring what it actually saved:
  codemode gain" tinham titulo quase identico pra assuntos diferentes. A
  segunda e sobre COMO se mede e o que a telemetria nao grava -- virou "The
  telemetry behind those numbers".

Numeros da auditoria de 200 execucoes que ainda estavam la sairam: "only 7%
came from a library" e "17% of audited runs". Foram substituidos pelo dado
atual, que e mais forte porque liga desperdicio a FALHA: um terco das execucoes
reais usa uma primitiva so, e essas falham 36% das vezes contra 5,6% das de 3+.

A descricao da telemetria tambem estava incompleta: nao mencionava o
`prims_shell` (primeira palavra do comando), que e o campo que responde "o que
merece virar primitiva nativa". Entrou junto com a garantia explicita de que
argumento de comando nunca e gravado.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WWZKya94JfUtFcghwMzfjw
@SouzaRodrigo61
SouzaRodrigo61 merged commit 547defa into main Aug 21, 2026
2 checks passed
@SouzaRodrigo61
SouzaRodrigo61 deleted the readme-tira-duplicacao branch August 21, 2026 01:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant