# Instrucciones para el agente: Flow-Next: une especificación, implementación y revisión

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/gmickel/flow-next (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/flow-next-ralph

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: instala en Claude Code

Comprueba que Claude Code y Python ≥3.11 están disponibles, junto con las herramientas del proyecto. Prepara también `jq` y `gh` para las fases de revisión y PR. Dentro de la interfaz de plugins o la conversación correspondiente, sigue el bloque oficial:

```text
/plugin marketplace add https://github.com/gmickel/flow-next
/plugin install flow-next
/reload-plugins
/flow-next:setup
```

### Paso 2: configura la revisión

Revisa el fragmento de instrucciones que setup añade y el revisor elegido.

### Paso 3: prueba un cambio pequeño

Invoca `/flow-next:flow` con un error o requisito acotado. Revisa las etapas y sus entregables antes de pedir una PR.

## Comprobación

Comprueba que los criterios se relacionan con el cambio, que la prueba verifica el comportamiento y que las etapas muestran lo ejecutado y lo omitido. Contrasta los resultados con los comandos reales del proyecto.

## Si algo falla

Si una skill no aparece, consulta el bloque de instalación de tu arnés: Codex usa nombres distintos de Claude Code. Si falla una etapa, conserva el error y resuélvelo antes de activar el modo automático.

[Fuente del procedimiento](https://github.com/gmickel/flow-next).