Rôle du skill writing-plans
Ce skill fait partie de la suite superpowers du repo mkurman/zorai, une plateforme d'exécution agentique durable. Son rôle est d'intervenir avant toute écriture de code : à partir d'une spec ou d'un ensemble de requirements, il produit un plan d'implémentation complet, structuré et actionnable, destiné à être exécuté par un agent ou un développeur humain.
Ce que le skill produit
Lorsqu'il est invoqué, ce skill génère un document Markdown sauvegardé dans docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md. Ce document contient : une cartographie des fichiers à créer ou modifier, une décomposition en tâches granulaires de 2 à 5 minutes chacune (avec code complet, commandes exactes et résultats attendus), et un en-tête standardisé orientant les agents vers les skills d'exécution appropriés (superpowers:subagent-driven-development ou superpowers:executing-plans).
Chaque étape suit une discipline TDD stricte — écrire le test qui échoue, vérifier qu'il échoue, écrire l'implémentation minimale, vérifier qu'il passe, committer — sans placeholder ni renvoi vague. Le skill applique les principes DRY, YAGNI et TDD, et inclut une phase d'auto-révision avant de proposer la remise en exécution.
Place dans le workflow Zorai
Ce skill est conçu pour s'insérer dans un worktree dédié, idéalement créé au préalable par le skill brainstorming. À l'issue du plan, il propose deux modes d'exécution : le mode Subagent-Driven (recommandé), où chaque tâche est confiée à un sous-agent frais, et le mode Inline Execution, où les tâches sont déroulées dans la session courante. Il s'intègre ainsi naturellement dans la chaîne d'orchestration multi-agents de Zorai.
Utilisation
Pour utiliser ce skill, il suffit de le référencer dans le contexte d'un agent Zorai disposant d'une spec ou d'un ensemble de requirements. Le skill annonce son activation ("I'm using the writing-plans skill to create the implementation plan."), effectue un scope check pour vérifier que la spec ne couvre pas plusieurs sous-systèmes indépendants, puis génère et sauvegarde le plan avant de proposer le handoff vers l'exécution.