Rôle du skill writing-plans
Ce skill est conçu pour être déclenché lorsqu'une spécification ou un ensemble de requirements est disponible, avant de toucher au code. Son objectif est d'amener Claude à produire un plan d'implémentation complet et autonome, lisible par n'importe quel développeur sans contexte préalable sur le codebase d'EloPhanto.
Le skill s'intègre dans le workflow agentique du projet elophanto/elophanto, un agent IA autonome open-source. Il est typiquement invoqué après une phase de brainstorming et avant l'exécution du plan, et s'inscrit dans une chaîne de skills complémentaires.
Ce que produit ce skill
Lorsqu'il est activé, Claude génère un document Markdown structuré, sauvegardé sous docs/plans/YYYY-MM-DD-<nom-feature>.md. Ce document contient :
- Un en-tête standardisé (objectif, architecture, stack technique)
- Une cartographie des fichiers à créer ou modifier
- Des tâches décomposées en étapes de 2 à 5 minutes chacune, avec code complet, commandes exactes et résultats attendus
- Une séquence TDD stricte : écriture du test en échec → vérification de l'échec → implémentation minimale → vérification du passage → commit
Le skill insiste sur l'absence de placeholders : chaque étape doit contenir le contenu réel dont un développeur a besoin, sans renvois vagues ni TODO.
Déclencheurs et handoff
Le skill se déclenche sur des phrases comme "write a plan", "implementation plan", "break down task" ou "plan before code". Une fois le plan généré et sauvegardé, Claude propose deux modes d'exécution : exécution par sous-agents (recommandé, un agent par tâche) ou exécution inline dans la session courante via le skill executing-plans.
À qui s'adresse ce skill
Il cible des développeurs compétents mais peu familiers avec le toolset ou le domaine métier d'EloPhanto. Le plan est rédigé en assumant une maîtrise technique générale, mais aucune connaissance du codebase ni des conventions de test du projet.