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>
87 lines
3.4 KiB
Markdown
87 lines
3.4 KiB
Markdown
# É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](https://dl.acm.org/doi/10.1145/3639474.3640052)
|
|
- 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é
|
|
|
|
1. **Essayer Serena d'abord**: `get_symbols_overview` + `find_symbol` (zéro maintenance)
|
|
2. **Si insuffisant**: Utiliser **Archy MCP** pour auto-générer des class diagrams
|
|
3. **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.
|