specsfy-02-backlog
Use quando o usuário quer transformar uma captura de `specs/inbox/`, uma oportunidade, um problema ou um item existente em backlog pronto para especificação, inclusive por transição automática. Pesquisa duplicatas e referências, cria ou atualiza `specs/backlog/`, faz perguntas adaptativas, aplica o MCR-10 e produz um brief testável. Para apenas guardar um texto sem perguntas use specsfy-01-inbox; não use para escrever spec.md, tarefas, testes ou implementação.
promovaweb · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add promovaweb/specsfy --skill specsfy-02-backlogAbout this skill
name: specsfy-02-backlog
description: "Use quando o usuário quer transformar uma captura de specs/inbox/, uma oportunidade, um problema ou um item existente em backlog pronto para especificação, inclusive por transição automática. Pesquisa duplicatas e referências, cria ou atualiza specs/backlog/, faz perguntas adaptativas, aplica o MCR-10 e produz um brief testável. Para apenas guardar um texto sem perguntas use specsfy-01-inbox; não use para escrever spec.md, tarefas, testes ou implementação."
Refinar e aprofundar o backlog
Transforme uma entrada vaga em um item de backlog compreensível e, quando a intenção exigir especificação, aprofunde as decisões até produzir um brief testável. Esta é a segunda etapa sequencial do framework. Ela reúne registro, refinamento e descoberta sem transformar o backlog em fonte normativa.
Orquestrar a conversa
Ao concluir esta etapa ou detectar trabalho de outra etapa, anuncie
Pendência detectada: <descrição> — ação: resolvendo nesta etapa e resolva-a
quando pertencer ao próprio escopo. Quando houver troca de responsabilidade,
anuncie Transição automática: $specsfy-02-backlog → $<destino> — motivo: <motivo> — resultado esperado: <resultado> e carregue imediatamente a skill
de destino, sem pedir confirmação nem repetir o comando. Continue na mesma
conversa.
Depois de uma correção necessária a esta etapa, anuncie Retomada automática: $<destino> → $specsfy-02-backlog — pendência resolvida: <resultado> e retome-a
imediatamente. Reavalie o estado após cada handoff para evitar ciclos. O handoff
não exige confirmação; ações sensíveis continuam exigindo autorização
específica.
Buscar duplicatas e referências
- Extraia termos derivados do pedido do usuário, incluindo nomes do domínio e equivalentes evidentes já usados na conversa.
- Antes de criar ou atualizar o item, pesquise esses termos em:
specs/inbox/*.md;specs/backlog/*.md;specs/specs/*/spec.md;docs/**/*.md.
- Leia somente resultados plausíveis e classifique cada relação:
- possível duplicata: problema, pessoa, resultado e contexto substancialmente iguais;
- backlog relacionado: item complementar, dependência ou precedente;
- spec relacionada: comportamento definido ou entregue que limita o item;
- documentação relacionada: vocabulário, regra ou contexto do projeto.
- Apresente correspondências materiais com seus caminhos. Diante de possível duplicata, confirme com o usuário se deve atualizar o item ou registrar uma diferença real.
- Registre fontes úteis em
Referências relacionadas, com caminho relativo e tipo de relação. Não transforme uma decisão encontrada em declaração do usuário.
Se uma resposta mudar materialmente os termos, o problema, a pessoa, o resultado ou o contexto, repita a busca.
Garantir a captura mínima
- Preserve a formulação original recebida na conversa ou em
specs/inbox/<data-hora>-<slug>.md. Separe declaração, inferência e aberto. - Confirme se o contexto esclarece:
- problema percebido;
- pessoa afetada ou beneficiada;
- resultado ou valor esperado;
- contexto suficiente para distinguir a entrada de pedidos semelhantes.
- Se algo estiver ausente, vago, contraditório ou ambíguo, escolha a lacuna de maior impacto e faça uma pergunta por vez.
- Reavalie as lacunas depois de cada resposta. Não transforme os itens em questionário fixo nem repita informação já fornecida.
- Não crie nem atualize o arquivo enquanto algum item essencial continuar ausente ou ambíguo. Se a pessoa não souber responder, explique a lacuna sem inventar conteúdo.
A captura mínima não exige solução técnica, critérios completos de aceitação ou prioridade. Esses dados podem amadurecer no aprofundamento.
Criar ou atualizar o item
- Se a pessoa apenas quiser explorar sem registrar, converse e confirme antes de escrever.
- Se existir item correspondente, atualize-o sem mudar seu ID e preserve a formulação anterior.
- Se a origem for
specs/inbox/, registre esse caminho emReferências relacionadas; não altere nem apague a captura. - Para criar um item novo, execute:
python3 -B <diretório-da-skill>/scripts/iniciar_backlog.py \
--title "<título curto>" \
--idea "<formulação original>" \
--problem "<problema percebido>" \
--person "<pessoa afetada ou beneficiada>" \
--result "<resultado ou valor esperado>" \
--context "<contexto que distingue a ideia>" \
[--slug <slug>] [--root <raiz>]
- Use o caminho absoluto impresso pelo script. Ele prefere
.specsfy/templates/custom/Backlog.mde recorre a.specsfy/templates/Backlog.md.
Organizar e priorizar
Leia references/backlog-quality.md ao estruturar, refinar, priorizar ou
avaliar prontidão.
- Classifique, quando conhecido, em Produto → Épico → Funcionalidade → item.
- Use tipos como épico, história, regra, técnico e melhoria sem confundir tipo com prioridade.
- Ordene por valor, risco, dependências, urgência, esforço, desbloqueios e incerteza; não marque tudo como prioridade alta.
- Aprofunde campos conforme risco e complexidade. Autenticação, pagamentos, permissões, privacidade e operações assíncronas exigem mais cuidado.
- Prefira comportamento observável a solução de interface.
- Torne atributos de qualidade mensuráveis quando forem materiais.
- Use listas, fluxos, cenários ou matrizes quando reduzirem ambiguidade.
Aprofundar para a especificação
Quando a pessoa pedir aprofundamento, promoção ou criação de uma spec:
- Leia a entrada de
specs/inbox/, o item despecs/backlog/ou a spec indicada. Se houver mais de um candidato, pergunte qual aprofundar. - Resuma em uma frase o problema, a pessoa e o resultado percebido.
- Separe o que está decidido do que pode mudar escopo, experiência, segurança, dados, testes ou arquitetura.
- Leia
references/discovery-map.mdpara selecionar perguntas relevantes; não percorra o mapa mecanica