Solución de problemas
← Principios de diseño · English
FAQ
¿Dónde está el paso a paso de mi primera tarea?
Primeros pasos → Tu primer flujo. Guía de qué leer por fase: Cómo funciona → Qué revisar.
¿SpecFlow funciona sin .agents-docs/?
Sí. Los agentes tienen menos contexto y pueden preguntar más. Completa docs antes de tareas serias.
¿Puedo editar .agents/rules/?
No recomendado. sync sobrescribe cambios. Reglas específicas del proyecto van en .agents-docs/.
¿Commiteo .agents-state/?
No. Añádelo a .gitignore. Contiene estado runtime por tarea.
¿En qué idioma hablan los agentes?
Las reglas están en inglés. Puedes chatear en español o inglés. Las frases de activación funcionan en ambos.
Problemas comunes
status dice outdated
Hay una versión más nueva en npm.
npx @ceatoleii/specflow syncsync bloqueado — tarea de flujo activa
Sync no corre con tarea activa (salvo --yes):
specflow sync --yesO desactiva el flujo: flow off / modo directo.
status sale con código 1
SpecFlow no está instalado en ese directorio. Ejecuta init primero.
El agente ignora el flujo / fase incorrecta
Comprueba:
- Existe
.agents-state/.flow-enabled .agents-state/current/phase.mdtiene fase válida- Tu adapter IDE está instalado (
specflow tools list) - No borraste el archivo adapter manualmente
Reset: flow off, luego nueva tarea.
Implementación empezó sin /approve
El SDD debe esperar aprobación. Si hubo cambios no deseados, flow off, revierte y reinicia la tarea.
La revisión falla verificación
Revisa comandos en .agents-docs/verification.md. Corrige tests/lint y continúa en implementing o reinicia review.
init se cancela al instante
El asistente requiere terminal interactiva. Ejecuta en TTY real, no en CI no interactivo.
Linear MCP
| Problema | Solución |
|---|---|
| Linear no se actualiza | Checklist — plugin + MCP en Cursor |
specflow linear setup → NO_TTY | Terminal real, no CI |
| Estado incorrecto | specflow linear setup con nombres exactos del team |
| Tablero sin cambios | specflow linear setup --enable |
| Ignora el issue | nueva tarea desde TEAM-123 o URL completa |
La autenticación con Linear es solo en Cursor.