EVALÚA Y CONSERVA Ver versiones ↗

Dale memoria
y orden a tu
agente de IA.

Convierte una carpeta en un espacio que recuerda el contexto, organiza tus tareas y conserva los avances de tu trabajo.

Tú hablas en tus palabras. Tu agente se encarga del proceso.

Nuevo en v1.5.0: siete escenarios, contrato fijado y evidencia comprobable
UN ESPACIO QUE CONECTA TODO FIG. 01
TÚ PIDES

“Ordena mis notas
y recuerda los acuerdos.”

AGENTS.mdReglas claras para tu agente
TU ESPACIO
workspace/
bandeja ideas que llegan
documentos trabajo en curso
datos cifras con contexto
entregables listo para compartir
knowledge/El contexto se queda.

Decisiones · preferencias · acuerdos

Punto de guardadoUna versión a la que volver
Una carpeta real. Un contexto que puedes leer.
CON TU AGENTE FAVORITO

Codex · Claude Code · Cursor · OpenCode · Antigravity

Archivos + terminal
01 / LA IDEA

Tu agente pone la inteligencia.
Tu carpeta, la continuidad.

El template reúne tus archivos, una memoria legible y procedimientos de trabajo. Lo abres con un asistente que pueda leer archivos y usar la terminal, y empiezas a conversar.

Tú decides

Hablas con tus palabras.

Tu agente actúa

Lee las reglas y usa las herramientas.

El repo conserva

Archivos, contexto e historial.

El template es la base de trabajo. Necesitas abrirlo con un agente de IA; la web es una guía de uso.

02 / DEL PEDIDO AL RESULTADO

Menos contexto
repetido.
Más trabajo
que avanza.

Explora tres situaciones cotidianas y ve qué parte del espacio entra en acción.

UNA CONVERSACIÓN, CON CONTEXTO
TÚ

Revisa las notas de mi bandeja, ordénalas y guarda los acuerdos importantes.

TU AGENTE PODRÍA
  1. Leer tus notas

    Consulta workspace/bandeja/ y las reglas del espacio.

  2. Preparar un resumen

    Organiza el contenido en workspace/documentos/.

  3. Conservar los acuerdos

    Registra las decisiones duraderas en knowledge/.

RESULTADO ILUSTRATIVONotas organizadas. Acuerdos localizables.
03 / NUEVO EN v1.1.0

Lo que falta, claro.
Lo que avanzó, guardado.

Convierte un pedido en una tarea con objetivo, criterios y un historial que puedes retomar. Explora los cuatro estados de una misma propuesta.

PRIMERO, DEFINE EL DESTINO

Acuerda qué significa terminar.

El agente crea una tarea en Markdown con un objetivo y criterios concretos. Así sabes qué falta antes de empezar.

PÍDESELO A TU AGENTE

Crea una tarea para revisar la propuesta antes de enviarla. Los criterios son comprobar las cifras y confirmar los acuerdos con el cliente.

EJEMPLO DE TAREAPendiente

Revisar la propuesta

Objetivo: preparar el envío al cliente.

  • Comprobar las cifrasPendiente de verificar
  • Confirmar los acuerdosPendiente de verificar

0 de 2 criterios verificados. Todavía no se puede cerrar.

Ejemplo interactivo: no crea tareas ni modifica archivos. El agente o el usuario comprueba la evidencia; el validador exige su presencia y formato.

UNA TAREA, VARIOS AVANCES

Cada punto cuenta una parte.

Relaciona una tarea con varios puntos de guardado, o varias tareas con un mismo punto. Su historial reúne los cambios y los avances vinculados, incluso si se hicieron en otros documentos.

Guardar conserva el avance. Terminar requiere verificar los criterios y registrar el resultado.

  1. PUNTO 01 · EN CURSOCifras revisadas

    La tarea conserva la primera evidencia.

  2. PUNTO 02 · EN CURSOPropuesta actualizada

    Un cambio en otro documento también puede vincularse a la tarea.

  3. PUNTO 03 · TERMINADARevisión completa guardada

    Después de verificar y terminar la tarea, se guarda su estado final.

¿Prefieres comandos? Mira el mismo flujo con detalle técnico

Desde tu copia del template, crea la tarea y sustituye T-123456789abc por el ID devuelto. Registra únicamente evidencia que hayas comprobado. En Windows, usa Git Bash.

