| name | cria-vision |
| description | Cria o documento de visão do produto (vision.md) a partir de uma ideia ou problema. Define propósito, público-alvo e proposta de valor do sistema. Use no início de um projeto ou quando houver necessidade de redefinir a direção do produto. Não use para definir funcionalidades detalhadas ou requisitos técnicos. |
Criação de Vision
Procedimentos
Passo 1: Validar Entrada
- Confirme que o usuário forneceu uma ideia, problema ou descrição do produto.
- Caso esteja vago, solicite mais contexto antes de prosseguir.
Passo 2: Esclarecer Contexto (Obrigatório)
- Faça perguntas de esclarecimento ao usuário antes de gerar qualquer conteúdo:
- Problema: Qual problema o produto resolve? Para quem é doloroso?
- Público-Alvo: Quem são os usuários principais? Há usuários secundários?
- Proposta de Valor: Por que esse produto é melhor/diferente das alternativas?
- Contexto de Uso: Em que situação e ambiente será usado?
- Restrições: Existem limitações de prazo, orçamento ou tecnologia relevantes?
- NÃO prossiga até obter respostas suficientes para redigir o documento.
Passo 3: Planejar Documento (Obrigatório)
- Defina estrutura do documento:
- Problema
- Solução
- Público-alvo
- Proposta de valor
- Escopo geral (alto nível, sem funcionalidades detalhadas)
- Liste suposições e premissas.
- Apresente o plano ao usuário para alinhamento antes de redigir.
Passo 4: Redigir Vision (Obrigatório)
- Criar documento conciso (máx. ~500 palavras).
- NÃO listar funcionalidades detalhadas.
- Focar em clareza estratégica — o documento deve ser estável ao longo do tempo.
- Usar linguagem acessível, evitando jargão técnico desnecessário.
Passo 5: Salvar Arquivo
- Crie o diretório
./ai-sdd/system/ se não existir.
- Caminho:
./ai-sdd/system/vision.md
Passo 6: Relatar Resultado
- Informar caminho final do arquivo.
- Resumo breve do conteúdo gerado.
Princípios Fundamentais
- Esclareça antes de planejar; planeje antes de redigir.
- Foco em propósito, não features.
- Clareza > completude.
- O documento deve ser estável ao longo do tempo — evite detalhes que mudam frequentemente.
Lista de Verificação de Qualidade
Tratamento de Erros
- Se o usuário fornecer contexto insuficiente, faça perguntas de esclarecimento complementares antes de prosseguir.
- Se o diretório de saída já contiver um
vision.md, confirme com o usuário antes de sobrescrever.
- Se o plano for rejeitado pelo usuário, revise com base no feedback e reapresente para alinhamento.