[META-AUDIT] Revisar todas as issues — objetivos, fluxo de testes e critérios de aceite

[wesleysimplicio]

Objetivo do projeto

Este repositório é o componente simplicio do ecossistema Simplicio. Papel auditado: umbrella/integrator.

Definir o objetivo do ecossistema, fronteiras entre pacotes, contratos de integração e critérios de release conjunto.

Escopo da auditoria

Revisar todas as issues, da mais antiga à mais recente, incluindo abertas, fechadas, duplicadas, obsoletas e bloqueadas. Nenhuma issue deve ser considerada concluída apenas por descrição textual: a solução precisa de implementação, teste e evidência.

Passo a passo

1. Inventariar todas as issues e registrar número, estado, data, labels, referências e dependências.
2. Ordenar por criação e agrupar por épico, componente, risco e prioridade.
3. Para cada issue, reescrever o contexto, objetivo, fora de escopo, entradas, saídas e contrato afetado.
4. Relacionar a issue às branches, commits, PRs, arquivos, testes e outros projetos envolvidos.
5. Descrever o fluxo operacional completo, inclusive pré-condições, caminho feliz, falhas, retries, cancelamento e rollback.
6. Separar comportamento obrigatório, otimização opcional e hipótese ainda não comprovada.
7. Definir testes unitários, integração, sistema/E2E, regressão, concorrência, desempenho, segurança e reprodução aplicáveis.
8. Criar critérios de aceite mensuráveis, sem termos vagos como “funcionar” ou “melhorar”.
9. Registrar artefatos esperados: PR/commit, logs, receipts, métricas, hashes, relatório de falhas e decisão.
10. Validar dependências cruzadas com os contratos atuais da main; abrir issue vinculada quando houver quebra.
11. Manter issues de código, documentação, benchmark e investigação separadas.
12. Fechar apenas após revisão dos critérios, evidências anexadas e riscos residuais documentados.

Fluxo de testes específico

Verificar instalação limpa, descoberta dos pacotes, compatibilidade de versões, fluxo mínimo Agent→Runtime→Loop/Mapper e rollback de uma integração quebrada.

Padrão obrigatório para cada issue revisada

Cada issue deverá conter:

1. Contexto e problema
2. Objetivo
3. Fora de escopo
4. Entradas, saídas e contratos
5. Dependências e ordem
6. Passo a passo implementável
7. Fluxo de testes
8. Critérios de aceite verificáveis
9. Evidências obrigatórias
10. Riscos, rollback e decisão de encerramento

Critérios de aceite desta auditoria

• 100% das issues acessíveis foram inventariadas da mais antiga à mais recente.
• 100% das issues têm objetivo e fora de escopo explícitos.
• 100% têm passos numerados e dependências.
• 100% têm fluxo de testes aplicável ao componente.
• 100% têm critérios de aceite objetivos e verificáveis.
• 100% exigem PR/commit, logs e evidências para fechamento.
• Nenhuma issue declara economia, cobertura, desempenho ou integração sem medição.
• Falhas, timeouts, entradas inválidas e rollback são testados.
• Segredos, PII e dados privados não aparecem em exemplos ou logs.
• A revisão é reproduzível localmente ou em container e não depende de GitHub Actions pago.
• Quebras entre projetos estão ligadas por referências cruzadas.
• O README/ADR do projeto descreve sua responsabilidade e seus limites.

Evidências obrigatórias

• relatório de inventário com contagens por estado;
• diff das issues reescritas;
• PRs/commits associados;
• logs de testes e falhas injetadas;
• receipts e métricas;
• matriz de dependências;
• decisão de encerramento ou bloqueio para cada item.

Regra de encerramento

Só fechar esta auditoria quando todos os critérios estiverem marcados e o relatório final estiver publicado no repositório. Issues sem implementação permanecerão abertas como SPEC, BLOCKED ou NEEDS-IMPLEMENTATION, nunca como concluídas.

Épico do ecossistema: vincular ao projeto Simplicio central e às issues de integração correspondentes.