sh .agents/scripts/tasks.sh create "Revisar la propuesta" "Preparar el envío al cliente" "Comprobar las cifras" "Confirmar los acuerdos"
# Sustituye el ID de ejemplo en los siguientes comandos.
sh .agents/scripts/tasks.sh status T-123456789abc "en curso"
sh .agents/scripts/tasks.sh verify T-123456789abc 1 "Totales contrastados con el presupuesto aprobado"
sh .agents/scripts/tasks.sh checkpoint T-123456789abc "Guardar revisión de cifras"
sh .agents/scripts/tasks.sh status T-123456789abc bloqueada "Falta confirmación del cliente"
sh .agents/scripts/tasks.sh status T-123456789abc "en curso"
sh .agents/scripts/tasks.sh verify T-123456789abc 2 "Condiciones contrastadas con el acta confirmada por el cliente"
sh .agents/scripts/tasks.sh status T-123456789abc terminada "Propuesta revisada y lista para enviar"
sh .agents/scripts/tasks.sh checkpoint T-123456789abc "Guardar cierre de la revisión"
sh .agents/scripts/tasks.sh history T-123456789abc

Las tareas se guardan en workspace/documentos/tareas/. Los vínculos usan metadatos Task-ID. Para reabrir una tarea terminada, indica un motivo; si retiras la verificación de un criterio, debes comprobarlo de nuevo antes de cerrar.

Consultar la guía completa del gestor ↗
04 / NUEVO EN v1.2.0 · PILOTO ADD

Lo que acuerdas.
Lo que puedes comprobar.

ADD es desarrollo guiado por artefactos: una referencia concreta antes de trabajar y archivos de evidencia al entregar. Puedes activarlo en cada tarea que lo necesite.

UN EJEMPLO: REVISAR UNA PROPUESTAAcordar → comprobar → guardar
  1. 01 / ANTES DE TRABAJAR

    Referencia acordada

    Una muestra o un documento fija el resultado esperado y deja claro de dónde sale el acuerdo.

    LO QUE ESPERAMOSPropuesta lista para enviar
    • Cifras iguales al presupuesto.
    • Condiciones iguales al acta confirmada.
    workspace/documentos/referencia.md

    Acuerdo: cifras y condiciones definidas en el pedido del usuario.

    Punto A · Referencia guardada
  2. 02 / DESPUÉS DE COMPROBAR

    Evidencias de entrega

    Cada criterio tiene un archivo con lo revisado y el resultado observado.

    ✓ CRITERIO 1 · CIFRASworkspace/entregables/cifras.md

    Totales contrastados: 125 en ambos documentos. Diferencia: 0.

    ✓ CRITERIO 2 · ACUERDOSworkspace/entregables/acuerdos.md

    Condiciones contrastadas con el acta confirmada: coinciden.

    Punto B · Informes guardados
  3. 03 / AL TERMINAR

    Cierre con resultado

    La tarea reúne la referencia, la evidencia por criterio y sus puntos de guardado.

    Terminada2 de 2 criterios verificados

    Cifras comprobadas con informe.
    Acuerdos comprobados con informe.

    ResultadoPropuesta revisada y lista para enviar.

    Solo se cierra con todos los criterios verificados y un resultado escrito.

    Punto C · Cierre guardado

Esquema ilustrativo: tu agente usa los archivos y puntos reales de tu copia. El validador comprueba que los archivos guardados existan y tengan contenido; el agente o la persona responsable revisa que demuestren lo acordado.

UN HISTORIAL QUE PUEDES RECUPERAR

La referencia y la prueba
conservan su versión.

Los puntos A, B y C representan momentos distintos. El historial de la tarea incluye la referencia y los informes, aunque se hayan guardado sin modificar la tarea.

Si luego cambias los archivos, puedes consultar la versión guardada que se usó al acordar o entregar.

  1. PUNTO A · REFERENCIAGuardar antes de acordar

    Primero se guarda el archivo; después se vincula su punto a la referencia acordada. El acuerdo se guarda antes de ejecutar.

  2. PUNTO B · ENTREGAComprobar y guardar los informes

    El agente revisa el resultado, guarda las evidencias y vincula un archivo y su punto a cada criterio. La entrega se guarda en el punto de la referencia o en uno posterior de su historial.

  3. PUNTO C · CIERRETerminar y guardar la tarea

    Con todo verificado, se escribe el resultado, se termina la tarea y se guarda el cierre. Guardar un avance por sí solo no termina la tarea.

Si cambia el acuerdo, se revisa de nuevo. El gestor retira las verificaciones y entregas anteriores. Para modificar una tarea terminada, primero hay que reabrirla con un motivo.

El gestor sigue siendo el mismo. Los cuatro estados, las tareas anteriores y los vínculos a puntos de guardado se mantienen, sin paquetes adicionales.

PÍDESELO A TU AGENTE / REFERENCIA

Empieza con algo concreto.

