feat(docs) : Documentação de como criar mapa com IA. - #373
Conversation
|
@usantos is attempting to deploy a commit to the rubenmarcus' projects Team on Vercel. A member of the Team first needs to authorize it. |
|
🤖 cs-brasil-ai-bot: candidato a preview; um mantenedor deve revisar o SHA e aplicar o label |
csbrasil-bot classificationNote @usantos abriu 5 arquivo(s) · +219 −5, base main. O que mudou
Labels
|
usantos
changed the title
|
Esbirro · plantão da produção · 🕵️ check vermelho parado neste PRCaution Não sei classificar este vermelho. Segue o que o CI cuspiu — palpite de bot sobre bug alheio só atrapalha.
Vermelho: Rabo do log: — de plantão: vi, registrei, hora no relógio 🕵️ |
estraga-codigo
left a comment
estraga-codigo
left a comment
There was a problem hiding this comment.
Palhaço Mal · revisor da casa · 🤡
mapa da mudança
- docs (3):
INDICE.md,colaborar.md,criar-mapa-com-ia.md - outros (1):
sidebars.js
Note
o que faz: Adiciona guia para criar mapas com IA, com ficha de design, prompt reutilizável, fluxo de validação e definition of done. Atualiza índice, sidebar e página de colaboração para referenciar o novo material.
1 grave · 2 leves
Tip
Risco BAIXO · nota 9/10 ▓▓▓▓▓▓▓▓▓░
1 achado(s) grave(s) — resolve antes do merge.
Revisão de bot — fio não resolvido TRAVA o merge (a main exige conversa resolvida). Resolve ou refuta.
🔴 graves (1)
- Régua específica sem mandar rodar mutantes —
docs/docs/criar-mapa-com-ia.md:109(ação: leis-da-casa)
O guia fala em criar mutantes que provam que a régua morde, mas não inclui um comando como node tools/eval/-check.mjs --mutante= no checklist de validação. Um agente pode criar a régua e achar que cumpriu sem ter testado a mutação.
💡 conserto: Acrescente no checklist do passo 6: 'Rode cada mutante e confirme reprova antes de registrar o mapa.'mutação sugerida:
Criar a régua mas não rodar os mutantes - o guia permite que isso passe sem vermelha
🟡 leves (2)
- Prompt presume scripts que podem mudar —
docs/docs/criar-mapa-com-ia.md:50(ação: leis-da-casa)
O prompt reutilizável cita scripts específicos como node tools/eval/map-contrato-check.mjs e npm run eval:mapid. Se esses scripts mudam de nome ou são removidos, o prompt fica desatualizado para humanos e agentes que o copiam.
💡 conserto: Deixe o prompt apontar para seções de documentação que listam os comandos atuais (ex. 'Veja tools/eval/README.md para os comandos de validação'), em vez de encaixar nomes de script hardcoded.mutação sugerida:
Renomear map-contrato-check.mjs para outro nome e observar que o prompt ainda cita o antigo - Renumeração manual de tabela —
docs/INDICE.md:29(ação: leis-da-casa)
A tabela foi renumerada na mão na seção 3 (10→11, 11→12, 12→13). Se alguém adicionar outra entrada no futuro, tem que lembrar de propagar o número. O projeto tem histórico de esse tipo de número à mão desatualizar.
💡 conserto: Rode npm run docs para gerar o número automaticamente, ou aceite que esta tabela de navegação não precisa ser numerada sequencialmente.
impacto cruzado
- páginas públicas que leem src/data/jogo.ts
- map-check.mjs e scripts que varrem public/js/maps.js
(grafo local de public/js, uma rodada atrás do head do PR.)
Resolve ou refuta nos fios — refutado com razão, eu caio fora.
— maquiagem de verde por cima de vermelho eu desenmascaro no primeiro golpe de vista 🤡
| ``` | ||
|
|
||
| Campos como `groundHeightAt`, `slowAt`, `pickups`, `ctfPoints`, `sun` e `hemi` entram | ||
| conforme o mapa precisa. Antes de registrá-lo, confira o contrato: |
There was a problem hiding this comment.
[grave] Régua específica sem mandar rodar mutantes
O guia fala em criar mutantes que provam que a régua morde, mas não inclui um comando como node tools/eval/-check.mjs --mutante= no checklist de validação. Um agente pode criar a régua e achar que cumpriu sem ter testado a mutação.
Tip
conserto: Acrescente no checklist do passo 6: 'Rode cada mutante e confirme reprova antes de registrar o mapa.'
mutação:
Criar a régua mas não rodar os mutantes - o guia permite que isso passe sem vermelha
|
|
||
| Crie o mapa [nome], id [id], com tema [tema]. Ele deve abrir em [rounds/CTF], ter limites | ||
| aproximados de [x × z], três rotas jogáveis ([descreva]) e estes marcos visuais: [lista]. | ||
| Spawns: [descrição]. Coberturas e obstáculos: [lista]. Arsenal: [distribuição]. |
There was a problem hiding this comment.
[leve] Prompt presume scripts que podem mudar
O prompt reutilizável cita scripts específicos como node tools/eval/map-contrato-check.mjs e npm run eval:mapid. Se esses scripts mudam de nome ou são removidos, o prompt fica desatualizado para humanos e agentes que o copiam.
Tip
conserto: Deixe o prompt apontar para seções de documentação que listam os comandos atuais (ex. 'Veja tools/eval/README.md para os comandos de validação'), em vez de encaixar nomes de script hardcoded.
mutação:
Renomear map-contrato-check.mjs para outro nome e observar que o prompt ainda cita o antigo
| | 7 | [`../tools/eval/BAR-CONSISTENCIA.md`](../tools/eval/BAR-CONSISTENCIA.md) | A régua vigente: 25 critérios de consistência e flow. **Tem precedência** sobre a `BAR.md`. | | ||
| | 8 | [`../tools/eval/BAR.md`](../tools/eval/BAR.md) | A régua de fidelidade visual. Consulta, não leitura obrigatória. | | ||
| | 9 | [`../tools/eval/README.md`](../tools/eval/README.md) | Catálogo do arnês: o que cada script mede, e quais estão obsoletos. | | ||
| | 10 | [`docs/criar-mapa-com-ia.md`](docs/criar-mapa-com-ia.md) | Fluxo completo para especificar, implementar, integrar e validar mapas com assistência de IA. | |
There was a problem hiding this comment.
[leve] Renumeração manual de tabela
A tabela foi renumerada na mão na seção 3 (10→11, 11→12, 12→13). Se alguém adicionar outra entrada no futuro, tem que lembrar de propagar o número. O projeto tem histórico de esse tipo de número à mão desatualizar.
Tip
conserto: Rode npm run docs para gerar o número automaticamente, ou aceite que esta tabela de navegação não precisa ser numerada sequencialmente.
Agent: csbrasil-bot (autofix) Signed-off-by: csbrasil-bot <csbrasil-bot@users.noreply.github.com>
Rodado pelo autofix: só arquivo gerado, conferido pela lista de permissão. Signed-off-by: csbrasil-bot <csbrasil-bot@users.noreply.github.com>
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
Agent: csbrasil-bot (autofix) Signed-off-by: csbrasil-bot <csbrasil-bot@users.noreply.github.com>
Rodado pelo autofix: só arquivo gerado, conferido pela lista de permissão. Signed-off-by: csbrasil-bot <csbrasil-bot@users.noreply.github.com>
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
Agent: csbrasil-bot (autofix) Signed-off-by: csbrasil-bot <csbrasil-bot@users.noreply.github.com>
Rodado pelo autofix: só arquivo gerado, conferido pela lista de permissão. Signed-off-by: csbrasil-bot <csbrasil-bot@users.noreply.github.com>
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
1 similar comment
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
|
Esbirro · plantão da produção · 🕵️ check vermelho parado neste PRCaution Não sei classificar este vermelho. Segue o que o CI cuspiu — palpite de bot sobre bug alheio só atrapalha.
Vermelho: Rabo do log: — nada fora do normal no meu turno 🕵️ |
estraga-codigo
left a comment
estraga-codigo
left a comment
There was a problem hiding this comment.
Palhaço Mal · revisor da casa · 🤡
mapa da mudança
- docs (4):
INDICE.md,colaborar.md,criar-mapa-com-ia.md,colaborar.md - outros (1):
sidebars.js
Tip
Risco BAIXO · nota 10/10 ▓▓▓▓▓▓▓▓▓▓
nada aqui que quebre amanhã. amanhã é outro diff
Revisão de bot — fio não resolvido TRAVA o merge (a main exige conversa resolvida). Resolve ou refuta.
— todo bug confessa no diff, eu só faço o interrogatório 🤡
Dois defeitos apareceram no PRIMEIRO disparo real da automação, e os dois eram meus: 1. O commit de regeneração do autofix não levava o trailer `Agent:`. O agente_check cobra esse trailer de TODO commit do PR, então o bot consertava a doc e reprovava o mesmo PR no passo seguinte. Atingiu #400, #405, #406, #365, #372, #373 e #375 de uma vez. 2. O job `avaliar` do preview-bot rodava `python3 scripts/ci/ensure_labels.py` sem nunca ter feito checkout - "No such file or directory". O passo era resto do desenho antigo: o preview por etiqueta morreu quando ele virou build-sem-segredo + deploy-sem-código, então a etiqueta não é mais necessária e o passo saiu. A AF7 guarda o primeiro: todo `git commit` do bot tem de levar `Agent:` e `Signed-off-by:`, que são exatamente os trailers que o CI cobra de gente. Bot que não cumpre a própria régua da casa não ajuda ninguém. O mutante `commit-sem-trailer` remove o Agent e acende. Agent: Claude Opus 5 (Claude Code) Signed-off-by: rubenmarcus <rubenmarcus.dev@gmail.com> Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
Agent: csbrasil-bot (autofix) Signed-off-by: csbrasil-bot <csbrasil-bot@users.noreply.github.com>
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
|
🤖 cs-brasil-ai-bot: candidato a preview; um mantenedor deve revisar o SHA e aplicar o label |
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
|
🤖 cs-brasil-ai-bot: candidato a preview; um mantenedor deve revisar o SHA e aplicar o label |
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
Agent: csbrasil-bot (autofix) Signed-off-by: csbrasil-bot <csbrasil-bot@users.noreply.github.com>
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
|
🤖 preview no ar → https://csbrasil-k7iwhplh2-rubenmarcus-projects.vercel.app |
|
🤖 cs-brasil-ai-bot: candidato a preview; um mantenedor deve revisar o SHA e aplicar o label |
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
|
🤖 preview no ar → https://csbrasil-40yq1ljou-rubenmarcus-projects.vercel.app |
estraga-codigo
left a comment
estraga-codigo
left a comment
There was a problem hiding this comment.
Palhaço Mal · revisor da casa · 🤡
mapa da mudança
- docs (4):
INDICE.md,colaborar.md,criar-mapa-com-ia.md,colaborar.md - outros (1):
sidebars.js
Tip
Risco BAIXO · nota 10/10 ▓▓▓▓▓▓▓▓▓▓
limpo pelos critérios das minhas ações desta rodada
Revisão de bot — fio não resolvido TRAVA o merge (a main exige conversa resolvida). Resolve ou refuta.
— maquiagem de verde por cima de vermelho eu desenmascaro no primeiro golpe de vista 🤡
|
Esbirro · plantão da produção · 🕵️ check vermelho parado neste PRCaution Não sei classificar este vermelho. Segue o que o CI cuspiu — palpite de bot sobre bug alheio só atrapalha.
Vermelho: Rabo do log: — nada fora do normal no meu turno 🕵️ |
Agent: csbrasil-bot (autofix) Signed-off-by: csbrasil-bot <csbrasil-bot@users.noreply.github.com>
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
|
🤖 cs-brasil-ai-bot: candidato a preview; um mantenedor deve revisar o SHA e aplicar o label |
Agent: csbrasil-bot (autofix) Signed-off-by: csbrasil-bot <csbrasil-bot@users.noreply.github.com>
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
|
🤖 cs-brasil-ai-bot: candidato a preview; um mantenedor deve revisar o SHA e aplicar o label |
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
|
🤖 preview no ar → https://csbrasil-flb6pvxp1-rubenmarcus-projects.vercel.app |
estraga-codigo
left a comment
estraga-codigo
left a comment
There was a problem hiding this comment.
Palhaço Mal · revisor da casa · 🤡
mapa da mudança
- docs (4):
INDICE.md,colaborar.md,criar-mapa-com-ia.md,colaborar.md - outros (1):
sidebars.js
Tip
Risco BAIXO · nota 10/10 ▓▓▓▓▓▓▓▓▓▓
limpo pelos critérios das minhas ações desta rodada
Revisão de bot — fio não resolvido TRAVA o merge (a main exige conversa resolvida). Resolve ou refuta.
— maquiagem de verde por cima de vermelho eu desenmascaro no primeiro golpe de vista 🤡
|
Esbirro · plantão da produção · 🕵️ check vermelho parado neste PRCaution Não sei classificar este vermelho. Segue o que o CI cuspiu — palpite de bot sobre bug alheio só atrapalha.
Vermelho: Rabo do log: — nada fora do normal no meu turno 🕵️ |
Agent: csbrasil-bot (autofix) Signed-off-by: csbrasil-bot <csbrasil-bot@users.noreply.github.com>
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
|
🤖 cs-brasil-ai-bot: candidato a preview; um mantenedor deve revisar o SHA e aplicar o label |
Agent: csbrasil-bot (autofix) Signed-off-by: csbrasil-bot <csbrasil-bot@users.noreply.github.com>
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
|
🤖 preview no ar → https://csbrasil-en5zwtod2-rubenmarcus-projects.vercel.app |
|
🤖 cs-brasil-ai-bot: candidato a preview; um mantenedor deve revisar o SHA e aplicar o label |
|
🤖 autofix: regenerei os blocos derivados e empurrei o commit. O PR não precisa de mais nada disso. |
|
🤖 preview no ar → https://csbrasil-n98fonyw1-rubenmarcus-projects.vercel.app |
estraga-codigo
left a comment
estraga-codigo
left a comment
There was a problem hiding this comment.
Palhaço Mal · revisor da casa · 🤡
mapa da mudança
- docs (4):
INDICE.md,colaborar.md,criar-mapa-com-ia.md,colaborar.md - outros (1):
sidebars.js
Tip
Risco BAIXO · nota 10/10 ▓▓▓▓▓▓▓▓▓▓
limpo pelos critérios das minhas ações desta rodada
Revisão de bot — fio não resolvido TRAVA o merge (a main exige conversa resolvida). Resolve ou refuta.
— todo bug confessa no diff, eu só faço o interrogatório 🤡
|
Esbirro · plantão da produção · 🕵️ check vermelho parado neste PRCaution Não sei classificar este vermelho. Segue o que o CI cuspiu — palpite de bot sobre bug alheio só atrapalha.
Vermelho: Rabo do log: — de plantão: vi, registrei, hora no relógio 🕵️ |
3 participants
Summary
Issue
Risk
Validation
npm run buildnpm run check:fast— 46/46npm run docs:checkBot notes
safe-automergeneeds-stagingneeds-human-gameplayneeds-human-backend