Arrosam/Modular-Dev

Que fait Modular-Dev ?

Plugin Claude Code pour un développement diviser-pour-régner. Décompose les projets complexes en packages isolés connectés par des interfaces contractuelles. Un agent bus orchestre un développement BFS séquentiel avec test-avant-code, isolement imposé par hooks, et commits automatiques par unité logique.

Fonctionnalités

• Décomposition en packages isolés : Chaque package est développé indépendamment, avec ses propres dépendances et tests.
• Interfaces contractuelles : Les packages communiquent via des contrats clairs, réduisant les couplages accidentels.
• Agent bus : Orchestre le développement séquentiel en largeur (BFS), garantissant que chaque package est complet avant de passer au suivant.
• Test-avant-code : Les tests sont écrits avant le code de production, assurant une couverture dès le départ.
• Isolement par hooks : Des hooks Git ou pré/post-commit vérifient que les packages restent isolés.
• Commits automatiques : Chaque unité logique de travail est commitée automatiquement avec des messages descriptifs.

Utilisation

1. Installation : Ajoutez le plugin à votre projet Claude Code via le fichier de configuration approprié.
2. Configuration : Définissez vos packages et leurs interfaces contractuelles dans un fichier contracts.json (exemple ci-dessous).
3. Lancement : Invoquez l'agent bus avec claude code --skill arrosam/modular-dev ou via une commande personnalisée.

Exemple de fichier de contrats

{
  "packages": [
    {
      "name": "auth",
      "interface": {
        "login": "(username: string, password: string) => Token",
        "logout": "(token: Token) => void"
      }
    },
    {
      "name": "api-gateway",
      "interface": {
        "handleRequest": "(req: Request) => Response",
        "authenticate": "(req: Request) => boolean"
      }
    }
  ]
}

Workflow

1. Analyse : Le plugin lit les contrats et planifie l'ordre de développement (BFS).
2. Développement : Pour chaque package, il écrit d'abord les tests, puis le code.
3. Vérification : Les hooks valident que le package n'utilise que ses dépendances autorisées.
4. Commit : Le package est commitée automatiquement avec un message décrivant les changements.
5. Répétition : Passe au package suivant dans la file BFS.

Prérequis

• Claude Code installé et configuré.
• Git pour la gestion de versions et les commits automatiques.
• Node.js (version 14 ou supérieure) si vous utilisez des hooks basés sur Node.

Notes techniques

• Les hooks sont configurés dans le répertoire .git/hooks/ automatiquement.
• Les messages de commit suivent le format conventionnel : feat(package-name): description.
• Utilisez SKILL.md pour documenter vos propres personnalisations.

Support

Pour les questions ou contributions, visitez le dépôt GitHub : Arrosam/Modular-Dev.

---

Ce plugin est sous licence MIT.