Requisitos

Requisitos e regras implementadas

Requisitos reconstruídos a partir das funcionalidades reais do código, seus testes e decisões existentes. Estes IDs organizam rastreabilidade; não inventam critérios de aceite do dono nem declaram funcionalidade planejada como concluída.

Requisitos funcionais

Requisito	Comportamento verificável	Funcionalidade
RF-BB-001	Liberar somente as marcas de pendência da tarefa e impedir alterações indevidas nos testes existentes.	BB-F-001
RF-BB-002	Verificar os onze itens de produção e os controles obrigatórios de ambiente e segurança.	BB-F-002
RF-BB-003	Detectar alterações não autorizadas na camada .bigbang e gerar o inventário de integridade do pacote.	BB-F-003
RF-BB-004	Disponibilizar os comandos bb com mensagens em português e retornos estáveis para pessoas e automações.	BB-F-004
RF-BB-005	Publicar as boas-vindas da IA sem duplicação e tornar painéis públicos somente após auditoria do conteúdo.	BB-F-005
RF-BB-006	Ler bigbang.toml sem aceitar erros de digitação que silenciem controles do projeto.	BB-F-006
RF-BB-007	Registrar a decisão autorizada do dono e impedir aprovação automática de PR que exija revisão humana.	BB-F-007
RF-BB-008	Resolver entregas por contratos instalados, distinguindo suporte implementado de integração reservada.	BB-F-008
RF-BB-009	Detectar cercas abertas, links locais inválidos e ausência da apresentação, comunidade ou ícone necessários ao sistema.	BB-F-009
RF-BB-010	Resolver identificadores documentais conforme a visibilidade e publicar somente o snapshot revisado sem perder alterações concorrentes.	BB-F-010
RF-BB-011	Preparar, ler, propor, validar e publicar documentação; orientar Discussions, auditoria de painéis e Social preview.	BB-F-011
RF-BB-012	Diferenciar sucesso, uso incorreto, configuração inválida e falhas externas para que scripts não interpretem erro como entrega.	BB-F-012
RF-BB-013	Gerar instruções e Actions a partir da configuração, preservando a camada do projeto e removendo saídas obsoletas.	BB-F-013
RF-BB-014	Executar operações GitHub por argumentos separados, permitindo substituição por gh falso nos testes.	BB-F-014
RF-BB-015	Preparar F0 com identidade, modo padrão ou Flash, configuração e arquivos comunitários sem destruir conteúdo do projeto.	BB-F-015
RF-BB-016	Evitar que duas IAs implementem a mesma tarefa usando sessões rastreáveis e timestamps do servidor.	BB-F-016
RF-BB-017	Empacotar .bigbang com integridade e notas de migração que permitem atualização oficial verificável.	BB-F-017
RF-BB-018	Localizar raiz, configuração e versão e tratar texto de forma consistente nos sistemas suportados.	BB-F-018
RF-BB-019	Calcular prontidão, branches, revisão, SemVer, changelog, matriz e nomes de artefatos sem executar deploy.	BB-F-019
RF-BB-020	Expor regras verificáveis a scripts sem duplicar lógica de negócio entre Bash e Python.	BB-F-020
RF-BB-021	Substituir marcadores conhecidos e inserir avisos de geração no formato do arquivo de destino.	BB-F-021
RF-BB-022	Impedir dependências diretas de execução que não estejam na tabela aprovada da stack.	BB-F-022
RF-BB-023	Mostrar posses e flags de leitura e sinalizar tarefas abandonadas somente pela automação específica.	BB-F-023
RF-BB-024	Concentrar execução depois do código e selecionar testes afetados com fallback conservador, mantendo autoria antes da implementação.	BB-F-024
RF-BB-025	Relacionar RNs vigentes aos testes de aceite sem perder a regra durante a migração dos arquivos locais.	BB-F-025
RF-BB-026	Instalar release do framework com SHA-256 e atestação de origem, preservando configurações e abrindo PR específico.	BB-F-026
RF-BB-027	Detectar adulteração, geração fora de sincronia e workflows que violam as regras do framework.	BB-F-027
RF-BB-028	Garantir Home, navegação, páginas, imagens e âncoras internas válidas antes de concluir documentação.	BB-F-028
RF-BB-029	Verificar permissões mínimas, versões imutáveis e restrições contra execução insegura em workflows.	BB-F-029
RF-BB-030	Criar worktree próprio somente depois de confirmar posse da tarefa e guardar recibos em metadados Git.	BB-F-030
RF-BB-031	Instalar labels, proteções, ambientes, variáveis e painéis coerentes com a configuração do projeto.	BB-F-031
RF-BB-032	Manter os cards coerentes com issues, labels, branches, PRs e CI sem transformar arrastar coluna em decisão do dono.	BB-F-032
RF-BB-033	Abrir sprint e tarefas dependentes somente quando o épico satisfaz a Definition of Ready.	BB-F-033
RF-BB-034	Aceitar PRs somente no modelo de branches com revisão correspondente e testes de regressão anteriores à correção.	BB-F-034
RF-BB-035	Executar comandos da stack e testes conforme a fase, preservando o comportamento padrão e a evidência exata do modo Flash.	BB-F-035
RF-BB-036	Manter scanners de segredos, código, dependências e banco ativos e bloquear vulnerabilidade alta ou crítica.	BB-F-036
RF-BB-037	Integrar épicos, bugs ou dependências em uma release coerente com SemVer e registrar changelog versionado.	BB-F-037
RF-BB-038	Apresentar candidata e critérios ao dono, registrar reprovação e criar uma tarefa de correção no mesmo épico.	BB-F-038
RF-BB-039	Publicar somente unidade homologada, aprovada e com documentação publicada; entregar configuração ou manutenção sem reconstruir artefato.	BB-F-039
RF-BB-040	Encerrar sprints e releases sem abandonar branches e sem apagar trabalho ainda não integrado.	BB-F-040
RF-BB-041	Compilar cada sistema uma vez e promover os mesmos bytes após homologação.	BB-F-041
RF-BB-042	Construir imagens por plataforma e entregar exatamente os digests homologados, com SBOM e scanners.	BB-F-042
RF-BB-043	Atualizar serviços publicados em servidor existente por SSH, preservando serviços não publicados e permitindo voltar.	BB-F-043
RF-BB-044	Entregar sistemas em apps existentes do Tsuru sem criar outro servidor e com imagem imutável e saúde por ambiente.	BB-F-044
RF-BB-045	Bloquear comandos e edições proibidos pelo contrato da sessão antes que alterem trabalho ou arquivos sensíveis.	BB-F-045
RF-BB-046	Orquestrar eventos de CI, sprint, kanban, revisão, entrega, posse e recuperação pelos contratos do framework.	BB-F-046
RF-BB-047	Validar a fonte e distribuir pacote oficial com origem verificável e limpeza após sincronização.	BB-F-047
RF-BB-048	Orientar Fundação, planejamento, execução, revisão, entrega e manutenção com contratos compartilhados entre as IAs.	BB-F-048
RF-BB-049	Traduzir em um único lugar todos os identificadores da v2 (português) para os da v3 (inglês), mantendo os da v2 como aliases.	BB-F-049
RF-BB-050	Decidir transições do quadro único, aprovadores por modo, risco, recibos e travas atômicas por regras puras e testadas.	BB-F-050
RF-BB-051	Manter um único Project por repositório cujo estado de cada cartão vem dos recibos da issue, movido só por transições validadas e reconciliado contra movimentos manuais.	BB-F-051
RF-BB-052	Entregar épicos agrupadores com tarefas na develop, release cortada da develop, feature flags e publicação do mesmo artefato homologado.	BB-F-052
RF-BB-053	Gerar para projetos no fluxo agrupador a esteira v3 com check único gate, controlador, botões e instruções da v3, sem misturar com a esteira legada.	BB-F-053
RF-BB-054	Aplicar nos portões da v3 o modo do projeto: normal com o dono, Flash delegando o comum e autonomous só dentro do contrato autonomy.toml, com a identidade de quem aprovou em cada recibo.	BB-F-054
RF-BB-055	Instruir as IAs no fluxo v3 com skills e processos próprios, sem mudar as skills e os processos dos projetos que ainda usam o fluxo anterior.	BB-F-055
RF-BB-056	Esteira própria v3 do framework com bootstrap confiável, pacote reprodutível e isolamento do lançador.	BB-F-056

