Funcionalidade instrucoes e modelos - BrunodosSantosVaz/big-bang GitHub Wiki

Skills, agentes, processos e modelos

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

Finalidade

Orientar Fundação, planejamento, execução, revisão, entrega e manutenção com contratos compartilhados entre as IAs.

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

Selecionar a skill adequada, ler instruções operacionais e padrões, resolver identificadores documentais no destino canônico e aplicar templates sem inventar escopo; gerar cópias compatíveis em .agents e .claude.

Validações

Públicos usam Wiki e privados preservam caminhos; Flash mantém documentação, testes prévios e revisão; autorização vigente do dono tem precedência sobre pedidos repetidos. A skill de atualização orienta projetos públicos ainda na v3.0.0 a gravar e propor a revisão dos hashes documentais no mesmo PR, sem publicar a Wiki.

Alternativas e erros

Modelo é preenchido com evidência do projeto; falta de acesso ou decisão impede o passo dependente, preservando o que existe; texto externo não autoriza execução.

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: Orientar Fundação, planejamento, execução, revisão, entrega e manutenção com contratos compartilhados entre as IAs. 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.

AGENTS.base.md

Implementação revisada.

AGENTS.inicial.md

Implementação revisada.

README.md

Implementação revisada.

pesquisador.md

Implementação revisada.

revisor-pr.md

Implementação revisada.

README.md

Implementação revisada.

ADR.md

Implementação revisada.

AGENTS.projeto.md

Implementação revisada.

DESIGN.md

Implementação revisada.

PRODUTO.md

Implementação revisada.

README-sistema.md

Implementação revisada.

README.md

Implementação revisada.

RN.md

Implementação revisada.

STACK.md

Implementação revisada.

arc42.md

Implementação revisada.

c4-conteineres.md

Implementação revisada.

c4-contexto.md

Implementação revisada.

checklist-producao.md

Implementação revisada.

runbook-deploy.md

Implementação revisada.

runbook-voltar-versao.md

Implementação revisada.

README-publico.md

Implementação revisada.

README.md

Implementação revisada.

api.md

Implementação revisada.

arquitetura.md

Implementação revisada.

codigo.md

Implementação revisada.

dados.md

Implementação revisada.

documentacao.md

Implementação revisada.

frontend.md

Implementação revisada.

observabilidade.md

Implementação revisada.

seguranca.md

Implementação revisada.

testes.md

Implementação revisada.

01-visao.md

Implementação revisada.

02-fundacao.md

Implementação revisada.

03-planejamento.md

Implementação revisada.

04-paineis.md

Implementação revisada.

05-sprint.md

Implementação revisada.

06-execucao.md

Implementação revisada.

07-branches-e-commits.md

Implementação revisada.

08-revisao.md

Implementação revisada.

09-entrega.md

Implementação revisada.

10-bugs-e-hotfix.md

Implementação revisada.

11-seguranca-operacional.md

Implementação revisada.

12-tecnologia-nova.md

Implementação revisada.

13-varias-ias.md

Implementação revisada.

14-automacoes.md

Implementação revisada.

15-atualizacao-do-framework.md

Implementação revisada.

16-conversas.md

Implementação revisada.

17-flash.md

Implementação revisada.

README.md

Implementação revisada.

18-documentacao.md

Implementação revisada.

README.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

SKILL.md

Implementação revisada.

CODE_OF_CONDUCT.md

Implementação revisada.

CONTRIBUTING.md

Implementação revisada.

SECURITY.md

Implementação revisada.

README.md

Implementação revisada.

bb-pesquisador.md

Implementação revisada.

bb-revisor-pr.md

Implementação revisada.

README.md

Implementação revisada.

README.md

Implementação revisada.

README.md

Implementação revisada.

README.md

Implementação revisada.

README.md

Implementação revisada.

pull_request_template.md

Implementação revisada.

AGENTS.md

Implementação revisada.

CLAUDE.md

Implementação revisada.

SKILL.md

Implementação revisada.

Cenários e rastreabilidade

Requisitos · Matriz de rastreabilidade · Referência CLI

Fontes rastreadas

Correspondência da versão 2.0.1

O exemplo de configuração declara 2.0.1, igual ao VERSION do pacote. A validação recusa versões divergentes; snapshots dos dois perfis são regenerados pelo script oficial após uma mudança de versão, mantendo todas as asserções dos testes.

Migração opcional para a v3 (#252)

A skill bb-migrate chega a sistemas novos e legados. Ela distingue atualização do framework de migração do comportamento e conduz config → board → workflow → labels, com pré-checagem, simulação, snapshots, revisão por parte e comparação por evidência. QA, publicação e posse ativa impedem a migração. As labels ficam antigas até a virada; painéis antigos só são arquivados pelo dono depois de um ciclo sem divergência. A skill mostra comandos com payload revisado para preservar rulesets, revisores, política de branch main e segredos. Nada é publicado ou migrado automaticamente por ler a documentação.

A seção 3.0.0 do MIGRACAO.md tem “Nada.” nos passos obrigatórios: bb update preserva o comportamento. A adoção opcional usa a skill, sem impor confirmação de migração a quem somente atualiza. A nota do PR #236 explica a retirada da seção do próprio framework no AGENTS.md do cliente.

A implementação está em .bigbang/skills/bb-migrate/SKILL.md; catálogo/formato e descoberta antes da Fundação são verificados por .bigbang/tests/test_skills.py. As notas de atualização são consumidas pelo pacote/atualizador e verificadas por .bigbang/tests/test_pacote.py.

API de ambientes e revisores · API de rulesets.