Brainstorming Skill

Metadata

• •Total de Steps: 4
• •Tempo Estimado: 15-30 minutos
• •Artefato Final: docs/plans/YYYY-MM-DD-<topic>-design.md
• •Proxima Skill: writing-plans

Quando Usar

Ativa ANTES de escrever qualquer codigo quando construindo algo novo.

Proposito

Transformar ideias brutas em especificacoes validadas atraves de:

• •Questionamento socratico
• •Exploracao de alternativas
• •Validacao incremental
• •Documentacao de design

Step 1: Entender o Problema

Checkpoint: problem_understood

Acoes

Fazer perguntas clarificadoras:

• •Qual problema estamos resolvendo?
• •Quem sao os usuarios?
• •Quais sao as restricoes (tempo, tecnologia, budget)?
• •Como e o sucesso? Quais metricas?

Criterios de Validacao

• • Problema claramente definido em 1-2 frases
• • Usuarios/personas identificados
• • Restricoes documentadas
• • Criterios de sucesso estabelecidos

Saida Esperada

Resumo do problema em 2-3 paragrafos com todos os pontos acima.

Step 2: Explorar Alternativas

Checkpoint: alternatives_explored

Acoes

Apresentar 2-3 abordagens diferentes:

Criterios de Validacao

• • Pelo menos 2 alternativas apresentadas
• • Pros/contras documentados para cada
• • Recomendacao clara com justificativa
• • Usuario aprovou a abordagem escolhida

Saida Esperada

Tabela comparativa + recomendacao aprovada.

Step 3: Apresentar Design em Chunks

Checkpoint: design_presented

Acoes

Quebrar o design em secoes digeríveis, apresentando UMA de cada vez:

1. •

   Visao Geral - Diagrama de alto nivel

   • •Aguardar aprovacao antes de continuar
2. •

   Modelo de Dados - Entidades e relacionamentos

   • •Aguardar aprovacao antes de continuar
3. •

   Design de API/Interface - Endpoints ou componentes

   • •Aguardar aprovacao antes de continuar
4. •

   Consideracoes de UI/UX (se aplicavel)

   • •Aguardar aprovacao antes de continuar
5. •

   Decisoes Tecnicas - Stack, bibliotecas, padroes

   • •Aguardar aprovacao antes de continuar

Criterios de Validacao

• • Cada secao apresentada separadamente
• • Cada secao aprovada antes de avancar
• • Feedback do usuario incorporado
• • Nenhuma secao importante pulada

Saida Esperada

Design completo aprovado incrementalmente.

Step 4: Documentar Design

Checkpoint: design_documented

Acoes

Criar documento em: docs/plans/YYYY-MM-DD-<topic>-design.md

Template do Documento

# [Nome da Feature] Design

**Data**: YYYY-MM-DD
**Autor**: AI Dev Superpowers
**Status**: Aprovado

## Declaracao do Problema
[Descricao clara do problema - do Step 1]

## Solucao Proposta
[Abordagem escolhida com justificativa - do Step 2]

## Detalhes Tecnicos
[Especificacoes de implementacao - do Step 3]

### Modelo de Dados
[Entidades e relacionamentos]

### API/Interface
[Endpoints ou componentes]

### Stack e Bibliotecas
[Tecnologias escolhidas]

## Alternativas Consideradas
[Outras abordagens e porque nao escolhidas - do Step 2]

## Riscos e Mitigacoes
| Risco | Probabilidade | Impacto | Mitigacao |
|-------|---------------|---------|-----------|
| ... | ... | ... | ... |

## Proximos Passos
1. [ ] Criar plano de implementacao (skill: writing-plans)
2. [ ] Implementar com TDD (skill: test-driven-development)
3. [ ] Revisao de seguranca (agent: security-guardian)

Criterios de Validacao

• • Documento salvo no path correto
• • Todas as secoes preenchidas
• • Usuario revisou e aprovou documento final

Saida Esperada

Artefato salvo e registrado em skills.json.

Transicoes

Ao Completar com Sucesso

1. •Registrar artefato: skill_add_artifact("brainstorming", "<path>", "design")
2. •Marcar completa: skill_complete("brainstorming")
3. •Handoff para Architect: agent_handoff("orchestrator", "architect", "Criar plano de implementacao", "<path>")
4. •Iniciar proxima skill: writing-plans

Em Caso de Falha ou Abandono

1. •Registrar motivo: skill_fail("brainstorming", "<motivo>")
2. •Salvar estado parcial para retomar depois
3. •Notificar usuario sobre como retomar

Principios-Chave

1. •Pergunte antes de assumir - Nunca assuma requisitos
2. •Explore antes de comprometer - Sempre mostre alternativas
3. •Valide antes de implementar - Aprovacao em cada step
4. •Documente antes de codificar - Artefato obrigatorio

Exemplo de Uso com Orquestrador

# Inicio
skill_init "brainstorming"
skill_set_steps "brainstorming" 4

# Step 1: Entender problema
skill_advance "brainstorming" "Entender o problema"
# ... fazer perguntas, obter respostas ...
skill_validate_checkpoint "brainstorming"

# Step 2: Explorar alternativas
skill_advance "brainstorming" "Explorar alternativas"
# ... apresentar opcoes, obter escolha ...
skill_validate_checkpoint "brainstorming"

# Step 3: Apresentar design
skill_advance "brainstorming" "Apresentar design em chunks"
# ... apresentar secao por secao ...
skill_validate_checkpoint "brainstorming"

# Step 4: Documentar
skill_advance "brainstorming" "Documentar design"
# ... criar documento ...
skill_add_artifact "brainstorming" "docs/plans/2024-01-15-login-design.md" "design"
skill_validate_checkpoint "brainstorming"

# Finalizar
skill_complete "brainstorming"
agent_handoff "orchestrator" "architect" "Criar plano de implementacao" "docs/plans/2024-01-15-login-design.md"