Spec Kit escribe los documentos.DotMD es donde los revisas.

Qué es GitHub Spec Kit

Spec Kit es el kit de herramientas de código abierto de GitHub para el desarrollo guiado por specs. No sustituye a tu agente. Añade una herramienta de línea de comandos, specify, que prepara tu proyecto, y un conjunto de comandos que ejecutas en el chat de tu agente. El agente escribe; Spec Kit le da los pasos y la estructura.

Es compatible con muchos agentes, entre ellos Claude Code, Codex CLI y Cursor. La lista completa está en la página de integraciones de Spec Kit.

Instalar e inicializar

Necesitas Python 3.11 o posterior y uv. Después:

uv tool install specify-cli
specify init my-project --integration claude

La opción --integration recibe la clave de tu agente: claude para Claude Code, codex para Codex CLI, cursor-agent para Cursor. La página de Spec Kit lista la clave de cada otro agente.

Los comandos, en orden

Los escribes en el chat del agente, no en la terminal:

1. /speckit-constitution
2. /speckit-specify: escribe spec.md.
3. /speckit-plan: escribe plan.md.
4. /speckit-tasks: escribe tasks.md.
5. /speckit-implement: construye a partir de las tareas.
6. /speckit-converge

La escritura de un comando varía según el agente: algunos usan /speckit.specify, otros un guion o un $. Spec Kit explica las formas de cada agente en sus notas sobre la invocación de comandos.

Revisa cada paso en DotMD

Spec Kit te pide revisar cada resultado antes de continuar. DotMD lo convierte en una revisión de verdad en lugar de un vistazo en la terminal.

1. Abre el proyecto

   Pulsa ⌘O y elige la carpeta del proyecto. Los archivos que escribe Spec Kit aparecen en la barra lateral a medida que se crean, con formato de títulos, listas y tablas.

2. Comenta la línea exacta

   Lee spec.md, selecciona un requisito erróneo o vago y pulsa ⌥⌘M. Escribe qué cambiar. Los comentarios los guarda DotMD, no el archivo.

3. Haz que el agente los corrija

   Dile al agente: «Revisa mis comentarios en DotMD.» Los lee por MCP y edita el archivo. Cada corrección aparece junto a su comentario, el texto antiguo en rojo y el nuevo en verde. Acepta o reabre cada una.

4. Solo entonces ejecuta el siguiente comando

   Cuando la spec esté bien, ejecuta /speckit-plan y repite con el plan y las tareas. Un error detectado en la spec cuesta un comentario; detectado en el código, cuesta rehacer trabajo.

Revisar tasks.md

La lista de tareas es una checklist en Markdown, y DotMD muestra las listas de tareas con sus casillas, así que ves de un vistazo qué está hecho y qué falta. Antes de ejecutar /speckit-implement, lee las tareas como las leerá el agente: en orden, cada una pequeña, ninguna ausente. Si ejecutaste el paso de análisis de Spec Kit, trata sus hallazgos igual: ábrelos en DotMD y comenta los que no compartas.

Conectar el agente con DotMD lleva una línea; las guías de Claude Code, Codex y Cursor la muestran.

Por qué revisar cada archivo

Spec Kit es rápido: un comando y aparece un documento entero. Esa velocidad es el riesgo. Si la spec tiene un requisito erróneo y ejecutas el siguiente comando sin leerla, el plan y las tareas se construyen sobre él, y también el código. Leer spec.md con atención una vez es la comprobación más barata de todo el proceso.

Preguntas sobre Spec Kit

Más preguntas