Especificaciones
La pestaña Especificaciones contiene especificaciones de desarrollo — descripciones normalizadas y versionadas de un desarrollo con las que trabajan tanto el agente como las personas del equipo. Una especificación es la fuente de verdad compartida para una pieza de trabajo: qué se está construyendo, por qué y bajo qué reglas. Las especificaciones las produce el rol de Especificación en el Chat — consulta Roles de desarrollador.
Para qué sirve una especificación#
Una especificación convierte un requisito difuso en una descripción normalizada y versionada contra la que el agente puede implementar y que una persona puede revisar. Cada especificación es una familia con un spec_id estable que permanece igual en todas las versiones — así, a medida que la especificación evoluciona, su historial es un único hilo continuo, y los enlaces a ella nunca se rompen. Cuando le entregas al agente una especificación para implementar (incluso en Modo autónomo), trabaja a partir de esa definición estable y versionada, en lugar de un mensaje de chat puntual.
La lista de especificaciones#
El lado izquierdo enumera tus familias de especificaciones. Cada entrada muestra:
- El título de la especificación.
- Una insignia de estado.
- v{version} — la versión actual.
- {n} versions — cuántas versiones existen.
Cuando un proyecto aún no tiene especificaciones, la lista muestra:
Aún no hay especificaciones — usa el rol de Especificación en el Chat para crear una.
Elige una familia a la izquierda para abrirla.
La vista de familia#
Al abrir una familia se muestran tres subpestañas:
| Subpestaña | Qué muestra | Cuándo está disponible |
|---|---|---|
| Actual | La versión actual, renderizada desde Markdown | Siempre |
| Versiones (N) | Todas las versiones, con resúmenes de cambios por versión | Siempre |
| Comparar | Una diferencia lado a lado entre dos versiones | Solo con 2 o más versiones (deshabilitada en caso contrario) |
Actual#
La subpestaña Actual renderiza la última versión de la especificación como Markdown con formato. Los administradores obtienen controles para gestionar la especificación:
| Control | Qué hace |
|---|---|
| Editar | Abre la versión actual para editarla. |
| Guardar | Guarda tus cambios. |
| Cancelar | Descarta tus cambios y sale del modo de edición. |
| Renombrar familia | Cambia el título de la especificación. El spec_id permanece igual. |
| Eliminar | Elimina la familia completa y todas sus versiones. |
Eliminar borra la familia de especificaciones completa — todas las versiones, no solo la actual. No hay eliminación por versión; es todo o nada.
Versiones (N)#
La subpestaña Versiones muestra el historial completo:
- Un riel de versiones que enumera cada versión por etiqueta. Una versión que tiene un resumen de cambios se marca con un punto.
- Un cuadro "Cambios en v{v}" que describe qué cambió en la versión seleccionada.
- El contenido de la versión seleccionada.
Úsalo para leer cualquier versión anterior exactamente como era, y para ver la narrativa de cómo evolucionó la especificación.
Comparar#
La subpestaña Comparar muestra una diferencia entre dos versiones cualesquiera. Necesita al menos dos versiones para estar disponible.
| Control | Qué hace |
|---|---|
| Desde | Selecciona la versión base desde la que comparar. |
| Hasta | Selecciona la versión con la que comparar. |
| Vista de diferencias | Muestra las adiciones y eliminaciones con un margen + / −. |
| Cuadro "Qué cambió" | Un resumen de las diferencias entre las dos versiones seleccionadas. |
Cómo se crean las especificaciones#
Aquí no escribes especificaciones a mano desde cero — las generas con el rol de Especificación en el Chat. Describe el requisito al agente en ese rol y produce una especificación normalizada, que luego aparece como una familia en esta pestaña. Los administradores pueden refinarla después con Editar / Guardar, y cada cambio significativo se convierte en una nueva versión con su propio resumen de cambios.
Adónde ir después#
- Roles de desarrollador — incluido el rol de Especificación que produce las especificaciones.
- Chat — donde eliges un rol y creas una especificación.
- Modo autónomo — entrega al agente una especificación y déjalo trabajar sin supervisión.
- Metodología — las reglas y el conocimiento que el agente aplica al implementar una especificación.