Projete uma Interface
Baseado em "Projete Duas Vezes" de "Uma Filosofia de Projeto de Software": sua primeira ideia provavelmente não é a melhor. Gere múltiplos designs radicalmente diferentes e depois compare.
Fluxo de Trabalho
1. Levante Requisitos
Antes de projetar, entenda:
- Que problema este módulo resolve?
- Quem são os chamadores? (outros módulos, usuários externos, testes)
- Quais são as operações principais?
- Existem restrições? (desempenho, compatibilidade, padrões existentes)
- O que deve ficar oculto internamente vs exposto?
Pergunte: "O que este módulo precisa fazer? Quem vai usá-lo?"
2. Gere Designs (Subagentes Paralelos)
Dispare 3+ subagentes simultaneamente usando a ferramenta Task. Cada um deve produzir uma abordagem radicalmente diferente.
Modelo de prompt para cada subagente:
Projete uma interface para: [descrição do módulo]
Requisitos: [requisitos levantados]
Restrições para este design: [atribua uma restrição diferente a cada agente]
- Agente 1: "Minimize a quantidade de métodos - busque no máximo 1-3 métodos"
- Agente 2: "Maximize a flexibilidade - suporte muitos casos de uso"
- Agente 3: "Otimize para o caso mais comum"
- Agente 4: "Inspire-se em [paradigma/biblioteca específico]"
Formato de saída:
1. Assinatura da interface (tipos/métodos)
2. Exemplo de uso (como o chamador a usa)
3. O que este design oculta internamente
4. Compensações desta abordagem
3. Apresente os Designs
Mostre cada design com:
- Assinatura da interface - tipos, métodos, parâmetros
- Exemplos de uso - como os chamadores realmente a usam na prática
- O que oculta - complexidade mantida internamente
Apresente os designs sequencialmente para que o usuário possa absorver cada abordagem antes da comparação.
4. Compare os Designs
Após mostrar todos os designs, compare-os em:
- Simplicidade da interface: menos métodos, parâmetros mais simples
- Propósito geral vs especializado: flexibilidade vs foco
- Eficiência de implementação: a forma permite implementação eficiente?
- Profundidade: interface pequena que oculta complexidade significativa (bom) vs interface grande com implementação fina (ruim)
- Facilidade de uso correto vs facilidade de uso incorreto
Discuta as compensações em prosa, não em tabelas. Destaque onde os designs mais divergem.
5. Sintetize
Muitas vezes o melhor design combina insights de múltiplas opções. Pergunte:
- "Qual design melhor se adapta ao seu caso de uso principal?"
- "Há elementos de outros designs que valem a pena incorporar?"
Critérios de Avaliação
De "Uma Filosofia de Projeto de Software":
Simplicidade da interface: Menos métodos, parâmetros mais simples = mais fácil de aprender e usar corretamente.
Propósito geral: Pode lidar com casos de uso futuros sem alterações. Mas cuidado com generalização excessiva.
Eficiência de implementação: A forma da interface permite implementação eficiente? Ou força implementações internas estranhas?
Profundidade: Interface pequena que oculta complexidade significativa = módulo profundo (bom). Interface grande com implementação fina = módulo raso (evitar).
Antipadrões
- Não deixe os subagentes produzirem designs semelhantes - force a diferença radical
- Não pule a comparação - o valor está no contraste
- Não implemente - isto é puramente sobre a forma da interface
- Não avalie com base no esforço de implementação