Rôle du skill
Ce skill fait partie des "superpowers" de développement du repo mkurman/zorai, une plateforme d'exécution agentique persistante. Son rôle est de bloquer toute implémentation prématurée : avant d'écrire la moindre ligne de code, Claude doit explorer l'intention, clarifier les exigences, proposer des approches alternatives, puis obtenir l'approbation explicite de l'utilisateur sur un document de spec.
Ce que fait ce skill
Le skill impose un processus structuré en plusieurs étapes ordonnées : exploration du contexte projet (fichiers, docs, commits récents), questions de clarification posées une à la fois, proposition de 2 à 3 approches avec leurs compromis, présentation progressive du design section par section, rédaction d'un document de spec sauvegardé dans docs/superpowers/specs/, et enfin transition vers le skill writing-plans — et uniquement celui-là. Une <HARD-GATE> explicite interdit d'invoquer tout skill d'implémentation avant validation complète de la spec.
Comment l'utiliser
Dans le contexte de Zorai, ce skill est conçu pour être invoqué en amont de tout travail créatif : création de features, ajout de composants, modifications de comportement. Il s'intègre dans la chaîne brainstorming → writing-plans → implémentation. L'utilisateur répond aux questions de clarification, valide les approches proposées, puis relit et approuve le fichier de spec avant que Claude ne passe à l'étape suivante.
Principes clés
Le skill insiste sur plusieurs principes opérationnels : YAGNI (ne pas construire ce qui n'est pas nécessaire), décomposition des projets trop larges en sous-projets indépendants, conception en unités bien délimitées avec des interfaces claires, et respect des patterns existants dans la codebase. Un companion visuel (mockups, diagrammes dans un navigateur local) peut être proposé si le sujet l'exige, mais uniquement après consentement explicite de l'utilisateur.