1136dc683f
- Create docs/resource-evaluations/ with 15 evaluation files - Standardize filenames (remove date prefixes) - Keep working docs and private audits in claudedocs/ (gitignored) - Add resource evaluation workflow to CLAUDE.md Files migrated: - gsd, worktrunk, boris-cowork-video, wooldridge-productivity-stack - remotion, nick-jensen, se-cove, self-improve-skill - astgrep, clawdbot, prompt-repetition, uml-diagrams - vibe-coding-rusitschka, anthropic-releases Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
3.4 KiB
Évaluation: UML Diagrams for OOP Codebases
Date: 2026-01-25 Source: LinkedIn Post - Dennis Piskovatskov URL: https://www.linkedin.com/posts/tigraff_uml-claude-wibecoding-activity-7420595633826258944-gGO5 Score: 3/5 (Pertinent - Complément utile)
Résumé
Pattern suggéré : utiliser des diagrammes d'architecture (UML/Mermaid) comme contexte additionnel pour les codebases OOP complexes, afin de compenser les limitations des LLMs dans le raisonnement sur la polymorphie et les dépendances.
Validations
✅ Problème OOP confirmé
ACM 2024 Research: LLMs Still Can't Avoid Instanceof
- Confirme que les LLMs ont des difficultés avec le raisonnement polymorphique
- Le chunking de fichiers perd les relations structurelles (hiérarchies de classes, implémentations d'interfaces, dépendances cross-module)
✅ MCP Tools vérifiés
Archy MCP (phxdev1, April 2025):
- URL: https://www.pulsemcp.com/servers/phxdev1-archy
- Auto-génère Mermaid depuis GitHub repos ou descriptions textuelles
- Supporte: flowcharts, class diagrams, sequence diagrams
Mermaid MCP (hustcc):
- 61.4K utilisateurs
- Thèmes personnalisés, couleurs de fond, rendu temps réel
Blueprint MCP (ArcadeAI):
- Descriptions textuelles → diagrammes techniques
- Gestion de jobs asynchrones
⚠️ Source originale non vérifiable
WibeCoding: Mentionné dans le post LinkedIn mais non trouvé publiquement Contexte: Pattern reporté sur un projet Java/Spring Limitation: Non validé à grande échelle
Intégration
Approches identifiées
| Approche | Maintenance | Coût Token | Meilleur pour |
|---|---|---|---|
| Archy MCP | Zéro (auto-gen) | À la demande | GitHub repos avec hiérarchies de classes |
| Inline Mermaid | Manuel | 200-500 tokens | Vues architecturales personnalisées |
| PlantUML ref | Manuel | Minimal | Intégration entreprise/IDE |
Workflow recommandé
- Essayer Serena d'abord:
get_symbols_overview+find_symbol(zéro maintenance) - Si insuffisant: Utiliser Archy MCP pour auto-générer des class diagrams
- Dernier recours: Mermaid manuel inline pour vues personnalisées
Cas d'usage
- Codebases OOP >20 modules avec héritage complexe
- Projets Java/Spring avec polymorphisme profond
- Quand l'overview de symboles Serena est insuffisant
Key Insight
"Context structure matters more than context size" — Les relations explicites améliorent le raisonnement LLM sur les architectures OOP.
Trade-offs
Avantages:
- ✅ MCP tools auto-génération (zéro maintenance avec Archy)
- ✅ Validation académique du problème (ACM 2024)
- ✅ Alternative Serena disponible (zéro maintenance également)
Limitations:
- ⚠️ Source originale (WibeCoding) non trouvée publiquement
- ⚠️ Pattern non validé à grande échelle
- ⚠️ Coût token pour inline Mermaid (200-500 tokens)
Conclusion
Décision: Intégration avec nuances
- Section ajoutée dans
guide/ai-ecosystem.md(Context Packing Tools) - Warning clair sur validation limitée
- Recommandation de workflow: Serena → Archy → Manual
- Référencement des MCP tools vérifiés publiquement
Raison du score 3/5: Pattern utile pour cas spécifiques (OOP complexe), mais pas une solution universelle. L'alternative Serena + grepai peut atteindre des résultats similaires avec zéro maintenance.