Conserva el alcance, los límites de verificación y el progreso de las tareas largas de programación con IA entre sesiones.
English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Français · Deutsch · Português (Brasil)
## Qué puedes hacer con Dev Flow Dev Flow te ayuda a gestionar tareas largas de programación con IA en Codex, DeepSeek, Claude Code o ZCode. Guarda localmente los requisitos acordados, el alcance de archivos, el plan de verificación, el progreso y los resultados para que puedas continuar después de cerrar una sesión. - **Aclarar el alcance:** registra los archivos previstos y compara los cambios reales con el plan. - **Planificar las pruebas:** elige comprobaciones pertinentes y limita el esfuerzo de verificación. - **Retomar el trabajo:** continúa la misma tarea y el trabajo pendiente desde su directorio original. - **Consultar resultados:** revisa el progreso, las comprobaciones y los problemas que requieren atención. Resulta útil para trabajo de repositorio que abarca varias sesiones o necesita límites claros de archivos y pruebas. Para preguntas puntuales, explicaciones de código y pequeños cambios que no necesitan guardar el progreso, suele ser más sencillo usar Codex, DeepSeek, Claude Code o ZCode directamente. ## Inicio rápido > Instala Node.js `>=24` y el Host que vayas a utilizar. Consulta los requisitos de versión y las plataformas verificadas en la [matriz de soporte](docs/SUPPORT-MATRIX_en.md). ### 1. Instala Dev Flow La instalación pública siguiente corresponde a las integraciones publicadas de Codex y DeepSeek. Para Claude Code, sigue la [guía de instalación desde el código fuente](docs/CLAUDE_en.md); la CLI pública anterior no instala un Adapter disponible solo en el código fuente. ZCode también utiliza la [guía de instalación desde el código fuente](docs/ZCODE_en.md). Los paquetes locales están destinados a Windows x64 y macOS arm64; la validación de ZCode en un Mac real queda pendiente. ```sh npm install -g @imotong/dev-flow@latest dev-flow ``` Elige tu Host entre las opciones del instalador que estés utilizando. En Codex, revisa y autoriza el hook de Dev Flow en `/hooks`; en DeepSeek, reinicia el Profile seleccionado. En Claude Code, recarga los plugins o inicia una conversación nueva y revisa los permisos solicitados. En ZCode, instala y activa el plugin en Settings → Plugins y abre una conversación nueva para activar los hooks. Preparar el paquete local no confirma que ZCode lo haya cargado. ### 2. Inicia una tarea Tras completar la instalación correspondiente, envía uno de estos mensajes en la conversación del Host: **Codex** ```text $dev-flow-codex:dev-flow Añade un límite de frecuencia para los inicios de sesión fallidos. Modifica solo archivos de autenticación y ejecuta como máximo 4 comprobaciones dirigidas. ``` **DeepSeek Harness** ```text /dev-flow Añade un límite de frecuencia para los inicios de sesión fallidos. Modifica solo archivos de autenticación y ejecuta como máximo 4 comprobaciones dirigidas. ``` **Claude Code** ```text /dev-flow-claude:dev-flow Añade un límite de frecuencia para los inicios de sesión fallidos. Modifica solo archivos de autenticación y ejecuta como máximo 4 comprobaciones dirigidas. ``` **ZCode** Selecciona `dev-flow` en el menú `/` → Skills del cuadro de entrada y describe la tarea. ```text Usa Dev Flow para limitar los inicios de sesión fallidos. Modifica solo archivos de autenticación y ejecuta como máximo 4 comprobaciones dirigidas. ``` Envía estos mensajes en la conversación, no en una terminal. Describe el objetivo, los criterios de aceptación, el alcance de archivos y el límite de pruebas. La primera respuesta evalúa la solicitud y pregunta si quieres trabajar directamente o usar Dev Flow. Al elegir Dev Flow, se crea por defecto una nueva rama de tarea desde el HEAD actual en el directorio actual. Confirma la rama y si los cambios sin confirmar existentes forman parte de la tarea. Se conservan las dependencias, la configuración local, los archivos y el estado del índice; la sesión continúa si puede acceder a todos los directorios participantes. También puedes elegir explícitamente usar la rama actual o crear un worktree de Git dedicado. Para un worktree se seleccionan además una fuente local o remota y una rama inicial. Codex abre el nuevo directorio cuando el entorno lo permite; DeepSeek y Claude Code proporcionan el comando de reinicio correspondiente. Cada directorio admite una sola Task activa. También se observan las ediciones manuales o de otras herramientas, y cambiar de rama durante la tarea pausa el proceso. Los directorios y ramas locales se conservan al terminar; los cambios sin confirmar deben tenerse en cuenta al iniciar la siguiente tarea. Antes de implementar, revisa y comenta los requisitos, el diseño, las tareas, los archivos previstos y el plan de verificación. El desarrollo comienza tras tu aprobación explícita del plan completo. Los cambios de plan o la ampliación del alcance de archivos requieren una nueva aprobación. Elegir Dev Flow o un worktree no sustituye esa aprobación. ### 3. Retoma y consulta el progreso Después de reiniciar la sesión, vuelve al directorio original y solicita continuar la tarea. Dev Flow retoma el progreso guardado. Si ese directorio desapareció o fue reemplazado, la tarea se pausa hasta que lo restaures o abandones explícitamente la tarea. En DeepSeek Harness, incluye `/dev-flow` en el mensaje que solicita retomar la tarea. En Claude, vuelve al directorio y a la conversación originales e indica con `/dev-flow-claude:dev-flow` que deseas continuar la tarea guardada. En ZCode, abre el directorio original, selecciona la Skill Dev Flow y pide continuar la tarea guardada. Si se prepara otro directorio, sigue las instrucciones recibidas para abrir ese espacio de trabajo. Estos comandos usan el gestor global instalado. Para instalaciones desde el código fuente, utiliza la entrada correspondiente de la guía. ```bash # Consultar las integraciones instaladas dev-flow status --host all # Abrir la vista local de tareas dev-flow webui start ``` Para instalación no interactiva, Profiles de DSH personalizados, actualizaciones, reparación y eliminación, consulta la [referencia de comandos](docs/COMMANDS_en.md). ## Mascota de escritorio La mascota requiere un Adapter configurado y la aplicación de escritorio instalada. Instalar solo un Adapter no instala la aplicación de escritorio. La mascota muestra varias tareas en burbujas superpuestas y abre la WebUI de cada una. Prioriza las tareas bloqueadas y pasa automáticamente a otra tarea pendiente cuando termina la actual; también puedes fijar una tarea. Puedes personalizar su apariencia, controlar animaciones, cambiar su tamaño e iniciarla o detenerla por separado. ```bash dev-flow pet start dev-flow pet stop ``` Las aplicaciones de escritorio están destinadas a macOS arm64 y Windows 10/11 x64. Consulta la [guía de la mascota](docs/DESKTOP-PETS_en.md) para instalarla y manejarla, y la [matriz de soporte](docs/SUPPORT-MATRIX_en.md) para conocer la disponibilidad verificada. ## Límites de uso Un worktree dedicado separa los cambios de código. Los procesos, el acceso a la red, las credenciales y los servicios externos siguen compartidos con tu entorno. Completar una tarea no crea commits, envía cambios ni elimina su worktree automáticamente. Esas operaciones requieren tu autorización por separado. ## Documentación - **Uso:** [Codex](docs/CODEX_en.md) · [DeepSeek](docs/DEEPSEEK_en.md) · [Claude Code](docs/CLAUDE_en.md) · [ZCode](docs/ZCODE_en.md) · [Comandos](docs/COMMANDS_en.md) · [Control Center](docs/WEBUI_en.md) - **Proyecto:** [Definición del producto](docs/PRODUCT_en.md) · [Matriz de soporte](docs/SUPPORT-MATRIX_en.md) · [Seguridad](SECURITY.md) - **Desarrollo y contribuciones:** [Índice de documentación](MANIFEST_en.md) · [Guía de contribución](CONTRIBUTING.md) ## Licencia [Apache License 2.0](LICENSE)