Skip to content

docs(idioms): atualiza a folha do binario com o que mudou no v1.2 (#78, #61, #62, #63, #72) - #99

Merged
SouzaRodrigo61 merged 1 commit into
mainfrom
idioms-atualiza
Aug 21, 2026
Merged

SouzaRodrigo61 merged 1 commit into
mainfrom
idioms-atualiza

Conversation

@SouzaRodrigo61

Copy link
Copy Markdown
Owner

Por que a folha do binário importa mais que qualquer doc

codemode idioms mora no binário de propósito: CLAUDE.md, AGENTS.md e skills não são herdados por subagente nem lidos por Codex/Grok — mas o binário está no PATH de todo mundo. É o único canal que alcança qualquer modelo.

E por isso é o que mais custa quando está desatualizado. Até agora a folha não dizia que run_shell lança em exit != 0. Quem seguisse o texto escreveria script que quebra, com confiança — foi exatamente o que aconteceu com os papéis do Maestri, que carregavam um bloco pré-#78.

O que entra

seção o que muda
run_shell LANÇA seção nova, com run_shell_full como saída de emergência e o caso do exit code booleano (test -f, grep -q) que agora aborta
read_files #63, com a nota de que só paraleliza acima de ~400 arquivos
read_file(p, #{lines}) #61
GLOB seção nova: relativo, absoluto, diretório literal inexistente é erro (#72), nada-casou continua []
LIMITES --max-context (#62), --strict, e a correção de que suíte de teste dentro do script funciona — o que sobe é o --timeout global
BIBLIOTECA a distinção entre os dois .codemode: ~/.codemode nasce sozinho na 1ª execução; <repo>/.codemode nunca — só codemode save cria

O teste que impede isso de envelhecer de novo

Um teste afirma que a folha menciona os oito pontos que mudam o comportamento de um script. Se alguém mudar o contrato e esquecer a folha, a suíte quebra — que é o que não aconteceu no #78.

Verificação

Testes 189 → 190.

🤖 Generated with Claude Code

https://claude.ai/code/session_01WWZKya94JfUtFcghwMzfjw

#61, #62, #63, #72)

`codemode idioms` mora no binario de proposito: CLAUDE.md, AGENTS.md e skills
nao sao herdados por subagente nem lidos por Codex/Grok, mas o binario esta no
PATH de todo mundo. E o unico canal que alcanca QUALQUER modelo.

E por isso e o que mais custa quando esta desatualizado. Ate agora a folha nao
dizia que `run_shell` LANCA em exit != 0 -- quem seguisse o texto escreveria
script que quebra, com confianca. Foi exatamente o que aconteceu com os papeis
do Maestri, que carregavam um bloco pre-#78.

O que entra:

  run_shell LANCA           secao propria, com a saida de emergencia
                            (run_shell_full) e o caso do exit code booleano
                            (`test -f`, `grep -q`) que agora aborta
  read_files                #63, com a nota de que so paraleliza acima de ~400
  read_file(p, #{lines})    #61
  GLOB                      secao nova: relativo, absoluto, diretorio literal
                            inexistente e ERRO (#72), e nada-casou continua []
  LIMITES                   --max-context (#62), --strict, e a correcao de que
                            suite de teste DENTRO do script funciona -- o que
                            sobe e o --timeout global, nao o --cmd-timeout
  BIBLIOTECA                a distincao entre os DOIS .codemode: ~/.codemode e
                            criado sozinho na 1a execucao; <repo>/.codemode
                            NUNCA e -- so `codemode save` cria

Um teste passa a travar isso: se a folha deixar de mencionar qualquer um dos
oito pontos que mudam o comportamento de um script, a suite quebra.

Testes 189 -> 190.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WWZKya94JfUtFcghwMzfjw
@SouzaRodrigo61
SouzaRodrigo61 merged commit 7824793 into main Aug 21, 2026
2 checks passed
@SouzaRodrigo61
SouzaRodrigo61 deleted the idioms-atualiza branch August 21, 2026 00:46
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