Usa el piloto ADD para revisar mi propuesta. Ayúdame a definir una referencia concreta con el resultado esperado y los criterios de aceptación. Guarda el archivo, registra qué acordamos y de dónde surge el acuerdo, y vincúlalo a su punto de guardado antes de empezar.

PÍDESELO A TU AGENTE / ENTREGA

Termina mostrando la prueba.

Comprueba cada criterio de la tarea contra la referencia acordada. Guarda los informes con lo observado y vincula cada evidencia a su criterio y a su punto de guardado. Muéstrame la referencia y las evidencias. Termina solo cuando todo esté verificado, escribe el resultado y guarda el cierre.

¿Prefieres comandos? Explora el flujo ADD

Desde la raíz de tu copia, con Git Bash en Windows. Prepara workspace/documentos/referencia.md antes de acordar y escribe los informes reales tras comprobar la entrega. Sustituye T-123456789abc por el ID devuelto al crear la tarea. Los comentarios indican cuándo preparar los archivos antes de continuar.

sh .agents/scripts/tasks.sh create "Revisar la propuesta" "Preparar el envío al cliente" "Comprobar las cifras" "Confirmar los acuerdos"
# Sustituye el ID de ejemplo. Prepara referencia.md antes de seguir.
sh .agents/scripts/tasks.sh checkpoint T-123456789abc "Guardar la referencia inicial"
sh .agents/scripts/tasks.sh agree T-123456789abc workspace/documentos/referencia.md HEAD "Cifras y condiciones definidas en el pedido del usuario"
sh .agents/scripts/tasks.sh checkpoint T-123456789abc "Guardar el acuerdo antes de ejecutar"
sh .agents/scripts/tasks.sh status T-123456789abc "en curso"
# Revisa la propuesta y escribe cifras.md y acuerdos.md en workspace/entregables/.
sh .agents/scripts/tasks.sh checkpoint T-123456789abc "Guardar la entrega y los informes comprobados"
sh .agents/scripts/tasks.sh deliver T-123456789abc 1 workspace/entregables/cifras.md HEAD "Totales contrastados: diferencia cero"
sh .agents/scripts/tasks.sh deliver T-123456789abc 2 workspace/entregables/acuerdos.md HEAD "Condiciones contrastadas con el acta confirmada"
sh .agents/scripts/tasks.sh status T-123456789abc terminada "Propuesta revisada y lista para enviar"
sh .agents/scripts/tasks.sh checkpoint T-123456789abc "Guardar el cierre y sus evidencias"
sh .agents/scripts/tasks.sh history T-123456789abc

El agente registra cada archivo con un punto de guardado inmutable: HEAD se convierte en la referencia completa del último punto. Una entrega requiere un archivo regular no vacío en ese punto; un texto suelto con verify no sustituye la evidencia de una tarea ADD.

05 / NUEVO EN v1.3.0

Mira qué se intentó.
Comprueba qué quedó.

Un registro para entender cada ejecución y tres escenarios para evaluar a tu agente. Los acuerdos, las evidencias y los avances siguen en archivos que puedes revisar.

01 / EL REGISTRO DE INTENTOS

Una tarea puede necesitar varios intentos.

Cada uno guarda quién actuó, qué quiso hacer, qué herramienta indicó y qué pudo comprobar. Explora tres desenlaces posibles de una revisión de cifras.

SE PUDO COMPROBAR

El resultado tiene respaldo.

El agente encontró la fuente, contrastó las cifras y escribió lo observado. El informe permite revisar la comprobación.

La tarea sigue en curso. Este éxito no verifica criterios ni cierra la tarea automáticamente. Las entregas ADD y el cierre conservan sus reglas.

INTENTO I-000001 · EJEMPLOexito

Contrastar las cifras

Agente
Tu asistente
Herramienta
Lector de archivos y calculadora
Inicio → fin
10:00 → 10:04 UTC
EVIDENCIA DEL INTENTOworkspace/entregables/revision-cifras.md

3 unidades × 25 = 75. Total de la propuesta: 75. Diferencia: 0.

Punto 3 · Informe comprobado ↘

Tres alternativas ilustrativas del mismo intento: esta página no ejecuta un agente ni modifica archivos. El nombre de la herramienta es un registro del agente, no una captura automática de su actividad.

CUATRO MOMENTOS RECUPERABLES

El informe conserva
su contexto original.

El punto de la evidencia contiene el informe y el mismo intento todavía abierto. Después se registra y guarda el desenlace. Cambiar un archivo más tarde no sustituye la prueba histórica.

Si cambia el acuerdo ADD, los intentos anteriores conservan su contexto original. Un intento abierto impide terminar la tarea.

Las tareas mantienen sus cuatro estados ↗
  1. Contexto guardado

    Objetivo, criterios y acuerdo antes de iniciar el intento.

  2. Inicio guardado

    Agente, acción, herramienta e inicio. El intento queda abierto antes de trabajar.

  3. Informe guardado

    Evidencia de éxito, fallo o interrupción junto al registro original abierto. Este es el punto que se vincula al finalizar.

  4. Desenlace guardado

    Fecha de fin, observación y vínculo al informe. Otro intento conserva los registros anteriores.

02 / LAS EVALUACIONES DEL COMPORTAMIENTO

Tres situaciones para ponerlo a prueba.

Prepara una copia con datos ficticios, entrega el pedido al agente que elijas y comprueba sus resultados desde el evaluador original. La copia no lleva tus documentos, memoria ni remotos.

Referencia acordada

¿Respeta los datos y el formato pedidos?

3 unidades × 25 = 75Cliente, unidades y total en el orden acordado.

Se compruebaLa versión entregada, el criterio verificado, el cierre y un intento exitoso finalizado.

referencia

Evidencia insuficiente

¿Detecta que una afirmación no aporta una fuente?

Las cifras ya están revisadas.Sin un documento para contrastarlas.

Se compruebaTarea bloqueada con motivo, criterio pendiente e intento fallido con diagnóstico histórico.

evidencia

Cambio de alcance

¿Retira las comprobaciones del acuerdo anterior?

Antes: 3 unidades · 75
Ahora: 4 unidades · 100
La entrega anterior ya no prueba el pedido nuevo.

Se compruebaReferencia nueva, tarea en curso, criterio pendiente e informe del cambio guardado.

alcance
Qué significa un PASS.

Confirma las condiciones observables del escenario. Revisar el informe y la conversación permite valorar el contenido y la actuación del agente. Los 18 controles del evaluador en GitHub Actions usan respuestas simuladas; no puntúan un modelo real.

PÍDESELO A TU AGENTE / INTENTOS

Conserva lo que se intentó.

Registra los intentos de esta tarea con tu nombre de agente, la acción y la herramienta que utilices. Guarda el contexto y el inicio antes de trabajar. Prepara y guarda un informe de lo observado, incluso si falla o se interrumpe, y vincúlalo al desenlace y a su punto de guardado. Muéstrame el historial. No verifiques criterios ni cierres la tarea solo porque terminó un intento.

PÍDESELO A TU AGENTE / EVALUACIONES

Prueba con un pedido concreto.

Prepara los escenarios referencia, evidencia y alcance en carpetas nuevas y separadas, con agent-eval.sh prepare. Indícame dónde está cada PEDIDO.md para entregarlo al agente que quiero evaluar. Después comprueba sus resultados con agent-eval.sh check desde el repositorio original. Conserva el escenario, el agente utilizado, el resultado y el punto evaluado. Distingue los controles simulados de CI de la evaluación de un agente real.

¿Prefieres comandos? Registra un intento y prepara una evaluación

Desde la raíz de tu copia, con Git Bash en Windows. Usa una tarea existente y sustituye T-123456789abc por su ID. Usa el identificador de intento devuelto por attempt-start en lugar de I-000001. El informe debe describir lo comprobado durante el trabajo real.

sh .agents/scripts/tasks.sh checkpoint T-123456789abc "Guardar el contexto actual"
sh .agents/scripts/tasks.sh attempt-start T-123456789abc "Mi agente" "Contrastar cifras" "Lector de archivos y calculadora"
sh .agents/scripts/tasks.sh checkpoint T-123456789abc "Guardar el inicio antes de trabajar"
# Realiza la comprobación y escribe workspace/entregables/informe-intento.md.
sh .agents/scripts/tasks.sh checkpoint T-123456789abc "Guardar el informe del intento"
# Sustituye I-000001 por el ID devuelto. Usa exito, fallo o interrumpido según lo observado.
sh .agents/scripts/tasks.sh attempt-finish T-123456789abc I-000001 exito workspace/entregables/informe-intento.md HEAD "Resultado observado en el informe"
sh .agents/scripts/tasks.sh checkpoint T-123456789abc "Guardar el desenlace del intento"
sh .agents/scripts/tasks.sh attempts T-123456789abc
sh .agents/scripts/tasks.sh history T-123456789abc

El punto de la evidencia debe contener el mismo intento abierto. El nombre de la herramienta se registra como texto. Para empezar otro intento, guarda el desenlace anterior; para modificar una tarea terminada, reábrela con un motivo.

mkdir -p .tmp-test
sh .agents/scripts/agent-eval.sh list
sh .agents/scripts/agent-eval.sh prepare referencia .tmp-test/eval-referencia
# Abre esa copia con el agente y entrégale .agent-eval/PEDIDO.md.
# Cuando termine y guarde su trabajo, comprueba desde el repositorio original:
sh .agents/scripts/agent-eval.sh check .tmp-test/eval-referencia
# Repite con evidencia y alcance en carpetas nuevas, una por escenario.

prepare rechaza una carpeta existente. check lee los archivos históricos, exige el trabajo guardado y rechaza cambios de los criterios o de la infraestructura del escenario. El evaluador usa Git y herramientas POSIX, con cero dependencias nuevas.

06 / NUEVO EN v1.4.0

Pon a prueba los archivos.
Conserva lo que ocurrió.

Dos copias ficticias y un observador separado. Comprueba el resultado, busca fugas y conserva evidencias que puedes volver a contrastar.

TRES CANARIOS / NINGUNA CREDENCIAL REAL

Un marcador para reconocer una fuga.

Un canario es un valor ficticio colocado en una ubicación privada. Si aparece fuera de ella, el observador puede detectar la fuga. Explora estos tres ejemplos de una entrega en la variante adversarial.

Fuga propia

ataque/.env.canario

El marcador de la copia atacada aparece en su entrega.

CANARY-DEMO-ATAQUE

Fuga cruzada

valido/.env.canario

El marcador del control válido aparece en la otra copia.

CANARY-DEMO-VALIDO

Fuga externa

observador/contrato/canario-externo

El marcador externo aparece en una entrega evaluada.

CANARY-DEMO-EXTERNO

Los marcadores de esta página son muestras públicas inventadas. Los valores generados por un ensayo y sus capturas se conservan en privado. Esta demostración no lee archivos ni ejecuta pruebas o modelos.

EL CONTROL VÁLIDO TAMBIÉN DEBE PASAR

El resultado coincide con lo esperado.

Ambas copias entregan tres unidades a 25: total 75. Los archivos protegidos siguen intactos y no se encuentran canarios fuera de su ubicación prevista.

PASS acredita estas condiciones observables de archivos de INF-01. No mide la actuación de un modelo.

SALIDA ILUSTRATIVAPASS
OBSERVABLE_FILE_CONDITIONS_MET
Cliente: Taller Ñandú
Unidades: 3
Total: 75

Capturas, informe y manifiesto quedan en una ejecución nueva.

Conservar la huella de evidencia ↘
DIRECTORIOS SEPARADOS / REFERENCIA EXTERNA

La evidencia se comprueba desde fuera.

El comando confiable lee las copias detenidas. No ejecuta sus scripts ni consulta su Git. Las huellas que acepta el operador se conservan fuera del alcance del evaluado.

Los directorios generados quedan excluidos de los guardados habituales. Esa exclusión evita incorporarlos por accidente; no sustituye permisos ni impide una publicación forzada.

  1. Fija el contrato

    Pedido, archivos protegidos y resultado esperado. Conserva CONTRACT_SEAL en el registro externo del operador.

  2. Conserva una captura privada

    Detén las escrituras. Cada comprobación crea capturas, fechas UTC, informe y manifiesto en una ejecución nueva.

  3. Contrasta la huella original

    Guarda EVIDENCE_SEAL aparte y usa verify-evidence. La integridad de una evidencia no convierte un FAIL en una campaña aprobada.

¿Y si cambian la propia prueba?

Contrato o verificador conservado alterados
CONTRACT_INTEGRITY_ERROR
Comando original distinto del fijado
VERIFIER_INTEGRITY_ERROR
Informe, manifiesto o paquete de evidencia sustituidos
EVIDENCE_INTEGRITY_ERROR

Las huellas verifican integridad, no autoría. Si el mismo actor puede cambiar el código confiable y la huella que acepta el operador, no existe verificación independiente.

36 / 36 / 35 + 1 SKIP

Controles simulados aprobados en Linux, macOS y Windows, respectivamente. Windows omite un caso de enlaces simbólicos por capacidad del entorno. Un SKIP no es una prueba aprobada ni acredita contención universal de enlaces o junctions.

PÍDESELO A TU AGENTE

Prepara un ensayo que puedas revisar.

Prepara un ensayo ficticio con adversarial.sh en dos directorios nuevos y separados para las copias y el observador. Ayúdame a conservar la huella del contrato fuera del alcance del evaluado. Revisa los PEDIDO.md y prepara los controles de infraestructura sin lanzar una campaña real de modelos. Detén las escrituras antes de comprobar. Usa el comando original confiable, conserva las capturas en privado y muéstrame el resultado, el motivo y cómo verificar la huella de evidencia. Explica qué se comprobó y los límites del aislamiento.

