tollens-ai/quality-strategy-skills

Habilidades de Estratégia de Qualidade

Habilidades para Claude Code que entrevistam você para produzir uma estratégia de qualidade de software — quem importa para o seu projeto, o que eles valorizam, onde você está exposto e o que fazer a respeito — além da estratégia de teste e da estratégia de ferramentas que a transformam em ação. Quando a maior parte do seu código é escrita por agentes que não sabem o que qualidade significa para seu projeto, uma estratégia explícita é o que os impede de enviar confiantemente na direção errada.

Baseado no framework de qualidade de Edmund Pringle: qualidade é valor para alguém que importa; teste é investigação para descobrir o que é verdade; risco é perigo para a qualidade. Para desenvolvedores solo, pequenas equipes, líderes de engenharia — e qualquer pessoa cujo código-fonte agora é manipulado por agentes. Você não precisa de um repositório: executá-lo na fase de ideação é um uso de primeira classe.

Status: alpha. Compartilhado com uma primeira onda de testadores. As habilidades funcionam e foram testadas exaustivamente contra usuários simulados, mas a experiência no mundo real é limitada. Espere arestas, conte-nos onde falha (Feedback) e leia Limitações conhecidas primeiro — não estamos escondendo as lacunas.

Instalação

Este é um plugin do Claude Code:

/plugin marketplace add tollens-ai/quality-strategy-skills
/plugin install quality-strategy@tollens

Em seguida, em qualquer projeto, comece com /quality-strategy. A saída vai para quality/strategy.md na raiz do projeto. (As habilidades também estão disponíveis com namespace, por exemplo, /quality-strategy:test-strategy, se um nome simples colidir com outro plugin.)

Novas versões são lançadas regularmente — execute claude plugin update quality-strategy para obtê-las; CHANGELOG.md informa o que mudou.

O fluxo típico

1. /quality-strategy — o evento principal. Uma entrevista estruturada produz quality/strategy.md, termina com uma auditoria embutida e aponta para as etapas seguintes.
2. /test-strategy — transforma a estratégia em um plano de investigação: o que descobrir, em qual ordem, dividido entre humanos e agentes.
3. /tooling-strategy — quando os documentos revelaram coisas que você ainda não pode medir ou julgar (comum, e uma descoberta, não uma falha): um plano de construção priorizado para os oráculos e instrumentos faltantes. As etapas 2 e 3 trocam quando o mapa de riscos sai principalmente cego — as próprias habilidades recomendam a ordem; você sempre pode anular.
4. /strategy-variants (opcional) — uma versão de uma página ou segura para o cliente para circular.
5. /quality-artefacts (opcional) — descreva a visão que você deseja ("um resumo tuítável de onde está a qualidade", "um painel dos riscos de pagamento para minha daily") e ele projeta um artefato SVG/HTML personalizado e independente a partir da sua estratégia — honesto sobre Desconhecidos, criado para ser capturado em screenshot e compartilhado. Exemplos práticos em examples/fernly/quality/artefacts/.

Como as habilidades se encaixam

Cinco habilidades que você inicia (negrito); as demais são verificações e auditorias que as estratégias invocam para você enquanto são executadas (setas pontilhadas — cada uma também funciona de forma independente). Detalhes por habilidade: docs/SKILLS.md.

flowchart TD
    QS["<b>/quality-strategy</b><br/>a entrevista de 7 etapas — COMECE AQUI"]
    OA["/oracle-adequacy<br/><i>as afirmações 'onde estamos'<br/>podem realmente ser julgadas?</i>"]
    CC["/contradiction-check<br/><i>consistência interna,<br/>em cada fronteira de etapa</i>"]
    OD["/operational-distillation<br/><i>TL;DR + rubrica de triagem<br/>no topo do documento</i>"]
    QSR["/quality-strategy-review<br/>a auditoria de encerramento</i>"]
    SDOC[/"quality/strategy.md"/]
    TS["<b>/test-strategy</b><br/>o plano de investigação"]
    TA["/tooling-adequacy<br/><i>cada necessidade de aprendizado<br/>pode realmente ser respondida?</i>"]
    TSR["/test-strategy-review<br/>a auditoria de encerramento</i>"]
    TDOC[/"quality/test-strategy.md"/]
    TOOL["<b>/tooling-strategy</b><br/>o plano de construção de oráculos/instrumentos"]
    ODOC[/"quality/tooling-strategy.md"/]
    SV["<b>/strategy-variants</b><br/>variantes para o público"]
    VDOC[/"uma página ·<br/>versão segura para o cliente"/]
    QA["<b>/quality-artefacts</b><br/>visuais personalizados compartilháveis"]
    ADOC[/"quality/artefacts/<br/>*.svg · *.html"/]
    BUILD(["construa os oráculos<br/>& instrumentos"])

    QS -.-> OA
    QS -.-> CC
    QS -.-> OD
    QS -.-> QSR
    QS --> SDOC

    SDOC -->|"mapa de riscos principalmente<br/>respondível"| TS
    SDOC -->|"mapa de riscos principalmente cego —<br/>Desconhecidos + lacunas de oráculos"| TOOL
    SDOC -->|"precisa de algo<br/>para circular"| SV
    SDOC -->|"precisa de algo visível rapidamente —<br/>descreva a visão que você deseja"| QA

    TS -.-> TA
    TS -.-> TSR
    TS --> TDOC
    TDOC -->|"necessidades de aprendizado bloqueadas —<br/>a demanda refinada"| TOOL

    TOOL --> ODOC
    ODOC --> BUILD
    BUILD -.->|"Desconhecidos tornam-se conhecíveis —<br/>atualize o mapa de riscos,<br/>desbloqueie as necessidades de aprendizado"| SDOC

    SV --> VDOC
    QA --> ADOC

    classDef sub fill:#f6f6f6,stroke:#aaaaaa,color:#444444
    class OA,CC,OD,QSR,TA,TSR sub
    classDef doc fill:#fdf6e3,stroke:#b58900,color:#333333
    class SDOC,TDOC,ODOC,VDOC,ADOC doc

