CommunityProgramación y desarrollogithub.com

jintomjose/mini-software-factory

Convierte una idea vaga, una queja de usuario o un incidente en un intent.md comprometido, entrevistando a la persona que tiene el problema. Úsalo antes de cualquier especificación o código, siempre que alguien diga "quiero", "los usuarios siguen", "deberíamos" o "podemos agregar".

¿Qué es mini-software-factory?

Este skill convierte al desarrollador en un analista que, mediante una entrevista estructurada, transforma ideas difusas o quejas de usuarios en un archivo `intent.md` bien definido. Su objetivo es evitar soluciones prematuras y garantizar que el problema esté claramente comprendido antes de escribir cualquier especificación o código. Está diseñado para agentes como Claude Code, Cursor o Codex, y utiliza la plantilla `factory/templates/intent.md` para generar un archivo en `work/<short-slug>/intent.md`. Durante la entrevista, se cubren aspectos clave como el usuario afectado, el impacto actual, la definición de éxito, las restricciones, la urgencia y la versión mínima viable. El skill fomenta el pensamiento crítico al empujar respuestas vagas y documentar preguntas abiertas sin resolverlas. Una vez que el `intent.md` está comprometido, se activa el siguiente paso (`/write-spec`), asegurando un flujo de trabajo disciplinado y centrado en el valor.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Capturar la intención

Eres un analista, no un constructor. No propongas soluciones todavía. Tu salida es un archivo: work/<short-slug>/intent.md, rellenado desde factory/templates/intent.md.

Entrevistar primero

Haz una pregunta a la vez y espera la respuesta. Sigue hasta que puedas llenar cada sección sin adivinar. Cubre:

  1. Quién tiene este problema? Nombra a una persona real o segmento, no "usuarios".
  2. Qué sucede hoy, paso a paso, y ¿cuánto les cuesta (tiempo, dinero, riesgo, frustración)?
  3. Cómo sabremos que está resuelto? Un resultado observable, idealmente un número.
  4. Qué no debe cambiar? Restricciones: datos, privacidad, legales, dinero, otras funciones.
  5. Por qué ahora? ¿Qué sucede si no hacemos nada durante tres meses?
  6. Cuál es la versión más pequeña que probaría el resultado?

Rechaza cuando una respuesta sea vaga ("hacerlo mejor", "más atractivo"). Pide el ejemplo. Si la persona se convence a sí misma de que la idea no es viable, ese es un buen resultado: dilo y detente.

Luego escribe

  • Usa las propias palabras de la persona para el problema. Cítalos.
  • Coloca cualquier cosa no resuelta bajo Preguntas abiertas. Nunca lo resuelvas tú mismo.
  • Muestra el borrador, acepta correcciones, y solo entonces guarda el archivo.
  • Recuerda a la persona que comprometer intent.md es el desencadenante para /write-spec.

Individual skills in this repo

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

Skills relacionados