flow

PRUEBAS, NO SENSACIONES.

Lo hueco no avanza.

Un harness con gates alrededor del coding agent que ya usas. Flow es dueño de los gates y la evidencia, nunca del runtime. Descartar una idea débil en un gate es un resultado válido.

El gate solo se abre cuando ambos están de acuerdo.

Instalar y primera ejecuciónLeer la documentación
npx @manhquy/flow-skill@latestInstalar y primera ejecución

FUNCIONA CON TUS CODING AGENTS

Claude CodeCodex CLIGemini CLICursorAiderClineContinueZed

Seis gates antes de construir

Cada stage escribe un archivo real en tu repo. /flow next no desbloqueará el siguiente hasta que el runner y el skill estén de acuerdo. Esos archivos existen después de cruzar los gates, no después de instalar.

  1. FAIL · KILLED AT GATE

    Idea

    flow/00-idea.md

    Descarta las malas ideas antes de que exista el código.

    flow/00-idea.mdHALT
    # Problem statement
    [FILL: describe user problem]
    # Proposed solution
    <empty>
    exit: 1 · unresolved [FILL] token
    FAIL · KILLED AT GATE

    Lo que no pasará

    Vacío, un [FILL] sin rellenar, o «tests pass» ofrecido como terminado. Una idea débil se descarta en el gate.

    • Un archivo vacío.
    • Un [FILL] sin rellenar en el archivo.
    • «Tests pass» ofrecido como terminado.

    $/flow nextrefusing: flow/00-idea.md is empty (line 1)descartar es un resultado válido.

  2. EVIDENCE · PRIMARY SOURCES

    Research

    flow/01-research.md

    Cita fuentes reales o detente aquí.

    flow/01-research.md3/3 CITED
    ## Primary sources
    • [RFC-9110] §4.2 Idempotent methods
    • github.com/owner/repo#412 (repro)
    ## Competitive diff & failure modes
    urls verified · ground truth locked
    02EVIDENCE · PRIMARY SOURCES

    Ground truth antes que arquitectura

    Diferencias con competidores, citas de documentación verificada y modos de fallo reales registrados en archivos del repo.

    $/flow check 01-research3 primary sources cited (verified URLs)competitive diff & failure modes locked

  3. PERIMETER · NON-GOALS

    Scope

    flow/02-scope.md

    Dibuja el límite. Descarta el resto.

    flow/02-scope.mdFROZEN
    IN-SCOPE S-01 CLI harness gate loop
    IN-SCOPE S-02 Receipt schema validator
    NON-GOAL Telemetry / analytics tracking
    NON-GOAL Custom cloud daemon runtime
    2 deliverable slices · perimeter frozen
    03PERIMETER · NON-GOALS

    Non-goals explícitos congelados

    Entregas acotadas. El scope creep se detecta antes de generar cualquier código.

    $/flow check 02-scope3 deliverable slices lockednon-goals explicitly frozen (scope creep blocked)

  4. CONTRACT · ACCEPTANCE

    PRD

    flow/03-prd.md

    Define la prueba antes de escribir código.

    flow/03-prd.mdCRITERIA
    INV-01: exit 1 on empty spec file
    INV-02: refusal line emitted to stderr
    INV-03: receipt JSON conforms to schema
    INV-04: degraded mode creates debt entry
    4 observable invariants · 0 prose fluff
    04CONTRACT · ACCEPTANCE

    Solo criterios observables

    Historias de usuario con invariantes comprobables. El agente no puede redefinir el éxito a mitad de camino.

    $/flow check 03-prdobservable acceptance criteria specifiederror states & degraded paths defined

  5. DECISION · TRADE-OFFS

    ADR

    flow/04-adr.md

    Registra el compromiso antes de hacer commit.

    flow/04-adr.mdACCEPTED
    Status: Accepted (2026-10-11)
    Context: File state vs SQLite daemon
    Decision: Git-tracked Markdown files
    Consequence: Portable; zero background server
    reversibility mapped · trade-off locked
    05DECISION · TRADE-OFFS

    Registros de decisiones de arquitectura

    Contexto, decisión y consecuencias registrados antes de empezar la implementación.

    $/flow check 04-adrcontext, decision, consequences documentedreversibility & negative test cases mapped

  6. PASS · READY

    Contract

    flow/05-contract.md

    Ambas partes están de acuerdo o nada avanza.

    flow/05-contract.mdUNLOCKED
    [✓] human-signoff: approved by @dev
    [✓] harness-attest: sha256:7f3a..9e1b
    [✓] doctor-check: READY (skills verified)
    [✓] dual-agreement: UNLOCKED -> advance
    signed contract · gate cleared for build
    PASS · READY

    Después de instalar

    El skill está en disco. Escribe /flow (Codex: $flow). flow doctor imprime READY. /flow next en un archivo de idea vacío se niega e indica números de línea.

    • Los archivos del skill quedan en el home del agente.
    • Escribe /flow (Codex: $flow).
    • doctor puede imprimir READY.
    • /flow next en un archivo de idea vacío se niega e indica números de línea.

    $flow doctordoctor: READY (skills/flow/SKILL.md verified)El gate solo se abre cuando ambos están de acuerdo.

Luego /flow card. Terminado significa prueba en el mundo: una URL desplegada, un CLI que se instala y ejecuta, una API pública o una ejecución real del skill.

Pruebas con fuentes

Cada número se lee del repo en el momento de la compilación o se cuenta de la fuente indicada. Cada número incluye su fuente.

  • 0.34.4versión del skillskills/flow/SKILL.md · leído en compilación
  • 0.7.11instalador npmnpm-wrapper/package.json · leído en compilación
  • 72suites de prueba en el registrotests/manifest.txt
  • 6gates antes de construirskills/flow/references/stage-state-machine.md

Mira una ejecución en 85 segundos

85 segundos

Una idea débil muere en el gate 01; una con fuentes cruza los seis gates y obtiene un recibo de aprobación.

Instalar y primera ejecuciónLeer la documentación

No es un agente de código IA. Es un harness alrededor de uno.

flow no escribe tu código. El agente sigue escribiendo; el harness decide si ese trabajo puede avanzar.

Instalar y primera ejecuciónLeer la documentación