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
AGENTS.inicial.md
README.md
pesquisador.md
revisor-pr.md
README.md
ADR.md
AGENTS.projeto.md
DESIGN.md
PRODUTO.md
README-sistema.md
README.md
RN.md
STACK.md
arc42.md
c4-conteineres.md
c4-contexto.md
checklist-producao.md
runbook-deploy.md
runbook-voltar-versao.md
README-publico.md
README.md
api.md
arquitetura.md
codigo.md
dados.md
documentacao.md
frontend.md
observabilidade.md
seguranca.md
testes.md
01-visao.md
02-fundacao.md
03-planejamento.md
04-paineis.md
05-sprint.md
06-execucao.md
07-branches-e-commits.md
08-revisao.md
09-entrega.md
10-bugs-e-hotfix.md
11-seguranca-operacional.md
12-tecnologia-nova.md
13-varias-ias.md
14-automacoes.md
15-atualizacao-do-framework.md
16-conversas.md
17-flash.md
README.md
18-documentacao.md
README.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
SKILL.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
SECURITY.md
README.md
bb-pesquisador.md
bb-revisor-pr.md
README.md
README.md
README.md
README.md
README.md
pull_request_template.md
AGENTS.md
CLAUDE.md
SKILL.md
Cenários e rastreabilidade
.bigbang/tests/test_skills.py:test_catalogo_e_formato_agent_skills.bigbang/tests/test_skills.py:test_skills_descobertas_antes_do_init_sem_esteira.bigbang/tests/test_skills.py:test_edicao_de_uma_copia_reprova_e_gerador_repara.bigbang/tests/test_skills.py:test_skill_do_projeto_e_preservada
Requisitos · Matriz de rastreabilidade · Referência CLI
Fontes rastreadas
.bigbang/AGENTS.base.md.bigbang/AGENTS.inicial.md.bigbang/agents/README.md.bigbang/agents/pesquisador.md.bigbang/agents/revisor-pr.md.bigbang/hooks/README.md.bigbang/modelos/ADR.md.bigbang/modelos/AGENTS.projeto.md.bigbang/modelos/DESIGN.md.bigbang/modelos/PRODUTO.md.bigbang/modelos/README-sistema.md.bigbang/modelos/README.md.bigbang/modelos/RN.md.bigbang/modelos/STACK.md.bigbang/modelos/arc42.md.bigbang/modelos/c4-conteineres.md.bigbang/modelos/c4-contexto.md.bigbang/modelos/checklist-producao.md.bigbang/modelos/runbook-deploy.md.bigbang/modelos/runbook-voltar-versao.md.bigbang/modelos/README-publico.md.bigbang/padroes/README.md.bigbang/padroes/api.md.bigbang/padroes/arquitetura.md.bigbang/padroes/codigo.md.bigbang/padroes/dados.md.bigbang/padroes/documentacao.md.bigbang/padroes/frontend.md.bigbang/padroes/observabilidade.md.bigbang/padroes/seguranca.md.bigbang/padroes/testes.md.bigbang/processo/01-visao.md.bigbang/processo/02-fundacao.md.bigbang/processo/03-planejamento.md.bigbang/processo/04-paineis.md.bigbang/processo/05-sprint.md.bigbang/processo/06-execucao.md.bigbang/processo/07-branches-e-commits.md.bigbang/processo/08-revisao.md.bigbang/processo/09-entrega.md.bigbang/processo/10-bugs-e-hotfix.md.bigbang/processo/11-seguranca-operacional.md.bigbang/processo/12-tecnologia-nova.md.bigbang/processo/13-varias-ias.md.bigbang/processo/14-automacoes.md.bigbang/processo/15-atualizacao-do-framework.md.bigbang/processo/16-conversas.md.bigbang/processo/17-flash.md.bigbang/processo/README.md.bigbang/processo/18-documentacao.md.bigbang/skills/README.md.bigbang/skills/bb-atualizar/SKILL.md.bigbang/skills/bb-auditar-seguranca/SKILL.md.bigbang/skills/bb-codar-tarefa/SKILL.md.bigbang/skills/bb-corrigir-bug/SKILL.md.bigbang/skills/bb-design-kit/SKILL.md.bigbang/skills/bb-documentar-epico/SKILL.md.bigbang/skills/bb-entregar-epico/SKILL.md.bigbang/skills/bb-entrevista-produto/SKILL.md.bigbang/skills/bb-escolher-stack/SKILL.md.bigbang/skills/bb-escrever-testes-aceite/SKILL.md.bigbang/skills/bb-gerar/SKILL.md.bigbang/skills/bb-iniciar-projeto/SKILL.md.bigbang/skills/bb-montar-github/SKILL.md.bigbang/skills/bb-nova-tecnologia/SKILL.md.bigbang/skills/bb-prototipar/SKILL.md.bigbang/skills/bb-refinar-backlog/SKILL.md.bigbang/skills/bb-retrospectiva/SKILL.md.bigbang/skills/bb-rodar-sprint/SKILL.md.bigbang/skills/bb-status/SKILL.md.bigbang/skills/bb-triar-issue/SKILL.md.bigbang/modelos/comunidade/CODE_OF_CONDUCT.md.bigbang/modelos/comunidade/CONTRIBUTING.md.bigbang/modelos/comunidade/SECURITY.md.bigbang/esteira/nucleo/README.md.bigbang/esteira/sempre/arquivos/.claude/agents/bb-pesquisador.md.bigbang/esteira/sempre/arquivos/.claude/agents/bb-revisor-pr.md.bigbang/esteira/perfis/compilado/README.md.bigbang/esteira/perfis/deploy/README.md.bigbang/esteira/perfis/deploy/alvos/aws/README.md.bigbang/esteira/perfis/deploy/alvos/paas/README.md.bigbang/esteira/perfis/deploy/alvos/vps-docker/README.md.bigbang/esteira/nucleo/arquivos/.github/pull_request_template.mdAGENTS.mdCLAUDE.md.bigbang/skills/bb-migrate/SKILL.md
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.