Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

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-backlog

About 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

  1. Extraia termos derivados do pedido do usuário, incluindo nomes do domínio e equivalentes evidentes já usados na conversa.
  2. Antes de criar ou atualizar o item, pesquise esses termos em:
    • specs/inbox/*.md;
    • specs/backlog/*.md;
    • specs/specs/*/spec.md;
    • docs/**/*.md.
  3. 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.
  4. 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.
  5. 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

  1. Preserve a formulação original recebida na conversa ou em specs/inbox/<data-hora>-<slug>.md. Separe declaração, inferência e aberto.
  2. Confirme se o contexto esclarece:
    • problema percebido;
    • pessoa afetada ou beneficiada;
    • resultado ou valor esperado;
    • contexto suficiente para distinguir a entrada de pedidos semelhantes.
  3. Se algo estiver ausente, vago, contraditório ou ambíguo, escolha a lacuna de maior impacto e faça uma pergunta por vez.
  4. Reavalie as lacunas depois de cada resposta. Não transforme os itens em questionário fixo nem repita informação já fornecida.
  5. 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

  1. Se a pessoa apenas quiser explorar sem registrar, converse e confirme antes de escrever.
  2. Se existir item correspondente, atualize-o sem mudar seu ID e preserve a formulação anterior.
  3. Se a origem for specs/inbox/, registre esse caminho em Referências relacionadas; não altere nem apague a captura.
  4. 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>]
  1. Use o caminho absoluto impresso pelo script. Ele prefere .specsfy/templates/custom/Backlog.md e 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:

  1. Leia a entrada de specs/inbox/, o item de specs/backlog/ ou a spec indicada. Se houver mais de um candidato, pergunte qual aprofundar.
  2. Resuma em uma frase o problema, a pessoa e o resultado percebido.
  3. Separe o que está decidido do que pode mudar escopo, experiência, segurança, dados, testes ou arquitetura.
  4. Leia references/discovery-map.md para selecionar perguntas relevantes; não percorra o mapa mecanica
Read the complete source ↗