La spec que escribe el agente, el responsable hace seguimiento.
Quien programa con IA escribe la spec antes del código. En Tasskee se convierte en un documento vivo del proyecto: tu agente lo lee y lo actualiza por MCP mientras trabaja, y el estado, el progreso y las tareas aparecen al instante para el equipo.
La spec deja de ser un archivo que solo lee el agente
En el repositorio, la spec solo habla con quien programa. Aquí queda en la carpeta del proyecto, con número, estado y progreso, y el responsable ve lo que hizo el agente sin abrir el código.
Tu agente, por MCP
Claude Code, Cursor o cualquier cliente MCP crea la spec, lee y escribe sección por sección, marca los criterios de aceptación y vincula las tareas, con token propio.
Estado y progreso en vivo
Por hacer, En curso y Hecho, más el porcentaje que el agente actualiza con cada avance. Es el número que sigue el responsable.
De la spec a las tareas
Cada criterio de aceptación abierto puede convertirse en tarea del proyecto, y el "3/8 tareas" cuenta solo cuántas ya se han cerrado.
Permisos por proyecto
Cada perfil puede ver, editar, crear o eliminar specs proyecto a proyecto, y el agente respeta las mismas reglas de quien lo conectó.
El agente trabaja en la spec. Tú lo ves ocurrir.
Tasskee es un servidor MCP con herramientas propias para specs. El agente consulta solo la sección que necesita, actualiza lo que hizo y registra el progreso — sin copiar y pegar, y sin pisar a quien está editando el mismo texto.
- 1Conecta el agente Genera un token en Tasskee y pégalo en Claude Code, en Cursor o en tu cliente MCP.
- 2Pídelo en lenguaje natural "Implementa la spec 01 de la App Móvil". El agente lee la spec y pasa el estado a En curso.
- 3Haz seguimiento sin preguntar Los criterios marcados, el progreso y las tareas cambian en Tasskee mientras él programa, con historial de versiones.
Una carpeta por proyecto, con el avance de cada spec
El responsable abre la carpeta del proyecto y ve, en una lista, lo que está por hacer, lo que está en curso y lo que ya se ha entregado — con el progreso y las tareas de cada spec.
- Estado Por hacer, En curso y Hecho, con filtro
- Porcentaje de progreso informado por el agente
- Tareas cerradas sobre el total, contadas solas
- Sub-specs numeradas (01.1) bajo la spec madre
Quien abre la tarea encuentra la spec que la explica
La tarea gana la pestaña Specs, con las specs del mismo proyecto vinculadas, el estado y el progreso de cada una. Quien recoge la tarea entiende el porqué sin buscar.
- Spec y tarea solo se vinculan dentro del mismo proyecto
- Citar la tarea con # en el texto de la spec ya cuenta en el progreso
Esto vive junto con el resto de la operación
Tarea, cronograma, ticket, meta y conversación son la misma base de datos. Lo que cambia en un lugar aparece en el otro, sin exportar nada.
Cómo usar specs con un agente de IA en la práctica
Quien programa con un agente de IA sabe lo que pasa sin especificación: el agente hace lo que entendió, no lo que tú querías. La spec lo resuelve, y en Tasskee además deja que el gerente haga el seguimiento sin abrir el código. Mira el flujo real, del token al progreso.
Paso a paso
- Genera el token del MCP en Tasskee. Tiene vigencia y alcance, y puedes revocarlo cuando quieras. El agente ve solo lo que ve la persona que lo conectó.
- Pega el token en tu cliente. Funciona con cualquier cliente compatible con MCP, como Claude Code, Claude Desktop, Cursor y VS Code.
- Elige dónde vive la spec. Solo en Tasskee, solo en el repositorio (Tasskee guarda un espejo) o en los dos. En la primera conversación el agente pregunta el modo.
- Pídelo en lenguaje natural: "implementa la spec 01 de la App Móvil". El agente consulta el mapa de secciones, lee solo la que necesita y cambia el estado a En curso.
- Deja que marque los criterios y vincule las tareas. En cada avance actualiza la sección, vincula la tarea e informa el porcentaje.
- Haz el seguimiento desde la carpeta del proyecto. La lista muestra Por hacer, En curso y Hecho, el progreso y las tareas cerradas sobre el total.
Anatomía de una buena spec
El agente sigue lo que está escrito, así que la calidad de la spec define la calidad de la entrega. Una estructura que funciona:
- Problema: qué duele hoy, en dos o tres frases.
- Propuesta: qué se va a hacer.
- Fuera del alcance: qué no se va a hacer. Es la sección que más evita retrabajo.
- Decisiones: elecciones ya tomadas y el porqué.
- Criterios de aceptación: una lista de casillas verificables. "El webhook confirma el pago" es verificable. "Va rápido" no lo es.
Cada criterio abierto puede convertirse en una tarea del proyecto, y el contador de tareas cerradas se actualiza solo. Spec y tarea solo se vinculan dentro del mismo proyecto.
Ejemplos por tipo de equipo
Software house en Florianópolis
La gerente de proyectos crea la spec de un módulo de cobro con ocho criterios. El desarrollador le pide al agente que la implemente. En la reunión del lunes, la gerente abre la carpeta, ve la spec al 65 % y tres tareas cerradas, y no necesita preguntarle a nadie. Para sprints, mira cómo usar sprints.
Startup de aplicaciones en São Paulo
Dos personas y un agente. La spec vive en el repositorio y Tasskee guarda el espejo, para que el socio de negocio haga el seguimiento sin entrar en Git. Las sub-specs numeradas, como 01.1, separan las entregas menores bajo la spec madre.
Equipo de TI de una industria en Joinville
El analista usa el agente para automatizar un informe interno. El permiso por proyecto garantiza que el agente solo ve lo que ve el analista. Si alguien abre la misma spec en el editor, la escritura del agente se rechaza, para que nadie sobrescriba a nadie.
Buenas prácticas
- Una spec, un resultado entregable. Una spec que intenta cubrirlo todo no tiene un progreso que se pueda seguir.
- Criterios verificables. Si no puedes marcar la casilla con una prueba o una comprobación, reescríbelo.
- Cita la tarea con # en el texto. Eso ya cuenta en el progreso.
- Deja que el agente escriba por sección. Cambiar un criterio no toca el resto del texto.
- El gerente lee el progreso, no el código. Acordadlo al principio.
Errores comunes
| Error | Consecuencia |
|---|---|
| Spec sin "fuera del alcance" | El agente hace más de lo que debía |
| Criterio vago | El progreso no significa nada |
| Token compartido entre personas | Se pierde la trazabilidad de quién lo pidió |
| No revisar nunca lo que marcó el agente | "Hecho" sin estar listo |
Specs a partir del plan Start; el MCP en el Pro
Las specs existen a partir del plan Start. El agente conectado por MCP forma parte del Pro y del Max, y en la prueba de 15 días todo viene habilitado. La IA usa tu clave o suscripción, sin créditos de Tasskee. Para entender el porqué del diseño, lee MCP: la IA que trabaja en el proyecto.
Las specs son hermanas de los documentos y conversan con el asistente de IA. Para el concepto de backlog y sprint que alimenta todo esto, está la plantilla de backlog y sprint.
Preguntas sobre specs
¿Qué es una spec?
¿Qué agentes funcionan?
¿Y la spec que ya tengo en mi repositorio?
¿El agente puede sobrescribir lo que estoy editando?
¿Quién ve las specs?
Conecta tu agente y mira avanzar la spec
Crea la cuenta gratis, abre la carpeta de specs del proyecto y genera el token del MCP. En cinco minutos el agente ya está actualizando el progreso.