Referencia de comandos

Todos los verbos se despachan al motor mecánico, bash <skill-dir>/runner/flow.sh <command>. En Claude Code, Cursor y Antigravity escribes /flow …; en Codex CLI escribes $flow …. En Windows PowerShell, llama a <skill-dir>\runner\flow.cmd <command> en lugar de bash.

Verbos diarios

/flow              status — dónde estoy, qué bloquea
/flow next         comprobación de gate + desbloquear siguiente stage
/flow assess       evaluación brownfield
/flow card         crear una build card
/flow check C-001  validar card (terminado = prueba del mundo)
/flow auto         construcción autónoma (se detiene en clase de seguridad)
/flow doctor       comprobación del entorno

Estado y entrada

Comando	Qué hace
`/flow resume`	Resumen de historia de sesión de solo lectura para entrar a un proyecto a mitad de ciclo: última sesión (solo nombres de comandos, nunca argumentos crudos), card en vuelo más dwell, estado del gate, una línea `NEXT ->`. No toma candado. Ejecútalo primero al retomar un proyecto existente en frío.
`/flow` (status)	Dónde estoy, qué bloquea, una línea `NEXT ->` del mismo helper que `resume`, dwell del stage actual, lista de cards (resumen compacto más allá de diez cards), y un resumen de memoria de una línea.
`/flow recall`	Lee de vuelta la memoria durable — deuda abierta, retro reciente, alcance de la card anterior, fricción y backlog del harness, salud de la auditoría, playbooks — al inicio de un stage o card.
`/flow unlock`	Limpia el candado de concurrencia de este proyecto después de una sesión caída o abandonada.
`/flow doctor`	Autocomprobación del entorno en macOS, Linux y Windows: bash, python, grep, git, rutas de instalación.

Stages y planificación

Comando	Qué hace
`/flow next`	Comprueba el gate del stage actual; si pasa, desbloquea el siguiente (o empieza en el stage 00). El desafío semántico del stage recién pasado se aplica después del pase mecánico.
`/flow gate <stage> [--json]`	Escaneo mecánico de solo lectura de un stage (o `--card C-NNN` para una card): reporta hallazgos sin avanzar nada. `next`/`check` son dueños de la progresión. `--json` emite un envelope cerrado `gate.report`.
`/flow assess`	Brownfield: prepara y pone gates a una evaluación del estado actual en `flow/00-inspect.md` antes de planificar. Revisado por el operador.
`/flow skip <stage> --reason`	Avanza más allá de un gate que tiene una línea de deuda abierta que corresponde. Solo no-clase-de-seguridad; el stage 05 nunca puede saltarse.
`/flow clarify`	Lista las viñetas `- [ ]` restantes bajo `## Open decisions` en Scope, PRD y Contract. Asesor, no un gate de `next`.
`/flow constitution`	Comprueba las invariantes por proyecto del operador en `flow/constitution.md`. Asesor, no un gate de `next`.
`/flow converge`	Cards de resto solo-añadir que reconcilian el código presente contra el plan. Transaccional — todas las cards o ninguna; nunca edita una card existente; imprime `CONVERGED` y no escribe nada cuando no hay brecha.

Cards y construcción

Comando	Qué hace
`/flow card`	Crea la siguiente build card, solo después de que pasen todos los gates de planificación.
`/flow card start\|done C-NNN`	Marca una card en vuelo, o realiza un cambio a `done` propiedad del CLI con las mismas reglas que `check` — revierte si falla. Coexiste con la edición manual.
`/flow check C-NNN`	Valida una card: marcadores `[FILL]`, estado, secciones requeridas, evidencia de terminado.
`/flow ready`	Lista las cards todo construibles más una pista de seguridad en paralelo.
`/flow auto`	Preflight de una ejecución autónoma; `auto stop` lo limpia. Nivel-A auto-fusiona, Nivel-B recibe una reparación de un subagente fresco, Nivel-C clase de seguridad hace halt.
`/flow attest semantic\|live-verify\|status\|recover`	Acuña o inspecciona recibos ligados a huellas usados por el plano de control de ejecución atestada.
`/flow workspace add\|list\|enter\|remove\|check\|doctor\|port`	Aislamiento de worktrees multi-agente: un `git worktree` por agente para que varios agentes corran en paralelo sin que un cambio de rama voltee cada terminal. `workspace port` asigna un puerto determinista por card.
`/flow loop-prep <card>`	Fontanería para iteración contra un único objetivo numérico: un worktree aislado más un comando numérico de verificación derivado de los archivos permitidos de la card.
`/flow loop-log <card> --iterations N --start M --end K --outcome …`	Registra una ejecución de ciclo terminada en la telemetría de uso.

Modos y configuración

