Documentation & Modernization
Ce skill, publié dans le repo communautaire github/awesome-copilot, est un skill GitHub Copilot pleinement développé et fonctionnel — il ne s'agit pas d'un template ou d'un squelette. Il regroupe deux workflows complémentaires destinés à travailler sur un repository déjà cloné en local.
Deux modes en un seul skill
Documentation mode génère un document d'architecture unique, complet et citable, en lisant les fichiers du checkout local (approche local-first). L'objectif est de produire un document de référence — stack technique, points d'entrée, inventaire des commandes, cartographie des répertoires, diagrammes C4 en Mermaid, deep-dives sur les sous-systèmes complexes — qu'un nouvel ingénieur pourrait utiliser directement pour son onboarding. Chaque affirmation est ancrée à un fichier sur disque, avec numéro de ligne ; les incertitudes sont explicitement marquées [INFERRED] ou [UNVERIFIED].
Modernization mode transforme ce document d'architecture en un plan de modernisation phasé et actionnable pour un système legacy. Il adopte une posture dead-by-default : plutôt que d'exiger une CI verte sur l'ancien stack avant de commencer, il réalise un feasibility spike limité dans le temps, identifie un Testability Milestone par composant, et positionne chaque phase sur une safety ladder (L0 à L4). Si aucun document d'architecture n'existe encore, le skill exécute d'abord le Documentation mode dans le même passage, puis enchaîne directement avec le plan. Le résultat final est un fichier MODERNIZATION_PLAN.md et un .github/copilot-instructions.md pré-rempli avec les commandes et règles de gating du projet.
Comment l'utiliser
Dans une session GitHub Copilot avec accès aux outils de lecture de fichiers locaux, il suffit d'invoquer ce skill sur un repository cloné et d'exprimer l'intention : "documente cette codebase" pour le Documentation mode, ou "modernise ce projet" / "planifie la migration" pour le Modernization mode. Le skill sélectionne automatiquement le bon mode selon la formulation, ou enchaîne les deux si nécessaire. Il est conçu pour être générique (agnostique au langage et à l'écosystème) et s'adapte aux outils détectés dans le repository réel.