Distillation de Framework
Présentation
Extrayez l'architecture, pas le code.
Utilisez cette compétence pour rétro-concevoir la forme d'un framework, son modèle d'exécution, ses points d'extension et ses compromis d'ingénierie afin qu'une autre IA ou une équipe puisse reproduire une architecture similaire dans un autre langage ou domaine.
Quand l'utiliser
- Rétro-concevoir l'architecture d'un framework au-delà du README et de l'API publique
- Étudier l'exécution, le cycle de vie, la machine à états ou le mécanisme d'extension
- Reproduire un framework similaire dans un autre langage ou domaine
- Créer des packages de connaissances d'architecture lisibles par l'IA
- Comparer des frameworks selon leur architecture et leurs compromis
Cibles typiques : runtimes d'agents, moteurs de workflows, frameworks de machines à états, systèmes de plugins, plateformes d'orchestration.
Quand ne pas l'utiliser
- Résumé de README uniquement
- Tutoriel d'API ou guide d'utilisation
- Parcours ligne par ligne du code
- Réimplémentation par copier-coller
- Inventaire de fonctionnalités sans analyse des compromis
Si la demande est proche mais hors cible, redirigez d'abord le périmètre.
Entrées requises
Minimum :
- URL du dépôt ou chemin source local
Recommandé :
- Nom du framework
- Objectif d'analyse
- Langage ou domaine d'implémentation cible
- Profondeur :
mini,standardoudeep - Domaines d'intérêt
Principe fondamental
Architecture > Code
Raisonnement > Syntaxe
Conception > API
Compromis > Fonctionnalité
Principes > Implémentation
Flux de travail
- Vérifier la pertinence ; refuser ou rediriger les demandes de tutoriel/API/parcours fichier par fichier.
- Choisir la profondeur en fonction de l'objectif. Par défaut
standard; utiliserminipour un premier passage rapide,deeppour une reproduction exhaustive. - Parcourir la documentation, les tests, les exemples et la forme du dépôt avant une lecture approfondie du code source.
- Extraire l'architecture, l'exécution, l'état, le modèle de données, les points d'extension, les décisions et les compromis.
- Distiller les règles réutilisables et produire une sortie adaptée au mode choisi et à l'objectif de reproduction.
Règles d'exécution
- Commencer par l'architecture, pas par les listes de fonctionnalités.
- Ne pas dériver vers un tutoriel, un inventaire d'API ou un parcours fichier par fichier.
- Ancrer les affirmations sur des preuves issues du code, de la documentation, des tests, des exemples ou de l'historique des commits lorsque c'est possible.
- Distinguer les faits observés des inférences ; utiliser
Observé,Fortement inféré,Inférence provisoirelorsque les preuves sont minces. - Indiquer explicitement un accès incomplet au dépôt ou des preuves faibles.
- Adapter l'analyse au langage cible, au domaine, aux domaines d'intérêt et aux critères de comparaison.
Modes de sortie
mini— résumé rapide d'architecture de premier passagestandard— extraction complète d'architecture pour la plupart des étudesdeep— rétro-conception exhaustive pour la reproduction du framework
Détails dans :
references/output-modes.mdreferences/analysis-checklist.mdreferences/deliverables.md
Anti-patrons
Éviter :
- Résumer uniquement le README
- Lister les API sans architecture
- Expliquer les exemples sans extraire la conception
- Décrire le code sans se demander pourquoi il existe
- Ignorer les compromis, les chemins d'échec ou les points d'extension
- Copier l'implémentation au lieu de distiller les principes
- Déclarer la philosophie ou la raison d'être comme un fait lorsque les preuves sont faibles
- Comparer les frameworks uniquement par une liste de fonctionnalités
Références complémentaires
references/output-modes.md— formes de sortie, modèles, diagrammesreferences/analysis-checklist.md— liste de vérification d'analyse et porte de qualitéreferences/deliverables.md— structure des livrables et invite de simulation d'IAreferences/self-test.md— révision des lacunes et correctifs appliquésreferences/simulated-dialogue-tests.md— invites de pression et tableau de bord