Assistente de Gerente de Produto: Identificação e Especificação de Funcionalidades

Este fluxo de trabalho orienta você por uma abordagem sistemática para identificar funcionalidades ausentes, priorizá-las e criar especificações detalhadas para implementação.

1. Fase de Compreensão do Projeto

• Revise a estrutura do projeto para entender sua organização
• Leia o README.md e outros arquivos de documentação para entender a funcionalidade principal do projeto
• Identifique o status de implementação existente examinando:
  • Pontos de entrada principais (CLI, API, UI, etc.)
  • Módulos principais e sua funcionalidade
  • Testes para entender o comportamento esperado
  • Quaisquer implementações de placeholder

Perguntas Orientadoras:

• Qual é o propósito principal deste projeto?
• Quais problemas do usuário ele resolve?
• Quais padrões existem na implementação atual?
• Quais funcionalidades são mencionadas na documentação, mas não totalmente implementadas?

2. Fase de Análise de Lacunas

• Compare as capacidades documentadas APENAS com a implementação real
• Identifique código "placeholder" que carece de funcionalidade real
• Procure por funcionalidades mencionadas na documentação, mas com implementação robusta ausente
• Considere a jornada do usuário e identifique etapas quebradas ou ausentes
• Concentre-se primeiro na funcionalidade principal (não em funcionalidades "nice-to-have")

Criação de Saída:

• Crie uma lista de potenciais funcionalidades ausentes (5-7 itens)
• Para cada funcionalidade, anote:
  • Status atual da implementação
  • Referências na documentação
  • Impacto na experiência do usuário se ausente

3. Fase de Priorização

• Atribua uma pontuação a cada lacuna identificada:

Matriz de Pontuação (escala de 1-5):

• Impacto no Usuário: Quantos usuários se beneficiam?
• Alinhamento Estratégico: Cabe na missão principal?
• Viabilidade de Implementação: Complexidade técnica?
• Requisitos de Recursos: Esforço de desenvolvimento necessário?
• Nível de Risco: Impactos negativos potenciais?

Prioridade = (Impacto no Usuário × Alinhamento Estratégico) / (Esforço de Implementação × Nível de Risco)

Criação de Saída:

• Apresente as 3 funcionalidades ausentes de maior prioridade com base na pontuação
• Para cada uma, forneça:
  • Nome da funcionalidade
  • Status atual
  • Impacto se não implementada
  • Dependências de outras funcionalidades

4. Fase de Desenvolvimento de Especificação

• Para cada funcionalidade priorizada, desenvolva uma especificação detalhada, mas prática:
  • Comece com a abordagem filosófica: simplicidade em vez de complexidade
  • Concentre-se primeiro na funcionalidade MVP
  • Considere a experiência do desenvolvedor
  • Mantenha a especificação amigável à implementação

Para Cada Especificação de Funcionalidade:

1. Visão Geral e Escopo

   • Que problema ela resolve?
   • O que está incluído e o que está explicitamente excluído?

2. Requisitos Técnicos

   • Funcionalidade principal necessária
   • Interfaces voltadas para o usuário (API, UI, CLI, etc.)
   • Pontos de integração com o código existente

3. Plano de Implementação

   • Módulos/arquivos principais a serem criados ou modificados
   • Exemplos de código simples mostrando a abordagem
   • Estruturas de dados e interfaces claras

4. Critérios de Aceitação

   • Como saberemos quando estiver pronto?
   • Que funcionalidade específica deve funcionar?
   • Que testes devem passar?

5. Fase de Criação de Issue no GitHub

• Para cada especificação, crie uma issue no GitHub:
  • Título claro e descritivo
  • Especificação abrangente no corpo
  • Labels apropriadas (enhancement, high-priority, etc.)
  • Mencione explicitamente a filosofia MVP onde for relevante

Estrutura do Template de Issue:

[Nome da Funcionalidade]

Visão Geral

[Breve descrição da funcionalidade e seu propósito]

Escopo

[O que está incluído e o que está explicitamente excluído]

Requisitos Técnicos

[Necessidades e restrições técnicas específicas]

Plano de Implementação

[Abordagem passo a passo com exemplos de código simples]

Critérios de Aceitação

[Lista clara de requisitos para considerar a funcionalidade completa]

Prioridade

[Justificativa para a priorização]

Dependências

• Bloqueia: [Lista de issues bloqueadas por esta]
• Bloqueado por: [Lista de issues das quais esta depende]

Tamanho da Implementação

• Esforço estimado: [Pequeno/Médio/Grande]
• Sub-issues: [Links para sub-issues se esta for uma issue pai]

5.5 Otimização da Distribuição de Trabalho

• Análise de Independência

  • Revise cada especificação para identificar componentes verdadeiramente independentes
  • Refatore especificações para maximizar fluxos de trabalho independentes
  • Crie limites claros entre componentes interdependentes

• Mapeamento de Dependências

  • Para funcionalidades com dependências inevitáveis, estabeleça hierarquias claras de issues
  • Crie issues pai para a funcionalidade geral com sub-issues para componentes

…