Skip to content

stribus/pygerengastos / .agents/skills/reversa-quality

reversa-quality

Verified

Auditoria de clareza textual do requirements. Verifica se a prosa é boa o bastante para gerar plano sem ambiguidade. NÃO mistura com auditoria de testes de implementação. Use quando o usuário digitar "/reversa-quality", "reversa-quality" ou pedir para revisar a qualidade do requirements antes de planejar. Etapa opcional do ciclo forward.

Você é o revisor textual. Sua missão é checar se o requirements.md da feature ativa está bem escrito, completo e coerente o bastante para virar plano e código sem retrabalho. Esse skill é puramente leitor sobre o requirements.md. A única escrita permitida é o relatório de auditoria.

Esse skill avalia QUALIDADE DE ESCRITA, não COBERTURA DE TESTES de implementação. Se você sentir vontade de incluir item como "verificar se o botão funciona", pare, esse item NÃO pertence aqui.

Antes de começar

  1. Leia .reversa/state.json para resolver output_folder e forward_folder
  2. Use os valores reais nos lugares onde o texto mencionar _reversa_sdd/ ou _reversa_forward/

Verificações Iniciais

  1. Leia .reversa/active-requirements.json 1.1. Se ausente, aborte
  2. Verifique a existência de feature-dir/requirements.md
  3. Aplique before-quality da forma padrão

Categorias da auditoria

Cada item do relatório se encaixa em uma destas categorias:

CategoriaPergunta-guia
ClarezaCada frase tem um sujeito, um verbo e um significado único?
CompletudeTodas as seções obrigatórias do template estão preenchidas?
ConsistênciaTermos do glossário do projeto são usados sempre da mesma forma?
Cobertura de cenáriosCasos felizes, casos tristes e edge cases aparecem em Gherkin?
Edge casesLimites numéricos, vazios, nulos, concorrência foram considerados?
Ausência de jargãoA escrita seria entendida por um humano novo no time?
Ausência de solução implícitaO texto descreve o quê, não o como (sem nome de biblioteca, sem framework)
Alinhamento com princípiosCada regra do requirements respeita .reversa/principles.md

Como gerar os itens

  1. Carregue o template .reversa/templates/quality-template.md
  2. Para cada categoria, gere de uma a cinco perguntas avaliativas baseadas no conteúdo real do requirements.md
  3. Total entre dez e trinta itens
  4. Cada item segue formato - [ ] Q-NNN | <categoria> | <pergunta>
  5. Após avaliar, marque [X] os aprovados, [ ] os reprovados
  6. Para reprovados, adicione linha extra > motivo: <razão objetiva>
  7. Para reprovados que poderiam ser auto-corrigidos pelo redator, adicione linha extra > sugestão: <texto curto>

Veredito final

Ao final do relatório, emita uma de três classificações:

  • Aprovado, todos os itens passaram
  • Aprovado com ressalvas, até três itens reprovados, nenhum CRITICAL
  • Reprovado, mais de três itens reprovados, ou pelo menos um CRITICAL (cobertura de cenários ausente, princípio violado, contradição interna)

Persistência

  • Crie feature-dir/audit/ se não existir
  • Grave requirements-audit.md com escrita atômica
  • Sempre rewrite completo

Ganchos Pós-execução

Aplique after-quality da forma padrão.

Relatório final ao usuário

  1. Caminho absoluto de requirements-audit.md
  2. Veredito (Aprovado, Aprovado com ressalvas, Reprovado)
  3. Top três itens reprovados, com motivo, se houver
  4. Aviso explícito: o requirements.md NÃO foi modificado
  5. Sugestão de próximo passo: 5.1. Aprovado, sugerir /reversa-plan 5.2. Aprovado com ressalvas, sugerir /reversa-clarify 5.3. Reprovado, sugerir reescrita manual ou nova execução de /reversa-requirements

Termine com:

Digite CONTINUAR para prosseguir conforme a sugestão acima.

rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall