Glosario
| Término | Significado |
|---|---|
| Gate | Una checklist que debe satisfacerse con honestidad antes de que un stage o card avance. Solo se pasa cuando las capas mecánica y semántica están de acuerdo. |
| Capa mecánica | runner/flow.sh, un motor bash determinista que sale con 0 o 1. Ground truth. |
| Capa semántica | El modelo que lee SKILL.md, juzgando lo que un script no puede: investigación inventada, alcance con el nivel inflado, evidencia hueca. |
| Capa durable | El almacén Python y SQLite que guarda registros de intake, story, trace, decision y backlog entre sesiones. |
| Stage | Uno de los pasos de planificación con gates, 00-idea a 05-contract, cada uno produciendo un archivo en flow/. |
| Card | Una sesión de construcción acotada, cards/C-NNN.md, con archivos permitidos, verificación, prueba independiente y evidencia. |
| Contract | El stage 05, la costura entre productores y consumidores. Escrito antes del código, nunca saltable. |
| Evidencia de terminado | Prueba del mundo de que una card está terminada: una URL en vivo, una invocación real, una API importada, una ejecución real del skill. Nunca «tests pass». |
| Deuda | Un skip de gate deliberado y registrado en DEBT.md, con una exposición y una condición para cerrarlo. |
| Clase de seguridad | Auth, autorización, exposición admin, tenencia, pagos, migración de datos, eliminar validación. Detiene una ejecución autónoma; solo el operador. |
| Modo teach / work | Quién escribe los artefactos de planificación — tú, o el agente. Los gates atan idénticamente. |
| Tipo de proyecto | web, cli, library o skill. Selecciona la costura del contrato y la regla de evidencia de terminado. |
| Concierge | La puerta principal de chat que enruta el lenguaje natural a través del estado mecánico a exactamente una acción propuesta. |
| Comprobación de deriva | Una comprobación asesora que marca desacuerdo entre artefactos: coherence, contract, tokens, consistency. |
| Atestación | Un recibo ligado a huellas que prueba un sujeto específico revisado o verificado, consumido por ejecuciones autónomas. |
| Descartar | Abandonar en un gate. Un resultado válido y honrado. |
| Dos strikes | Una card bloqueada recibe una reparación por un subagente fresco antes de escalar. |
| Playbook | Conocimiento de stack pagado, leído antes de construir sobre ese stack y cosechado después. /flow promote lo comparte entre proyectos. |
Las definiciones canónicas viven con el skill:
skills/flow/SKILL.md