aprimoramento-de-ideias

Habilidade de Aprimoramento de Ideias

Propósito

Esclarecer e refinar ideias de funcionalidades por meio de questionamento estruturado. Este processo ajuda a descobrir ambiguidades, casos de borda e considerações de design antes de redigir o documento de conceito formal.

Quando Usar

• O usuário tem uma ideia vaga de funcionalidade, mas não está totalmente formada
• Antes de escrever um documento de conceito
• Quando uma ideia de funcionalidade precisa de mais clareza
• Para explorar o espaço de design e trade-offs

Pré-requisitos

• O usuário descreveu uma ideia vaga de funcionalidade
• O número e o nome da funcionalidade foram determinados (ou serão determinados)

Procedimento

1. Determinar Número e Nome da Funcionalidade

Se ainda não determinado:

ls -1d ./docs/features/[0-9][0-9][0-9][0-9]-* 2>/dev/null | tail -1

Trabalhe com o usuário para escolher o próximo número e um nome descritivo.

2. Criar Diretório de Planejamento

mkdir -p ./planning/NNNN-nome-da-funcionalidade

3. Inicializar Documento de Aprimoramento de Ideias

cat > ./planning/NNNN-nome-da-funcionalidade/idea-honing.md << 'EOF'
# Aprimoramento de Ideias: Nome da Funcionalidade

## Ideia Inicial

[Descrição vaga da funcionalidade pelo usuário]

## Perguntas e Respostas

EOF

4. Gerar Perguntas Iniciais

Com base na ideia vaga do usuário, identifique ambiguidades e gere perguntas sobre:

• Casos de uso e fluxos de trabalho do usuário
• Escopo e limites
• Pontos de integração
• Casos de borda
• Trade-offs e restrições
• Critérios de sucesso

Crie uma lista de perguntas a serem exploradas.

5. Fazer Perguntas UMA DE CADA VEZ

CRÍTICO: Faça apenas UMA pergunta por vez.

Para cada pergunta:

1. Faça a pergunta claramente
2. Aguarde a resposta do usuário
3. Discuta e refine a resposta se necessário
4. Quando satisfeito, escreva a Q&A no documento
5. Se surgir nova ambiguidade, adicione-a à sua lista de perguntas
6. Passe para a próxima pergunta

6. Atualizar Documento Após Cada Q&A

Após cada pergunta ser respondida, anexe ao documento:

cat >> ./planning/NNNN-nome-da-funcionalidade/idea-honing.md << 'EOF'

### Q: [Texto da pergunta]

**A**: [Texto da resposta]

EOF

7. Evoluir o Processo

Ao trabalhar com as perguntas:

• Novas ambiguidades podem surgir - adicione-as como novas perguntas
• Algumas perguntas podem se tornar irrelevantes - pule-as
• O processo se constrói organicamente

Se uma pergunta for sobre comportamento de código existente (por exemplo, "Como X funciona hoje?"):

• Anote como necessitando pesquisa
• Continue com outras perguntas
• Elas serão abordadas em pesquisa de acompanhamento

8. Concluir Quando Claro

Quando a ideia da funcionalidade estiver suficientemente clara:

• Resuma os principais insights
• Confirme com o usuário que ele está pronto para escrever o conceito
• O documento de aprimoramento de ideias permanece em planning/ para referência

Validação

Verifique o documento de aprimoramento de ideias:

# Verificar se o documento existe
ls ./planning/NNNN-nome-da-funcionalidade/idea-honing.md

# Revisar conteúdo
cat ./planning/NNNN-nome-da-funcionalidade/idea-honing.md

Problemas Comuns

Fazer várias perguntas de uma vez: Faça apenas UMA pergunta por vez. Isso mantém o foco e permite uma exploração mais profunda.

Não registrar respostas: Atualize o documento após CADA pergunta ser respondida, não em lotes.

Parar muito cedo: Continue até que o usuário se sinta confiante sobre o escopo e a abordagem da funcionalidade.

Próximos Passos

Após o aprimoramento de ideias:

1. Use a habilidade propose-feature-concept para escrever o conceito formal
2. Consulte o documento de aprimoramento de ideias ao escrever o conceito
3. As Q&As fornecem material para a narrativa do conceito