Instalar y primera ejecución

Al final de este tutorial el skill flow está en disco en un home de agente, el agente se ha reiniciado, y el harness ha respondido con un estado, una acción siguiente o un resultado de gate.

Tiempo: un comando, un reinicio, luego una comprobación mecánica. El camino profundo opcional (versiones y una transcripción de gate-rechaza) toma unos diez minutos — eso es profundidad extra, no el listón.

Antes de empezar

Necesitas Node.js 22.14 o superior y un coding agent soportado (Claude Code, Codex CLI, Cursor, Antigravity, o un Agents home). El skill mismo también quiere bash en runtime — en Windows eso significa Git Bash. python3 es recomendado pero opcional: sin él los gates siguen funcionando y solo la capa durable SQLite se apaga.

Paso 1 — ejecuta el instalador

npx @manhquy/flow-skill@latest

Usa @latest para el skill v0.34.4 (instalador 0.7.11). Un npx @manhquy/flow-skill solo puede servirse desde la caché de npx y re-ejecutar en silencio una copia vieja.

Ocurren tres cosas:

1. npm descarga el instalador released actual.
2. El instalador muestra un multi-select interactivo de los agentes que detectó en esta máquina.
3. Copia el árbol del skill a cada home que seleccionaste, por ejemplo ~/.claude/skills/flow.

Selecciona el agente que realmente usas. Puedes re-ejecutar el comando después para añadir otro.

Paso 2 — reinicia el agente

El skill es un conjunto de archivos en disco; los agentes leen ese directorio al arrancar. Hasta que reinicies, el agente no sabe que el skill existe.

Agente	Después de reiniciar
Claude Code	escribe /flow
Codex CLI	reinicia una vez, luego escribe $flow
Cursor / Agents home	recarga la herramienta, abre el skill flow
Antigravity	reinicia el IDE o agy, luego /flow

Paso 3 — comprueba el entorno

bash ~/.claude/skills/flow/runner/flow.sh doctor

Quieres READY. doctor comprueba bash, python, grep y git en macOS, Linux y Windows. Un python3 ausente reporta la capa durable como desactivada — eso es un modo degradado, no un fallo. Cualquier otra cosa, ve a Si la instalación falla.

En Windows PowerShell, llama a runner\flow.cmd en lugar de bash. Un bash solo en PowerShell suele resolver a WSL, que no puede leer rutas C:/... y hace que una instalación que funciona parezca rota.

Confirmar los números de versión de instalador vs skill es profundidad opcional. Ver Dos números de versión.

Imprimir ambos números de versión

npx @manhquy/flow-skill@latest --help
# expect: flow-skill v0.7.11 (ships skill v0.34.4)

El instalador imprime su propia versión y la versión del skill que trae. Luego lee la versión del skill desde disco:

grep -E '^\s*version:' ~/.claude/skills/flow/SKILL.md | head -1

Esos dos números se mueven independientemente. No copies dígitos de esta página.

Paso 4 — di qué quieres construir

Nunca tienes que aprender los verbos. En una sesión de agente fresca, en un directorio de proyecto, escribe:

“Quiero construir una app de inventario para mi tienda.”

O escribe /flow (Codex: $flow).

El concierge ejecuta primero el comando de estado para obtener ground truth mecánico, hace una pregunta normal de consentimiento sobre quién debe redactar los artefactos, y propone exactamente una acción siguiente. Los verbos /flow escritos siempre ganan al enrutado del chat.

El enrutado es fiable en Claude. En Codex o Antigravity, trata el enrutado del chat como mejor esfuerzo y escribe el verbo. La advertencia completa está en Ciclo diario.

El éxito es cualquiera de: un estado, una acción siguiente o un resultado de gate. «El concierge dijo sí» no es el trofeo por sí solo.

Qué tienes ahora

• El skill instalado en al menos un home de agente.
• El agente reiniciado para que pueda ver el skill.
• Una respuesta del harness: estado, acción siguiente o un resultado de gate.

Siguiente

Recorre un proyecto real por cada gate de planificación en Recorre un proyecto completo, o lee El harness de dos capas para entender qué está juzgando tus archivos.

Ver un gate rechazar

Esto es profundidad opcional. Es la demo determinista de que la capa mecánica está viva. Descartar en un gate también es válido.

Transcripción de un archivo Idea vacío

Crea un directorio vacío y abre tu agente ahí. Luego pide el primer stage:

/flow next

El runner prepara flow/00-idea.md e inmediatamente comprueba su gate. Como aún no has escrito nada, se niega:

FAIL: gate for stage 00-idea is not clean.
  [x] unchecked gate boxes:
      L4:- [ ] The pitch below is 3 sentences, no more
  [x] unfilled [FILL] placeholders:
      L10:[FILL: sentence 1 — who has the problem]
Fix the above, then run '/flow next' again. (Kill at a gate is also valid.)

Esto es la instalación funcionando. La capa mecánica leyó el archivo, encontró casillas sin marcar y marcadores sin rellenar, y salió con código no-cero con números de línea. No los rellenó por ti, y no lo hará.