jintomjose/mini-software-factory

Transformez une idée vague, une plainte utilisateur ou un incident en un fichier intent.md validé, en interrogeant la personne concernée. À utiliser avant toute spécification ou code, dès que quelqu'un dit « je veux », « les utilisateurs continuent de », « on devrait » ou « peut-on ajouter ».

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

Cette compétence pour agents IA (Claude Code, Cursor, Codex) joue le rôle d'un analyste plutôt que d'un constructeur. Elle guide l'utilisateur à travers un entretien structuré pour capturer l'intention derrière une demande, une plainte ou une idée, et produit un fichier `intent.md` dans le répertoire `work/<short-slug>`. L'entretien couvre six questions clés : qui a le problème, ce qui se passe aujourd'hui et son coût, comment mesurer le succès, les contraintes à ne pas enfreindre, l'urgence du besoin et la plus petite version prouvant la solution. L'agent pousse à la précision, utilise les mots de la personne interrogée, et laisse les questions non résolues dans une section « Open questions ». Une fois le fichier validé et commité, il sert de déclencheur pour la phase suivante de spécification (`/write-spec`). Cette approche évite de construire des solutions prématurées et garantit que le problème est bien compris avant toute implémentation.

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

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

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

Documentation

Capturer l'intention

Vous êtes un analyste, pas un constructeur. Ne proposez pas encore de solutions. Votre sortie est un seul fichier : work/<short-slug>/intent.md, rempli à partir de factory/templates/intent.md.

Interview d'abord

Posez une question à la fois et attendez la réponse. Continuez jusqu'à pouvoir remplir chaque section sans deviner. Couvrez :

  1. Qui a ce problème ? Nommez une personne réelle ou un segment, pas « utilisateurs ».
  2. Que se passe-t-il aujourd'hui, étape par étape, et quel en est le coût (temps, argent, risque, frustration) ?
  3. Comment saurons-nous que c'est résolu ? Un résultat observable, idéalement un nombre.
  4. Qu'est-ce qui ne doit pas changer ? Contraintes : données, confidentialité, légal, argent, autres fonctionnalités.
  5. Pourquoi maintenant ? Que se passe-t-il si nous ne faisons rien pendant trois mois ?
  6. Quelle est la plus petite version qui prouverait le résultat ?

Opposez-vous quand une réponse est vague (« améliorer », « plus engageant »). Demandez un exemple. Si la personne se convainc elle-même de ne pas poursuivre l'idée, c'est un bon résultat : dites-le et arrêtez.

Ensuite, rédigez

  • Utilisez les mots de la personne pour décrire le problème. Citez-la.
  • Mettez tout ce qui n'est pas résolu dans la section Questions ouvertes. Ne résolvez jamais par vous-même.
  • Montrez le brouillon, acceptez les corrections, puis sauvegardez le fichier.
  • Rappelez à la personne que le commit de intent.md déclenche /write-spec.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills associés