Spec-Driven Development

C'est quoi spec_driven_develop ?

spec_driven_develop est un skill d'agent IA qui transforme des demandes complexes comme "réécris ce projet en Rust" ou "migre vers des microservices" en un workflow structuré et documenté. Au lieu de foncer tête baissée dans le code, l'agent suit une méthodologie rigoureuse : analyse, décomposition, suivi, exécution. Tout repose sur un seul fichier SKILL.md, pas de framework, pas de runtime. Compatible avec Claude Code, Codex, Cursor ou tout agent capable de lire du Markdown. Résultat : des migrations et refactorisations maîtrisées, traçables et reproductibles.

Prérequis

• Claude Code installé et fonctionnel (ou un autre agent compatible : Codex, Cursor)
• Git installé sur votre machine
• Un terminal avec accès en ligne de commande
• Un projet existant sur lequel appliquer le workflow (migration, réécriture, refactorisation)

Installation étape par étape

1. Créez le répertoire des skills Claude Code (s'il n'existe pas déjà) :

mkdir -p ~/.claude/skills

2. Clonez le repository spec_driven_develop :

git clone https://github.com/zhu1090093659/spec_driven_develop.git ~/.claude/skills/spec_driven_develop

3. Vérifiez que le fichier SKILL.md est bien présent :

ls -la ~/.claude/skills/spec_driven_develop/SKILL.md

4. Redémarrez Claude Code pour qu'il détecte le nouveau skill :

claude

5. Confirmez l'installation en demandant à Claude de lister ses skills disponibles :

# Dans Claude Code, tapez :
/skills

Comment l'utiliser

Exemple 1 : Réécrire un projet Python en Rust

Utilise le skill spec_driven_develop pour analyser mon projet Python dans ./src et créer un plan de migration vers Rust. Je veux garder la même API publique.

Le skill va d'abord analyser la structure de votre code Python, identifier les dépendances et les patterns utilisés, puis générer une spécification détaillée avec un plan de migration décomposé en tâches traçables avant d'écrire la moindre ligne de Rust.

Exemple 2 : Migrer un monolithe vers des microservices

Applique spec_driven_develop pour décomposer mon application monolithique Node.js en microservices. Commence par l'analyse des bounded contexts et propose une architecture cible.

Le skill va cartographier les domaines métier de votre application, identifier les frontières naturelles entre services, documenter les dépendances inter-modules, puis créer un plan de migration incrémental avec des checkpoints de validation.

Exemple 3 : Refactoriser une base de code legacy

Utilise spec_driven_develop pour planifier la refactorisation de mon code legacy Java. Objectif : passer de Java 8 à Java 21 avec les nouvelles features (records, pattern matching, virtual threads).

Le skill va inventorier les patterns obsolètes dans votre code, créer une matrice de correspondance ancien/nouveau, établir un ordre de priorité basé sur l'impact et les dépendances, puis générer des specs détaillées pour chaque transformation à effectuer.