Comando	Qué hace
`/flow mode [teach\|work]`	Muestra o fija quién escribe los artefactos de gate. Por defecto `teach`.
`/flow project-type [web\|cli\|library\|skill]`	Muestra o fija el tipo de proyecto, que selecciona la regla de evidencia de terminado y la costura del contrato. Por defecto `web`.
`/flow debt add\|list`	Registra o lista skips de gate deliberados en `DEBT.md`. Las entradas de clase de seguridad son solo del operador.
`/flow rules [cursor\|windsurf\|roo\|cline\|aider\|openhands\|copilot\|list] [--write]`	Emite (o escribe) andamiaje de reglas de workspace para que los harnesses de terceros sigan la disciplina de flow. Asesor.

Comprobaciones de deriva

/flow contract, /flow tokens, /flow coherence y /flow consistency marcan cada uno un eje de deriva y nunca auto-arreglan. Juntos forman una retícula: versiones, URLs, tokens de diseño, y si los artefactos aún se trazan entre sí.

Comando	Eje	Qué reporta
`/flow coherence`	versiones	Deriva de versiones entre campos de versión declarados — el trozo barato documento-versus-código
`/flow contract`	URLs	Deriva entre base-URL del cliente y prefijo de ruta servida, la clase de doble-`/api` y prefijos mixtos que las herramientas de diff de esquema no ven (web)
`/flow tokens`	diseño	Tokens declarados en `DESIGN.md` contra el CSS realmente usado: tokens sin usar, desajustes de valores, variables huérfanas
`/flow consistency`	trazabilidad	Cada `FRn` del PRD reclamado por una card y servido por una interfaz del contrato, una métrica de éxito numérica, sin marcadores restantes

Ejecuta consistency y coherence después del gate del contrato y antes de cortar cards. Ejecuta contract y tokens mientras construyes las superficies que describen.

/flow design <file> es una comprobación mecánica relacionada sobre un único archivo de UI en lugar de un barrido de todo el proyecto.

Descripciones y tiempos: README.md

Capa durable y conocimiento

Comando	Qué hace
`/flow harness <args>`	Pasarela al CLI de la capa durable: intake, story, trace, decision, backlog, query, audit, propose, más init, tool, intervention, promote-suggest, rollup, usage, prune, graph, journal.
`/flow promote <file>`	Copia un playbook a la base de conocimiento entre proyectos en `~/.claude/flow/playbooks`.
`/flow usage [--global\|--prune]`	Acumula el log JSONL local de uso en analíticas de construcción: tiempo de ciclo, tasa de fallo de gates, dwell por stage y por card, desglose de comandos. Solo local.
`/flow retro`	Imprime las tres preguntas de retro. El operador escribe la línea, nunca el agente.

Subcomandos del harness

/flow harness <args> es una pasarela a la capa durable, un CLI Python y SQLite propiedad de flow que almacena lo que sobrevive entre sesiones.

Subcomando	Propósito
`intake`	Registra una petición entrante con un tipo, resumen y flags; los flags de riesgo como auth auto-escalan el carril
`story`	Rastrea una unidad de trabajo y su prueba. Complétala con `story complete --proof-source …`
`trace`	Registro con nivel escrito cuando una comprobación de card pasa
`decision`	Registra una decisión y luego cierra el ciclo con su resultado real
`backlog`	El backlog de mejora en el que `propose` escribe
`query`	Lee registros de vuelta
`audit`	Puntúa entropía y deriva en los registros acumulados
`propose`	Mina la fricción repetida y las intervenciones en ítems de backlog; determinista, se dispara con dos o más ocurrencias
`init`	Crea o actualiza la base de datos del harness
`tool`	Registro consciente-del-tipo de herramientas y capacidades entrantes
`intervention`	Registra una anulación humana, del revisor, de CI o del agente
`promote-suggest`	Redacta sugerencias de playbook desde fricción e intervenciones recurrentes
`rollup`	Ingiere sinks JSONL de uso en el almacén de uso (idempotente)
`usage`	Imprime analíticas de uso desde el almacén de uso
`prune`	Limita cada sink JSONL a sus últimas N líneas (seguro ante crashes)
`graph`	Ejecutor de grafo: registra y avanza entradas del journal

La mayoría de estos los escribe por ti el motor — avanzar un stage siembra un intake, una comprobación que pasa registra una traza — así que la superficie manual es mayormente lectura. La capa es opcional: sin python3 los gates siguen funcionando y solo este almacén se desactiva.

Esquema, flags y la tabla de autoridad en vivo: skills/flow/harness/README.md

Evaluación

Comando	Qué hace
`/flow eval [--stage 01\|02\|05\|card\|routing\|converge] [--fixture <id>] [--n 3] [--timeout <s>]`	Prueba conductual para el gate semántico: ¿el modelo realmente marca un fixture hueco-pero-mecánicamente-limpio? Opt-in y facturable; se salta limpiamente con cero llamadas si falta el CLI `claude`.
`/flow eval --report`	Offline, cero llamadas: el scorecard del último batch completo más deriva contra el batch anterior.
`/flow eval --replay`	Replay sin claves de fixtures almacenados — sin llamadas al modelo. Fixtures ausentes u obsoletos salen con 1. Los veredictos nunca cuentan hacia el suelo de eval.
`/flow eval --diff <old> <new>`	Clasificador offline de regresión de fixtures: compara dos batches contra la línea base.