ADR 0021 documentacao publica wiki - BrunodosSantosVaz/big-bang GitHub Wiki

ADR-0021: Wiki pública, comunidade e contrato documental

Situação: decisão solicitada pelo dono, implementação em revisão na issue #208. Data: 09/10/2026. Decisores: Bruno dos Santos Vaz, por instruções explícitas nesta conversa.

Contexto e problema

Documentação pública espalhada em raiz e docs duplica o destino, prejudica navegação e deixa consumidores da esteira presos ao caminho físico. Repo público não garante Project público; Discussions e preview precisam ser parte do padrão.

Fatores de decisão

Fonte oficial única, comportamento privado preservado, rastreabilidade real, revisão independente, histórico separado sem perda concorrente e manutenção do modo Flash seguro.

Opções consideradas

Manter arquivos locais; sincronizar cópias; ou adotar Wiki como fonte oficial pública e aliases lógicos no código. Cópias sincronizadas continuam sujeitas a divergência e foram descartadas pelo requisito do dono.

Decisão e justificativa

Públicos usam Wiki por SHA; privados conservam arquivos locais. Manifesto funcional registra requisitos, módulos, testes, hashes e revisão de código/Wiki. Gate falha antes de entregar cobertura incompleta ou publicação divergente. Comandos são contratos revisados, não prosa remota. Primeira postagem da IA é idempotente; painéis têm leitura pública auditada e ACL de escrita preservada.

Revisão e falso positivo do scanner

A revisão independente identificou e exigiu correção de autenticação de leitura na CI, renovação da base entre revisões e auditoria integral de metadados de painéis. Tipos de campos/valores sem suporte e conexões incompletas bloqueiam publicação em vez de serem omitidos do recibo.

Hashes documentais usam sha256:<digest>. Gitleaks confundiu o digest público do padrão api.md com uma chave no commit histórico cded74f; a igualdade com SHA-256 do arquivo foi confirmada. .gitleaksignore contém somente aquele fingerprint de commit/arquivo/regra/linha, sem ignorar manifesto inteiro nem regra. O scanner original permanece ativo e uma credencial sintética de controle foi detectada; nenhum segredo real foi liberado.

Consequências

Versão maior 2.0.0 requer migração explícita em públicos. Wiki/Home/acesso são pré-condições; originais permanecem até publicação confirmada. Upload de Social preview usa a interface oficial quando disponível e pendência deve ser declarada. Reexecutar proposta preserva história, sem force ou sobrescrita concorrente.

Referências

Issue #208, processo documental, matriz.

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