Communitygithub.com

jintomjose/mini-software-factory

Convierte un intent.md comprometido en spec.md (requisitos y diseño en un mismo artefacto), con preocupaciones de política y decisiones abiertas marcadas en línea. Úsalo después de capture-intent y antes del modo plan.

¿Qué es mini-software-factory?

Este skill transforma un archivo intent.md comprometido en un spec.md completo, unificando requisitos y diseño en un único artefacto. Es útil porque garantiza que las restricciones del código base se capturen antes de escribir la especificación, evitando el fallo más común: omitir limitaciones técnicas. Funciona leyendo intent.md, CLAUDE.md y las partes del código afectadas, luego genera historias de usuario priorizadas (P1, P2, P3), identificadores estables (FR-001, SC-001), y marca de forma explícita decisiones abiertas con [NEEDS CLARIFICATION] o restricciones de política con [POLICY]. Está diseñado para usarse después de capture-intent y antes del modo plan, con la capacidad de resolver todas las aclaraciones pendientes antes de guardar el spec.md final. Es compatible con cualquier agente o herramienta que lea y escriba archivos markdown en una estructura de proyecto estándar.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jintomjose/mini-software-factory/tree/HEAD/.claude/skills/write-spec
Ver original→Ver todas las habilidades

Preguntar en tu IA favorita

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

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentación

Escribir especificación

Entrada: work/<feature>/intent.md. Salida: work/<feature>/spec.md a partir de factory/templates/spec.md.

  1. Lee intent.md, CLAUDE.md y las partes del código base que el cambio tocará. Una especificación escrita sin leer el código ignora restricciones; ese es el error más común.
  2. Escribe historias de usuario en orden de prioridad (P1, P2, P3). Cada historia P1 debe ser desplegable y comprobable de forma independiente.
  3. Asigna a cada requisito funcional un ID estable (FR-001) y a cada criterio de éxito otro (SC-001). Las revisiones y pruebas se refieren a estos.
  4. Marca en línea, nunca resuelvas en silencio:
    • [NEEDS CLARIFICATION: ...] para cualquier decisión que el intent no resuelva
    • [POLICY: privacidad | seguridad | legal | dinero | marca] dondequiera que aplique una regla, junto con la regla
  5. Escribe la sección de diseño solo en la profundidad que el plan necesite: cambios de datos, interfaces, estados, casos de error.
  6. Enumera lo que explícitamente está fuera del alcance.
  7. Muestra la especificación, resuelve cada [NEEDS CLARIFICATION] con el humano, luego guarda. Confirmar spec.md es el disparador para el modo plan.

Skills relacionados

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community