A forma segue as quatro perguntas do pacote — o que é bom? como sabemos? é bom? como tornamos bom? — e uma regra: você só pode investigar o que pode julgar, portanto, o estado do seu mapa de riscos decide se o plano de investigação ou o plano de construção vem primeiro.

O que esperar

• Eles entrevistam você. Sua estratégia de qualidade não pode ser inferida do seu código — quem importa, o que eles valorizam, o que não é objetivo seriam todos adivinhados erroneamente. As habilidades pré-leem o repositório para fazer perguntas informadas; tudo que é fundamental é perguntado, não presumido.
• Eles mantêm o padrão. Eles não pularão seus não-objetivos ou reduzirão o rigor porque um trabalho parece pequeno — essa recusa é o ponto. Eles adaptarão sua linguagem para você e oferecerão um palpite inicial claramente rotulado quando você estiver travado.
• Eles produzem documentos vivos, destinados a serem lidos, atualizados e usados em pontos de decisão — não escritos uma vez e arquivados.
• Requer pensamento real. Planeje um a dois dias úteis de tempo cognitivo, distribuídos em várias sessões — as habilidades são projetadas para pausas e retomam limpo. Mais rápido que algumas horas geralmente significa responder rápido demais.
• Nenhum repositório necessário. Na fase de ideação, a pré-leitura honestamente diz que é derivada de entrevista, em vez de maquiar palpites como resultados de varredura, e a entrevista carrega o peso que sempre carrega.

Limitações conhecidas

• Ainda não há dimensões dedicadas para produtos de IA / não determinísticos — sistemas cuja "correção" é uma distribuição de métricas que deriva. A maquinaria de stakeholders/riscos/planejamento ainda ajuda; o núcleo "o que é bom e como saberíamos" você teria que construir manualmente. Nosso principal item de pesquisa (ROADMAP.md).
• Validado principalmente em simulação. Testado sob estresse contra muitos usuários simulados e revisado adversariamente; experiência limitada no mundo real. Decisões provisórias são registradas em OPEN-QUESTIONS.md com o que mudaria nossas mentes.
• /tooling-strategy é a habilidade mais nova com menos uso — espere arestas mais pronunciadas lá.
• Cadência é única. Cada execução recebe o mesmo tratamento completo, independentemente do tamanho do projeto; uma visão mais leve do mesmo rigor está no roteiro, uma barra mais baixa não está.
• Profundidade de versão única. A análise aprofundada cobre uma versão de cada vez; execute novamente no modo de revisão quando o contexto da próxima versão for real.

De onde isso vem

Esta é a primeira versão de código aberto da Tollens — uma consultora de gestão de engenharia que transforma o senso tácito do que "bom" significa para o seu projeto, e quão bom você realmente é, em um mapa explícito e vivo do qual pessoas e agentes de IA podem raciocinar. O pacote é uma amostra funcional, independente, sem necessidade de conta — mas são habilidades independentes, não um fluxo de trabalho ponta a ponta: encaixar os documentos no processo da sua equipe é responsabilidade sua. O produto completo da Tollens (em desenvolvimento) é a versão ponta a ponta — agentes apoiando cada etapa, loops de feedback, evidências e relatórios, avaliação de confiança de release.

Simplificando: este pacote é o mapa com a seta 'você está aqui'. Tollens é o GPS — passo a passo para toda a jornada, recalculando quando você se desvia, com uma hora de chegada estimada em que você pode confiar.

O que está onde

• docs/SKILLS.md — referência por habilidade, incluindo habilidades planejadas.
• ROADMAP.md — o que vem a seguir (destaque: dimensões de qualidade para produtos de IA / não determinísticos).
• examples/fernly/ — um exemplo completo e funcional em um projeto fictício: estratégia completa, estratégia de teste e três artefatos gerados. Respostas de um projeto, não um modelo — veja seu README.
• PHILOSOPHY.md — a espinha dorsal; por que as habilidades fazem o que fazem.
• OPEN-QUESTIONS.md — decisões de design tomadas sob incerteza e o que mudaria nossas mentes.
• skills/ — as próprias habilidades.

Feedback

Conte-nos onde falha: abra uma issue. Os relatos mais valiosos são concretos — o que você executou, o que produziu, o que esperava em vez disso. Especialmente desejados: dimensões que a entrevista perdeu (ou trouxe desnecessariamente), lugares onde inferiu o que deveria ter perguntado e qualquer limitação conhecida que esteja doendo mais do que o descrito.

Créditos

O framework de qualidade é de Edmund Pringle, destilado em um cérebro de qualidade de código aberto do qual este pacote depende diretamente; sua série de blogs é a melhor leitura narrativa sobre o assunto. O framework se baseia na tradição de teste orientado por contexto (Bach, Bolton, Weinberg). Implementação das habilidades por Yanqing Cheng. Construído com Claude Code.

Licença

Licenciado sob MIT ou Apache-2.0 à sua escolha. A menos que você declare explicitamente o contrário, qualquer contribuição intencionalmente enviada para inclusão neste trabalho por você, conforme definido na licença Apache-2.0, será licenciada duplamente como acima, sem termos ou condições adicionais.