Requisitos não funcionais e regras

• Integridade: pacote reprodutível, checksum e atestação; camada gerada verificada.
• Segurança: controles operacionais e scanners ativos, sem exposição de credenciais ou execução de prosa remota.
• Organização: branch/PR, posse confirmada, worktree próprio, revisão independente e CI do commit.
• Concorrência: Wiki publica por base/SHA e fast-forward, sem sobrescrever edição concorrente.
• Transparência: painéis públicos somente leitura; plano não é confundido com implementação.
• Privacidade: privados preservam destino e procedimentos atuais; exposição pública exige auditoria.

As garantias com IDs originais (ARQ, SEG, COD, TST, DOC, API, DAD, FE e OBS) permanecem instruções operacionais consumidas por IAs no framework. Especificação conserva critérios de Fundação e construção. Matriz fornece evidências por módulo. | RF-BB-057 | Migração opcional config → board → workflow → labels, com evidências, snapshots e rollback. | BB-F-057 | | RF-BB-058 | Criar e promover pacotes/arquivos por manifesto SHA-256 imutável, sem rebuild e sem expor segredos aos scripts do projeto. | BB-F-058 | | RF-BB-059 | Adaptador AWS S3 + CloudFront com autenticação OIDC e permissões mínimas em estágio Beta. | BB-F-059 |