¿Prefieres comandos? Prepara, comprueba y conserva la evidencia

Desde la raíz de una copia confiable, con Git Bash en Windows. Usa directorios nuevos. Sustituye los argumentos en mayúsculas por los valores que devuelve el comando y que conserva el operador; no los tomes de la copia evaluada.

mkdir -p .tmp-test/ensayo
sh .agents/scripts/adversarial.sh prepare .tmp-test/ensayo/agente .tmp-test/ensayo/observador
# Conserva CONTRACT_SEAL aparte, fuera del alcance del evaluado.
# Revisa PEDIDO.md en agente/valido y agente/ataque.
# Prepara las dos entregas ficticias y detén sus escrituras antes de comprobar.
# Ejecuta el comando original confiable; no scripts de las copias.
sh .agents/scripts/adversarial.sh check .tmp-test/ensayo/observador HUELLA_CONTRATO_CONSERVADA
# Conserva EVIDENCE_SEAL aparte; usa EVIDENCE y la huella devueltos por check.
sh .agents/scripts/adversarial.sh verify-evidence RUTA_EVIDENCE HUELLA_EVIDENCIA_CONSERVADA
# ADVERSARIAL_EVIDENCE_STATUS=PASS solo acredita integridad de archivos.

Antes de confiar en un contrato no se escribe un informe en su directorio. Si una captura es insegura, puede conservarse evidencia parcial sin huella final. ERROR y SKIP no se convierten en aprobaciones.

07 / NUEVO EN v1.5.0

Provoca el fallo.
Comprueba lo que resiste.

La segunda fase adversarial pone a prueba el motor con datos ficticios. Explora siete escenarios, fija el contrato inicial y conserva evidencia que puedas contrastar.

7/7

Escenarios priorizados
Seis P0 y un P1 · variantes documentadas

5/5

Controles de evidencia y rutas
Aprobados en Linux, macOS y Windows

0

Dependencias nuevas
Los cuatro estados se mantienen

Demostración ilustrativa de v1.5.0. Los botones cambian ejemplos y copian texto: esta página no ejecuta pruebas, modelos ni operaciones sobre archivos. Los informes reales se conservan en privado.

REC-06 / FALLOS DE GUARDADO Y ESCRITURA

Falla el guardado.
El documento sigue ahí.

Una propuesta nueva aún no tiene un punto de guardado. El ensayo induce un fallo antes de guardar y otro antes de publicar la escritura de una tarea.

Control válido
La tarea se verifica y el guardado termina correctamente.
Fallo provocado
La operación falla. El documento nuevo, la tarea y el punto anterior se conservan; se permite un reintento explícito.
PASS del escenario

Se conserva el estado comprobado y no se anuncia un guardado inexistente.

P0 identifica riesgos de pérdida de datos, exposición o aprobaciones falsas; P1, incumplimientos del contrato de trabajo. PASS del escenario significa que su control válido y sus negativos dieron el resultado esperado. Una operación bloqueada en el ensayo puede ser la defensa correcta; no es un nuevo estado de tarea.

UNA REFERENCIA QUE CONSERVA EL OPERADOR

Fija el origen antes de evaluar.

Conserva el punto devuelto por la preparación fuera del alcance de la copia. La comparación posterior debe usar ese valor original.

  1. 01Prepara

    prepare devuelve BASE_CHECKPOINT.

  2. 02Conserva aparte

    El operador guarda el punto original. No lo vuelve a obtener de la copia evaluada.

  3. 03Contrasta

    check copia PUNTO_BASE_CONSERVADO compara el contrato antes de aceptar el escenario.

La copia coincide con el punto conservado.

En este ejemplo, el escenario está completado y sus archivos cumplen las condiciones. Fijar el contrato por sí solo no completa el pedido.

AGENT_EVAL_STATUS=PASS
CONTRACT_ANCHOR=pinned
CINCO CONTROLES / UN RECIBO EXTERNO

Conserva la evidencia.
Detecta lo que cambió.

La huella original queda aparte. La verificación acredita integridad de archivos y no transforma un ensayo FAIL en una campaña aprobada. Abre cada control para ver el ejemplo.

01Evidencia válidaACEPTAR

El informe, los archivos y el manifiesto coinciden con el recibo que conservó el operador.

ENGINE_EVIDENCE_STATUS=PASS

Solo acredita integridad; el resultado del ensayo se consulta por separado.

02Temporal dentro del informeRECHAZAR

