Skip to content

docs(fleet): gate honesto sobre lint (§6 + cr-fleet-ops §4) - #13

Merged
caioross merged 1 commit into
mainfrom
auto/meta-gate-lint-honesto
Jul 11, 2026
Merged

docs(fleet): gate honesto sobre lint (§6 + cr-fleet-ops §4)#13
caioross merged 1 commit into
mainfrom
auto/meta-gate-lint-honesto

Conversation

@caioross

@caioross caioross commented Jul 8, 2026

Copy link
Copy Markdown
Owner

Contexto

Retro Meta da Semana 2026-W28. O gate de validação (HANDBOOK §6 e cr-fleet-ops §4) mandava rodar pnpm lint, mas:

  • o repo não tem .eslintrc (nem eslintConfig no package.json);
  • next lint sem config abre o setup interativo e falha em shell headless;
  • a CI (.github/workflows/ci.yml) roda install + typecheck + build — nunca lint.

Resultado recorrente: todo Resolvedor/PR Doctor gasta tokens redescobrindo "lint N/A" e escrevendo disclaimer no PR (ver PR #8), além de ambiguidade sobre "o gate passou de verdade?".

O que mudou e por quê

  • Núcleo do gate passa a ser pnpm typecheck && pnpm build (= exatamente o que a CI roda).
  • pnpm lint documentado como N/A até existir config ESLint: não é um passo que se possa "passar", não precisa de disclaimer, e não se deve adicionar config só para o gate. Se um dia houver .eslintrc, o lint volta a ser obrigatório.
  • A regra §8 ("nunca desabilitar teste/lint/validação") fica intacta — deixar honesto um passo que não existe não é afrouxar; desabilitar typecheck/build/scripts/teste é.

Espelha as edições já aplicadas diretamente nos prompts das rotinas coderacer-resolvedor (§6.E) e coderacer-pr-doctor (§5.C) nesta mesma retro.

Validação

Docs-only (2 arquivos .md, docs/** + .claude/skills/**) — HANDBOOK §7.3 (normal). Sem impacto em código/gate executável.

O gate mandava rodar `pnpm lint`, mas o repo não tem `.eslintrc` (nem
`eslintConfig` no package.json) e a CI roda só typecheck+build. Sem config,
`next lint` abre o setup interativo e falha em shell headless — logo o passo
nunca "passa" e todo Resolvedor/PR Doctor gastava tokens redescobrindo isso e
escrevendo o disclaimer "lint N/A" (ver PR #8).

Deixa o núcleo do gate = `typecheck && build` (exatamente a CI) e documenta que
lint só volta a ser obrigatório quando existir config ESLint. Não afrouxa nada:
a prohibição de desabilitar typecheck/build/scripts/teste (§8) fica intacta.

Espelha as edições diretas já feitas nos prompts coderacer-resolvedor e
coderacer-pr-doctor nesta retro (2026-W28).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 8, 2026

Copy link
Copy Markdown

@caioross is attempting to deploy a commit to the caioross' projects team on Vercel, but is not a member of this team. To resolve this issue, you can:

  • Make your repository public. Collaboration is free for open source and public repositories.
  • Upgrade to pro and add @caioross as a member. A Pro subscription is required to access Vercel's collaborative features.
    • If you're the owner of the team, click here to upgrade and add @caioross as a member.
    • If you're the user who initiated this build request, click here to request access.
    • If you're already a member of the caioross' projects team, make sure that your Vercel account is connected to your GitHub account.

To read more about collaboration on Vercel, click here.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request removes the 'pnpm lint' command from the validation gate instructions in both SKILL.md and HANDBOOK.md, as the repository lacks an ESLint configuration, causing headless CI builds to fail. The review feedback suggests a minor correction in HANDBOOK.md to replace the reference to 'scripts/teste' with 'scripts de validação' to accurately reflect the repository's structure.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread docs/fleet/HANDBOOK.md
Os dois scripts são baratos; na dúvida rode ambos. Vermelho sem correção honesta dentro do
escopo = PR **DRAFT** explicando o bloqueio. Nunca enfraqueça validação para "passar".
escopo = PR **DRAFT** explicando o bloqueio. Nunca enfraqueça validação para "passar" — deixar
honesto um passo que não existe (lint sem config) não é afrouxar; desabilitar typecheck/build/scripts/teste é.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

O repositório não possui um script de teste (pnpm test ou similar) configurado no package.json, mas sim scripts de validação (scripts/validate-metrics.mjs e scripts/validate-persistence.mjs). Para evitar ambiguidade ou a impressão de que existe um script ou diretório chamado scripts/teste, sugere-se alterar a menção para scripts de validação ou apenas scripts.

Suggested change
honesto um passo que não existe (lint sem config) não é afrouxar; desabilitar typecheck/build/scripts/teste é.
honesto um passo que não existe (lint sem config) não é afrouxar; desabilitar typecheck/build/scripts de validação é.

@caioross

Copy link
Copy Markdown
Owner Author

Parecer — PR Doctor ✅ MERGE

Docs-only (HANDBOOK §6 + cr-fleet-ops §4). Diff lido inteiro: torna honesto que pnpm lint é N/A (sem .eslintrc, CI roda só typecheck+build) — não afrouxa validação, pois não existe passo de lint a desabilitar; typecheck/build/scripts seguem obrigatórios. Alinha os docs à realidade já praticada pela frota (e ao que a CI de fato executa).

Classificação §7.3 (normal). CI Install, typecheck & build ✓ verde. (Check Vercel falha por acesso do autor ao time Vercel — condição ambiental pré-existente em todo PR de agente, não é a CI do repo; mergeStateStatus=UNSTABLE, não bloqueado.)

Squash-merge.

@caioross
caioross merged commit 6d48765 into main Jul 11, 2026
2 of 3 checks passed
@caioross
caioross deleted the auto/meta-gate-lint-honesto branch July 11, 2026 11:34
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