Funcionalidade generator - BrunodosSantosVaz/big-bang GitHub Wiki

Geração por composição

Funcionalidade BB-F-013 · requisito RF-BB-013 · versão documentada 3.0.1 · código 371a61ae5c993f6ba3fde76e77f91e64f0bf9c42.

Finalidade

Gerar instruções e Actions a partir da configuração, preservando a camada do projeto e removendo saídas obsoletas.

Atores

Pessoa responsável pelo projeto, IA com posse confirmada e automações explicitamente autorizadas.

Pré-condições

Repositório e raiz corretos, versão instalada e configuração compatível. Para operações de escrita, exige-se autorização vigente, branch adequada e acesso ao recurso envolvido; consultas não conferem permissão adicional.

Fluxo principal

Compor sempre, núcleo, perfil e alvo; calcular campos derivados; planejar diffs; escrever somente o plano autorizado. Com workflow.model = grouping, o gerador usa a árvore da v3 (pipeline/core e pipeline/profiles/<perfil>, ver BB-F-053) no lugar da esteira legada e o bloco de pipeline/AGENTS.base.md no AGENTS.md.

Validações

Arquivos gerados recebem aviso; público não recria STACK.md local; adaptações permanentes vêm de bigbang.toml e dos contratos instalados.

Alternativas e erros

Marcador desconhecido, alvo incompatível ou configuração inválida bloqueia o plano; simulação mostra o diff sem escrever.

Permissões

Leitura usa permissões mínimas do repositório. Operações locais respeitam a posse e worktree; escrita no GitHub exige acesso explícito. Esta funcionalidade não concede novas permissões a visitantes nem substitui decisões exigidas pelo fluxo.

Resultados

Resultado esperado: Gerar instruções e Actions a partir da configuração, preservando a camada do projeto e removendo saídas obsoletas. O retorno e os arquivos afetados são conferidos pelos cenários rastreados abaixo; falha impede considerar a operação concluída.

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.

generator.py

Implementação revisada.

Símbolo Linha
Plan 35
pipeline_installed 49
initial_context 57
dependabot_entries 65
with_computed 82
build_plan 198
framework_plan 226
is_v3_pipeline 277
_layers 282
_walk 298
_add_tree 306
_add_skills 318
agents_block 339
_add_agents_md 347
stack_block 362
_add_stack_md 376
_generated_candidates 390
_text_has_notice 419
changes 426
diff 439
apply 446
_remove_empty_parents 458
__init__ 38
add 44

Cenários e rastreabilidade

Requisitos · Matriz de rastreabilidade · Referência CLI

Fontes rastreadas

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