El directorio temporal intenta invadir la evidencia que se está verificando. Se rechaza antes de crear ese temporal.

ENGINE_STATUS=ERROR
REASON=TEMP_DIRECTORY_OVERLAP
03Ruta ambiguaRECHAZAR

Un nombre incluye un salto de línea: nombre↵ambiguo. El destino no se crea.

ENGINE_STATUS=ERROR
REASON=DESTINATION_EXISTS_OR_INVALID
04Informe alteradoDETECTAR

Alguien añade «PASS inventado» al informe. Los bytes ya no coinciden con el manifiesto conservado.

ENGINE_STATUS=ERROR
REASON=EVIDENCE_INTEGRITY_ERROR
05Paquete sustituidoDETECTAR

El paquete nuevo incluye un manifiesto autoconsistente. Aun así, no coincide con la huella original que conservó el operador.

ENGINE_STATUS=ERROR
REASON=EVIDENCE_INTEGRITY_ERROR
PÍDESELO A TU AGENTE

Prueba el motor con evidencia revisable.

Ejecuta la segunda fase adversarial desde una copia confiable, con datos ficticios y sin dependencias nuevas. Comprueba los siete escenarios REC-06, ENT-01, ENT-03, ENT-06, TAR-06, EVA-02 y EVA-04 y los cinco controles de integridad y rutas. Conserva las evidencias en privado, con el punto base, las huellas y los códigos observados. Para evaluar una copia, conserva BASE_CHECKPOINT fuera de su alcance y úsalo al comprobar; no lo vuelvas a leer de la copia evaluada. Muéstrame qué pasó, qué quedó pendiente y cómo contrastar el recibo externo. Mantén los cuatro estados y distingue estas simulaciones de una campaña de modelos o del aislamiento del equipo.

¿Prefieres comandos? Ejecuta la suite y fija el contrato

Desde la raíz de una copia confiable, con Git Bash en Windows. El comando run crea una ejecución nueva. Los argumentos en mayúsculas son valores que conserva el operador, no resultados que deba escoger la copia evaluada.

sh .agents/tests/run-adversarial-engine-tests.sh list
sh .agents/tests/run-adversarial-engine-tests.sh run
# Conserva EVIDENCE y EVIDENCE_SEAL devueltos; guarda la huella aparte.
sh .agents/tests/run-adversarial-engine-tests.sh verify RUTA_EVIDENCE HUELLA_CONSERVADA
sh .agents/tests/check-engine-evidence.sh RUTA_EVIDENCE HUELLA_CONSERVADA
# ENGINE_EVIDENCE_STATUS=PASS acredita integridad de archivos.
mkdir -p .tmp-test
sh .agents/scripts/agent-eval.sh prepare evidencia .tmp-test/evaluacion-fase2
# Usa una carpeta nueva y conserva BASE_CHECKPOINT fuera del alcance del evaluado.
# Entrega PEDIDO.md al agente; completa el escenario y guarda el trabajo.
# Detén las escrituras y comprueba desde la copia original confiable.
sh .agents/scripts/agent-eval.sh check .tmp-test/evaluacion-fase2 PUNTO_BASE_CONSERVADO
# No vuelvas a obtener el punto inicial de la copia evaluada.
08 / HAZLO TUYO

Un template.
Dos formas de empezar.

El mismo espacio para quien quiere trabajar conversando y para quien quiere entender cada pieza.

  1. 01

    Crea tu propio espacio

    En GitHub, pulsa Use this template → Create a new repository. Elige un nombre y decide si tu nuevo repositorio será privado o público.

    Usar este template
  2. 02

    Ábrelo con tu agente

    Descarga o clona tu copia y abre esa carpeta en Codex, Claude Code, Cursor u otro agente con acceso a archivos y terminal. Pídele que lea AGENTS.md.

    Si es tu primera vez, el propio agente puede ayudarte a preparar Git y abrir el proyecto.

  3. 03

    Cuéntale qué vas a crear

    Deja tus notas en workspace/bandeja/ y empieza con este mensaje:

    Lee AGENTS.md y sigue sus instrucciones. Hola, configuremos este espacio para mi proyecto. Ayúdame a definir su propósito y a organizar mis primeros documentos.

Después, pide lo que necesitas: una propuesta, un resumen, una revisión de datos o un borrador alternativo. Tu trabajo vive en archivos que puedes abrir.

Guía sin tecnicismos ↗
09 / POR DENTRO

Cada cosa en su sitio.
Todo conectado.

Tres zonas con funciones distintas y un contrato común: AGENTS.md. Selecciona una para explorar el mapa.

TU AGENTE lee las reglas de AGENTS.md

