Funcionalidade esteira v3 - BrunodosSantosVaz/big-bang GitHub Wiki

Esteira v3 gerada

Funcionalidade BB-F-053 · requisito RF-BB-053 · versão documentada 3.0.0 · código 433c238ccc2de0c5cb9196965e98ec228a7f9e64.

Finalidade

Entregar aos projetos no fluxo agrupador a camada gerada da v3 (ADR-0022/0023/0026), mantendo a esteira legada intacta para os demais: CI com o check único gate, controlador do quadro, botões de sprint, branches, merge, release, publicação, manutenção, reprovação e faxina, formulários com labels em inglês e as instruções da v3 no AGENTS.md.

Atores

O gerador (bb generate), a CI do projeto, o controlador e os botões disparados pelo dono ou pelas IAs.

Pré-condições

bigbang.toml com workflow.model = grouping; segredo PROJECT_TOKEN e variável PROJECT_OWNER para os workflows que escrevem no quadro.

Fluxo principal

O gerador compõe esteira/sempre, pipeline/core e pipeline/profiles/; o CI roda check, rules e security e o job gate interpreta os resultados (pulado só quando não se aplica); os botões chamam os comandos bb da v3; o AGENTS.md recebe o bloco de pipeline/AGENTS.base.md. No botão Cut release, a identidade do bot é configurada no branch de release antes dos comandos que gravam a versão e o changelog.

Validações

Os workflows seguem as regras de todos os gerados (actions por SHA, permissões mínimas, runner fixo, simulação por padrão nos botões); scripts com token vêm da branch de destino nos eventos de PR; o conteúdo do PR é lido como dado.

Alternativas e erros

Projeto sem workflow.model = grouping continua com a esteira legada; trocar de modelo é a migração por partes do ADR-0024.

Permissões

Somente o job gate é o check obrigatório; publicação e voltar versão exigem a aprovação do ambiente production; o token do projeto fica nos workflows, nunca no código.

Resultados

Projetos v3 com esteira coerente com o quadro único, o modelo agrupador e as feature flags, verificada pelo bb verify.

Referência da implementação

Os símbolos abaixo compõem o inventário real do módulo, incluindo auxiliares internos; não representam APIs públicas independentes.

AGENTS.base.md

Implementação revisada.

dependabot.yml.tmpl

Implementação revisada.

bb-bug.yml

Implementação revisada.

bb-docs.yml

Implementação revisada.

bb-epic.yml

Implementação revisada.

bb-foundation.yml

Implementação revisada.

bb-task.yml

Implementação revisada.

bb-test.yml

Implementação revisada.

config.yml

Implementação revisada.

pull_request_template.md

Implementação revisada.

bb-board-report.yml

Implementação revisada.

bb-ci.yml

Implementação revisada.

bb-cleanup.yml

Implementação revisada.

bb-codeql.yml

Implementação revisada.

bb-controller.yml

Implementação revisada.

bb-create-branches.yml

Implementação revisada.

bb-cut-release.yml

Implementação revisada.

bb-merge-pr.yml

Implementação revisada.

bb-publish-maintenance.yml

Implementação revisada.

bb-publish.yml.tmpl

Implementação revisada.

bb-qa-reject.yml

Implementação revisada.

bb-start-sprint.yml

Implementação revisada.

bb-candidate.yml.tmpl

Implementação revisada.

bb-candidate.yml.tmpl

Implementação revisada.

bb-rollback.yml.tmpl

Implementação revisada.

Cenários e rastreabilidade

Requisitos · Matriz de rastreabilidade · Referência CLI

Fontes rastreadas

⚠️ **GitHub.com Fallback** ⚠️