Skip to content

metodo: portao e template de PR no repo, protecao da main e os dois contadores - #5

Merged
ronifabio merged 1 commit into
mainfrom
metodo-ajustes-portao
Sep 1, 2026
Merged

ronifabio merged 1 commit into
mainfrom
metodo-ajustes-portao

Conversation

@ronifabio

Copy link
Copy Markdown
Contributor

O que este PR faz e por quê

Três ajustes que compartilham a mesma ideia: o que precisa ser garantido não pode depender de o agente lembrar de gerar na hora certa.

O .github/ passa a vir pronto no template. O setup.md mandava o agente copiar o template de PR e o portao-de-entendimento.yml "do Apêndice B do guia" — e o guia tem 67 KB. Isso obrigava o agente a abrir um arquivo enorme no meio da geração de arquivos, exatamente no momento em que a janela de contexto está mais disputada, para copiar YAML lido de dentro de prosa. É assim que um Portão nasce parafraseado e sem efeito. Os dois arquivos são idênticos para toda a turma, então nascem versionados aqui e o setup só confere que existem. De brinde, some o caso especial que o próprio setup.md precisava explicar: como o template de PR agora está na main desde o primeiro commit, ele já carrega no primeiro Pull Request do aluno, e ninguém precisa colar o modelo à mão.

Entra também um .gitattributes com * text=auto eol=lf, que o setup.md manda o aluno criar mas que faltava no próprio repositório do template — o resultado era o diff de qualquer PR virar ruído ao trocar de máquina entre Windows e Linux.

A main ganha mecanismo. Das regras da constituição, "a main é sagrada" era a única que existia apenas como frase: revisor sem escrita, spec com status commitado pelo aluno e rodada contada por arquivo já tinham trava, ela não. O Passo 4 do setup agora propõe ligar branch protection via API, com required_approving_review_count: 0 (exige PR sem exigir aprovação de terceiro, o que serve igual para quem faz sozinho e para dupla) e enforce_admins: true, porque sem isso o dono do repositório é justamente quem fura a regra sem perceber. Proteção de branch não é herdada de repositório template, então cada aluno precisa ligar a dele — daí o passo existir.

As duas rodadas passam a ter nome. A constituição contava tentativas de fazer o teste passar; o ciclo-tarefa contava passadas de revisão. Dois contadores aninhados, ambos chamados "2 rodadas", o que fazia a regra parecer um limite total de duas tentativas. Agora são rodada de TDD (dentro do implementador) e rodada de revisão (no fluxo), nomeadas em todos os arquivos, e a mensagem de escalonamento diz qual dos dois estourou.

Apontamentos da revisão

Não se aplica: PR de método, sem spec e sem ciclo de tarefa.

…ontadores

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@ronifabio
ronifabio merged commit 0ae9f61 into main Sep 1, 2026
1 check passed
@ronifabio
ronifabio deleted the metodo-ajustes-portao branch September 3, 2026 21:58
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