Concevoir une interface
Basé sur « Design It Twice » (Concevez-le deux fois) de A Philosophy of Software Design : votre première idée a peu de chances d'être la meilleure. Générez plusieurs conceptions radicalement différentes, puis comparez.
Flux de travail
1. Recueillir les besoins
Avant de concevoir, comprenez :
- Quel problème ce module résout-il ?
- Qui sont les appelants ? (autres modules, utilisateurs externes, tests)
- Quelles sont les opérations clés ?
- Y a-t-il des contraintes ? (performance, compatibilité, motifs existants)
- Qu'est-ce qui doit être caché à l'intérieur vs exposé ?
Demandez : « Que doit faire ce module ? Qui va l'utiliser ? »
2. Générer des conceptions (sous-agents parallèles)
Lancez 3 sous-agents ou plus simultanément à l'aide de l'outil Task. Chacun doit produire une approche radicalement différente.
Modèle de prompt pour chaque sous-agent :
Concevez une interface pour : [description du module]
Besoins : [besoins recueillis]
Contraintes pour cette conception : [attribuez une contrainte différente à chaque agent]
- Agent 1 : « Minimiser le nombre de méthodes - viser 1 à 3 méthodes maximum »
- Agent 2 : « Maximiser la flexibilité - prendre en charge de nombreux cas d'usage »
- Agent 3 : « Optimiser pour le cas le plus courant »
- Agent 4 : « S'inspirer de [paradigme/bibliothèque spécifique] »
Format de sortie :
1. Signature de l'interface (types/méthodes)
2. Exemple d'utilisation (comment l'appelant l'utilise)
3. Ce que cette conception cache en interne
4. Compromis de cette approche
3. Présenter les conceptions
Présentez chaque conception avec :
- Signature de l'interface - types, méthodes, paramètres
- Exemples d'utilisation - comment les appelants l'utilisent réellement en pratique
- Ce qu'elle cache - complexité conservée en interne
Présentez les conceptions séquentiellement pour que l'utilisateur puisse assimiler chaque approche avant la comparaison.
4. Comparer les conceptions
Après avoir montré toutes les conceptions, comparez-les sur :
- Simplicité de l'interface : moins de méthodes, paramètres plus simples
- Généraliste vs spécialisé : flexibilité vs focus
- Efficacité de l'implémentation : la forme permet-elle des internes efficaces ?
- Profondeur : petite interface cachant une complexité significative (bon) vs grande interface avec implémentation fine (mauvais)
- Facilité d'utilisation correcte vs facilité de mauvaise utilisation
Discutez des compromis en prose, pas en tableaux. Mettez en évidence les points où les conceptions divergent le plus.
5. Synthétiser
Souvent, la meilleure conception combine des idées de plusieurs options. Demandez :
- « Quelle conception correspond le mieux à votre cas d'usage principal ? »
- « Y a-t-il des éléments d'autres conceptions qui méritent d'être incorporés ? »
Critères d'évaluation
D'après A Philosophy of Software Design :
Simplicité de l'interface : moins de méthodes, paramètres plus simples = plus facile à apprendre et à utiliser correctement.
Généraliste : capable de gérer des cas d'usage futurs sans modifications. Mais attention à la sur-généralisation.
Efficacité de l'implémentation : la forme de l'interface permet-elle une implémentation efficace ? Ou force-t-elle des internes maladroits ?
Profondeur : petite interface cachant une complexité significative = module profond (bon). Grande interface avec implémentation fine = module superficiel (à éviter).
Anti-patrons
- Ne laissez pas les sous-agents produire des conceptions similaires - imposez une différence radicale
- Ne sautez pas la comparaison - la valeur réside dans le contraste
- N'implémentez pas - il s'agit uniquement de la forme de l'interface
- N'évaluez pas en fonction de l'effort d'implémentation