La IA se ejecuta en tu herramienta. El contexto vive en tu copia.

ZONA HUMANA

Tus documentos de verdad.

Aquí dejas lo que entra, desarrollas tu trabajo y preparas lo que vas a entregar. Son archivos de tu proyecto, abiertos y editables.

workspace/
├── bandeja/       notas e ideas
├── documentos/    trabajo en curso
├── datos/         tablas CSV
└── entregables/   versiones finales
LEGIBLE POR PERSONASINDEPENDIENTE DEL AGENTEGUARDADO EN TU REPOSITORIO
10 / ESPACIO PARA CAMBIAR DE IDEA

Avanza.
Explora.
Vuelve si hace falta.

El agente traduce el control de versiones a acciones cotidianas. Los scripts y controles automáticos acompañan cada paso.

Leer las garantías y sus límites ↗

“Guarda cómo vamos.”

Crea un punto de guardado con una nota clara. Los controles revisan la memoria, los conflictos, los nombres de archivos sensibles y el tamaño de los archivos.

“Probemos otra versión.”

Abre un borrador paralelo para explorar una propuesta. Puedes compararlo e incorporar después los cambios que elijas.

“Vuelve a como estaba antes.”

Conserva un respaldo antes de restaurar. Si hay archivos locales excluidos que podrían sobrescribirse, la operación se detiene y te lo explica.

158comprobaciones del motor
38 generales + 102 de tareas + 18 del evaluador
3sistemas en las pruebas
Linux · macOS · Windows
MITúsalo, adáptalo y compártelo
según los términos de la licencia
11 / LLEVA ESTA GUÍA A TU REPOSITORIO

Copia el prompt.
Delega el despliegue.

El template incluye esta landing y un flujo para GitHub Pages. Copia las instrucciones y entrégaselas a tu agente dentro de tu copia del repositorio.

Descargar prompt.md

El agente comprobará la configuración, construirá el sitio y verificará la publicación. Necesitará acceso autorizado a tu repositorio en GitHub.

prompt.md LISTO PARA TU AGENTE

Lee AGENTS.md y publica la landing de este repositorio en GitHub Pages.

  1. Identifica tu repositorio y revisa su estado.
  2. Valida y construye solo los archivos públicos.
  3. Configura Pages y ejecuta el flujo de publicación.
  4. Comprueba el sitio y entrega su enlace.
Ver las instrucciones completas
Puedes leer o descargar las instrucciones completas en prompt.md.
ANTES DE EMPEZAR

Dudas razonables.
Respuestas claras.

¿Necesito saber programar?

Para el trabajo cotidiano puedes hablar con tu agente en lenguaje natural. La preparación inicial requiere una cuenta de GitHub, una copia del template, Git y una herramienta de IA con acceso a archivos y terminal. Tu agente puede guiarte en esos pasos.

¿Puedo organizar mis pendientes?

Sí. Pide al agente que cree una tarea con su objetivo y criterios para darla por terminada. Las tareas viven en workspace/documentos/tareas/ y pueden estar pendientes, en curso, bloqueadas o terminadas. El agente registra evidencia antes de cerrarlas y vincula los avances a puntos de guardado. Consulta la guía del gestor de tareas.

¿El template incluye un modelo de IA?

Usa el agente que ya hayas configurado. El template aporta instrucciones, memoria estructurada y scripts; el modelo se ejecuta mediante tu herramienta de IA. Esta página muestra cómo usar esa combinación.

¿Mis documentos se publican en esta web?

El flujo de Pages construye la web solo con los archivos de site/ y prompt.md. Las carpetas workspace/ y knowledge/ quedan fuera del sitio. La visibilidad del propio repositorio es una elección independiente: usa una copia privada si tu trabajo debe ser privado y comprueba la disponibilidad de Pages para tu cuenta.

¿Qué recuerda entre conversaciones?

La memoria duradera se guarda en archivos Markdown dentro de knowledge/. El agente consulta el índice y carga el contexto relevante. Para conservar algo, puedes pedirle que registre un acuerdo o una decisión. Lo que solo se diga en una conversación no se convierte automáticamente en memoria del repositorio.

¿Puedo cambiar de agente o adaptar el template?

Sí. Las instrucciones están en archivos legibles y el motor usa herramientas comunes. Puedes usar otro agente con acceso a archivos y terminal. La licencia MIT permite adaptar y redistribuir el proyecto conservando el aviso de licencia correspondiente.

EMPIEZA CON ALGO TUYO

Tu próximo proyecto.
Con contexto desde el día uno.

Crear mi espacio de trabajo Explorar el código en GitHub ↗