product-capability

Visão geral da skill product-capability

product-capability é uma skill de planejamento para especificação, feita para transformar intenção de produto ainda nebulosa em um plano de capacidade pronto para implementação. Ela é mais útil quando você já sabe o objetivo da funcionalidade, mas o time ainda precisa de clareza sobre restrições, interfaces, regras de ciclo de vida, implicações de dados e decisões em aberto antes de começar a codar.

Melhor encaixe: PRDs que ainda estão vagos demais

Use a skill product-capability quando já existe um PRD, item de roadmap, nota de fundador ou thread de produto, mas a forma de engenharia ainda está implícita. Ela é especialmente útil em trabalhos com vários serviços, dependências entre times ou funcionalidades em que os revisores vivem perguntando: “O que exatamente precisa ser verdade antes de construirmos isso?”

O que ela entrega além de um prompt comum

Diferentemente de um prompt genérico para “escrever uma spec”, product-capability é orientada a contratos de capacidade duráveis. Ela ajuda a separar promessas de produto de restrições de implementação, explicitar perguntas sem resposta em vez de chutá-las e produzir um artefato que pode ser reutilizado entre sessões, em vez de se perder no histórico do chat.

Quando vale a pena instalar

Se o seu time passa ciclos de revisão redescobrindo premissas escondidas, product-capability install provavelmente compensa. Se o seu trabalho é quase sempre em um único arquivo, de baixo risco ou já bem definido por uma arquitetura forte e documentação técnica existente, a skill pode agregar menos valor do que um prompt leve.

Como usar a skill product-capability

Instale e carregue no seu workspace

Instale a skill com:

npx skills add affaan-m/everything-claude-code --skill product-capability

Depois, abra SKILL.md primeiro. Para product-capability usage, também verifique qualquer arquivo durável de contexto de produto que o repositório espere, especialmente PRODUCT.md, docs/product/ ou um diretório de program-spec. Se não existir nada disso, use o caminho de template referenciado pela skill.

Transforme um pedido rascunhado em uma entrada forte

A skill funciona melhor quando você entrega objetivo de produto mais contexto, e não só o nome da funcionalidade. Um briefing fraco como “adicionar compartilhamento em equipe” deixa lacunas demais. Um briefing mais forte seria: “Desenhe um plano de capacidade para compartilhamento em equipe entre web e API, incluindo permissões, eventos de auditoria, ciclo de vida de convites e o que acontece quando um workspace é rebaixado.”

Fluxo sugerido de product-capability para planejamento de requisitos

Comece com a declaração de produto e depois peça os limites da capacidade, invariantes, premissas, perguntas em aberto e implicações de implementação. As melhores saídas de product-capability guide normalmente descrevem o que precisa ser verdade antes do trabalho começar, e não apenas uma lista de funcionalidades. Se o pedido atravessa serviços ou times, peça para a skill explicitar ownership e fronteiras de contrato.

Leia primeiro, depois estenda

O repositório é propositalmente enxuto, então a primeira leitura mais útil é SKILL.md. Use esse arquivo para entender o conjunto de regras e o alvo do artefato, e então adapte a estrutura ao seu próprio repositório em vez de copiar o exemplo literalmente. Se o seu ambiente já tiver um local canônico para documentos de produto, alinhe a saída a esse caminho para evitar a criação de arquivos paralelos de planejamento.

FAQ da skill product-capability

product-capability serve só para PRDs?

Não. A skill product-capability também se encaixa em itens de roadmap, notas de discussão e direcionamento do fundador quando o problema real é transformar intenção em um contrato que possa ser construído. O requisito principal é haver sinal de produto suficiente para definir restrições sem inventá-las.

Em que ela difere de escrever prompts comuns?

Um prompt normal pode gerar um resumo ou um plano inicial. product-capability é mais específica: ela tenta preservar verdades relevantes para engenharia, deixar explícito o que não se sabe e produzir um artefato reutilizável. Isso a torna melhor quando o custo de deixar passar uma restrição é alto.

É amigável para iniciantes?

Sim, desde que você consiga descrever a funcionalidade e o contexto dela. Você não precisa dominar arquitetura para usar product-capability, mas precisa fornecer os melhores fatos que tiver. Se faltar informação crítica, o resultado ainda vai precisar de revisão.

Quando eu não deveria usar?

Não use product-capability para tarefas triviais, ajustes isolados de UI ou trabalho já regido por uma spec detalhada. Ela também não é uma boa opção se você quer texto de marketing polido ou código de implementação, e não material de Requirements Planning.

Como melhorar a skill product-capability

Dê os fatos que mais importam

Os maiores ganhos de qualidade vêm de nomear logo de início o comportamento visível para o usuário, os limites do sistema e as restrições conhecidas. Inclua fluxo de dados, regras de acesso, expectativas de rollback, sistemas dependentes e qualquer questão de política ou compliance que possa mudar a implementação.

Torne os desconhecidos explícitos, em vez de implícitos

Uma entrada forte para product-capability separa requisitos confirmados de perguntas em aberto. Se o time ainda não decidiu se uma ação será síncrona, se logs de auditoria são obrigatórios ou qual serviço é dono da source of truth, diga isso diretamente. Isso impede que a skill alise a incerteza.

Peça um artefato pronto para decisão

Se o primeiro rascunho ficar amplo demais, peça para a skill enxugar o escopo, listar os não negociáveis e destacar os tradeoffs que travam decisões de design. Iterar desse jeito geralmente melhora a saída de product-capability usage mais do que pedir mais detalhe em tudo.

Reaproveite a mesma estrutura de capacidade

Para trabalhos recorrentes de produto, mantenha a mesma estrutura de capacidade entre sessões para que os revisores consigam comparar os planos de forma consistente. Quanto mais suas entradas refletirem o modelo operacional real do seu time, mais a skill product-capability vai gerar orientação útil em vez de prosa genérica de planejamento.