Communitygithub.com

jintomjose/mini-software-factory

Transforme un intent.md validé en spec.md (exigences et conception en un seul artefact), avec les préoccupations de politique et les décisions ouvertes signalées en ligne. À utiliser après capture-intent et avant le mode plan.

Qu'est-ce que mini-software-factory ?

Ce skill automatise la transition de l'intention initiale (capturée dans `intent.md`) vers un cahier des charges technique et fonctionnel (dans `spec.md`), en suivant un modèle structuré. Il est conçu pour les agents IA travaillant dans un flux de développement logiciel par étapes, par exemple avec Claude Code ou d'autres outils agentiques. Le skill lit d'abord le code existant pour identifier les contraintes, puis rédige des user stories priorisées (P1, P2, P3), attribue des identifiants stables aux exigences et aux critères de succès (FR-XXX, SC-XXX), et signale en ligne toute décision non clarifiée avec des balises `[NEEDS CLARIFICATION : ...]` ou des préoccupations de politique (`[POLICY : ...]`). La conception est limitée à ce qui est strictement nécessaire pour le plan (changements de données, interfaces, états, cas d'erreur). Enfin, il liste ce qui est explicitement hors de portée et invite à résoudre chaque `[NEEDS CLARIFICATION]` avec l'humain avant d'enregistrer le fichier. Ce skill est essentiel pour garantir que les spécifications sont complètes, traçables et prêtes pour le mode plan.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jintomjose/mini-software-factory/tree/HEAD/.claude/skills/write-spec

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Rédiger la spécification

Entrée : work/<feature>/intent.md. Sortie : work/<feature>/spec.md à partir de factory/templates/spec.md.

  1. Lisez intent.md, CLAUDE.md et les parties de la base de code que la modification va toucher. Une spécification rédigée sans lire le code ignore les contraintes ; c'est l'échec le plus courant.
  2. Rédigez les user stories par ordre de priorité (P1, P2, P3). Chaque histoire P1 doit être livrable et testable de manière indépendante.
  3. Attribuez à chaque exigence fonctionnelle un identifiant stable (FR-001) et à chaque critère de succès un aussi (SC-001). Les revues et les tests se réfèrent à ces identifiants.
  4. Signalez en ligne, sans jamais résoudre silencieusement :
    • [BESOIN DE CLARIFICATION : ...] pour toute décision que l'intention ne tranche pas
    • [POLITIQUE : confidentialité | sécurité | légal | argent | marque] partout où une règle s'applique, avec la règle
  5. Rédigez la section de conception uniquement aussi profondément que le plan en a besoin : modifications de données, interfaces, états, cas d'erreur.
  6. Listez ce qui est explicitement hors de portée.
  7. Montrez la spécification, résolvez chaque [BESOIN DE CLARIFICATION] avec l'humain, puis enregistrez. Valider spec.md déclenche le mode plan.

Skills associés