Diseñar una Interfaz
Basado en "Diseñarlo dos veces" de "Una filosofía del diseño de software": tu primera idea probablemente no sea la mejor. Genera múltiples diseños radicalmente diferentes, luego compara.
Flujo de Trabajo
1. Recopilar Requisitos
Antes de diseñar, entiende:
- ¿Qué problema resuelve este módulo?
- ¿Quiénes son los llamantes? (otros módulos, usuarios externos, pruebas)
- ¿Cuáles son las operaciones clave?
- ¿Alguna restricción? (rendimiento, compatibilidad, patrones existentes)
- ¿Qué debería ocultarse internamente vs exponerse?
Pregunta: "¿Qué necesita hacer este módulo? ¿Quién lo usará?"
2. Generar Diseños (Subagentes Paralelos)
Lanza 3+ subagentes simultáneamente usando la herramienta Task. Cada uno debe producir un enfoque radicalmente diferente.
Plantilla de prompt para cada subagente:
Diseña una interfaz para: [descripción del módulo]
Requisitos: [requisitos recopilados]
Restricciones para este diseño: [asigna una restricción diferente a cada agente]
- Agente 1: "Minimizar el número de métodos - apuntar a 1-3 métodos como máximo"
- Agente 2: "Maximizar flexibilidad - soportar muchos casos de uso"
- Agente 3: "Optimizar para el caso más común"
- Agente 4: "Inspirarse en [paradigma/biblioteca específico]"
Formato de salida:
1. Firma de la interfaz (tipos/métodos)
2. Ejemplo de uso (cómo lo usa el llamante)
3. Qué esconde este diseño internamente
4. Compensaciones de este enfoque
3. Presentar Diseños
Muestra cada diseño con:
- Firma de la interfaz - tipos, métodos, parámetros
- Ejemplos de uso - cómo los llamantes lo usan realmente en la práctica
- Qué esconde - complejidad mantenida interna
Presenta los diseños secuencialmente para que el usuario pueda asimilar cada enfoque antes de comparar.
4. Comparar Diseños
Después de mostrar todos los diseños, compáralos en:
- Simplicidad de la interfaz: menos métodos, parámetros más simples
- Uso general vs especializado: flexibilidad vs enfoque
- Eficiencia de implementación: ¿la forma permite una implementación eficiente?
- Profundidad: interfaz pequeña que oculta complejidad significativa (bueno) vs interfaz grande con implementación delgada (malo)
- Facilidad de uso correcto vs facilidad de mal uso
Discute las compensaciones en prosa, no en tablas. Destaca dónde los diseños divergen más.
5. Sintetizar
A menudo el mejor diseño combina ideas de múltiples opciones. Pregunta:
- "¿Qué diseño se adapta mejor a tu caso de uso principal?"
- "¿Algún elemento de otros diseños que valga la pena incorporar?"
Criterios de Evaluación
De "Una filosofía del diseño de software":
Simplicidad de la interfaz: Menos métodos, parámetros más simples = más fácil de aprender y usar correctamente.
Uso general: Puede manejar casos de uso futuros sin cambios. Pero cuidado con la generalización excesiva.
Eficiencia de implementación: ¿La forma de la interfaz permite una implementación eficiente? ¿O fuerza estructuras internas incómodas?
Profundidad: Interfaz pequeña que oculta complejidad significativa = módulo profundo (bueno). Interfaz grande con implementación delgada = módulo superficial (evitar).
Antipatrones
- No dejes que los subagentes produzcan diseños similares - exige diferencias radicales
- No te saltes la comparación - el valor está en el contraste
- No implementes - esto es puramente sobre la forma de la interfaz
- No evalúes basándote en el esfuerzo de implementación