CycleMantle
Flujos de trabajo

Guía paso a paso para crear tu primer archivo de datos de prueba

03
Datos de prueba en un minuto

De una carpeta vacía a una prueba exitosa

Tienes una función en PHP que formatea el total de un pedido y quieres verificarla con varios inputs. CycleMantle actúa como generador de datos: escribe un archivo JSON con pedidos inventados y luego crea las comprobaciones que lo leen. Nada se copia de clientes reales. Con un modelo en la nube, tu prompt y el texto del archivo que lee el agente van a ese proveedor; con un modelo local, nada sale de tu PC. Planea unos 4 mensajes cortos de chat: abre la carpeta, pide los registros, pide las comprobaciones y ejecútalas. Cada mensaje produce tarjetas que puedes leer, aceptar o rechazar antes de que empiece la siguiente. Lee las tarjetas de arriba a abajo: cada una nombra una herramienta, el archivo o comando que usó y el resultado que obtuvo. Si prefieres leer antes de que se ejecute algo, inicia el chat en Plan only y cambia a Ask first después de leer el plan.

01

Abre la carpeta del proyecto

Inicia la aplicación, elige la carpeta que contiene tu código PHP y selecciona Ask first como modo de aprobación, para que cada cambio espere tu visto bueno. Puedes cambiar el modo más tarde cuando quieras, por ejemplo a Auto-run una vez que confíes en los pasos.

02

Pide registros inventados

Describe los campos que necesitas, como nombre, fecha y monto, y pide un archivo JSON con filas inventadas. Indica cuántas filas quieres. Mantén cada nombre, dirección y monto claramente ficticios, para que nadie confunda una fila con una persona real.

03

Pide las comprobaciones

Solicita un pequeño script de prueba que lea el archivo JSON y compare entradas conocidas con salidas esperadas. Nombra la función que debe probar. Pide al agente que explique cada comprobación en una línea, para que sepas qué debe detectar.

04

Revisa y ejecuta

Lee el diff, acéptalo y deja que Shell ejecute tu comando de prueba. Luego lee el código de salida y expande la tarjeta para ver la salida. Si una comprobación falla, pide al agente que explique el fallo antes de que edite algo.

Un pequeño script de prueba para empezar

tests.php
<?php
function discount(int $cents, int $percent): int {
    return intdiv($cents * (100 - $percent), 100);
}
assert(discount(1000, 0) === 1000);
assert(discount(1000, 10) === 900);
assert(discount(0, 50) === 0);
assert(discount(999, 100) === 0);
echo 'All checks ran';

Una función simple y cuatro comprobaciones assert con entradas y resultados conocidos. No usa base de datos, red ni secretos. Más tarde, el agente puede reemplazar los números fijos por filas de tu archivo JSON, y las comprobaciones mantienen la misma estructura. Cambia un valor esperado a propósito para ver un fallo. Guárdalo como tests.php en tu carpeta de proyecto, ejecútalo con tu comando de prueba y lee el código de salida en la tarjeta antes de pedir algo más. Luego cambia un valor esperado a propósito y observa cómo la tarjeta se vuelve roja.

Cuatro tareas para las herramientas de generación de datos de prueba

Escribe los registros de ejemplo

Mucha gente se pregunta cómo generar datos de prueba más rápido que a mano. Describe la forma que quieres y deja que el agente la escriba: un archivo JSON con 3 clientes inventados, cada uno con un nombre, una fecha de registro y un monto de pedido. Entre las herramientas de generación de datos de prueba, un archivo simple en tu proyecto es el más fácil de leer y cambiar después, porque el diff muestra cada valor. glob y list_dir muestran dónde ya existen los datos de prueba, para que el nuevo archivo quede junto a los demás. Abre la tarjeta, verifica que cada valor esté claramente inventado y edita las filas extrañas a mano antes de aceptar. Usa dominios de ejemplo reservados para correos electrónicos. Pide un puñado de filas, no cientos, para que puedas leer cada una. Escribe las fechas en un formato fijo para que todas las filas se lean igual.

Escribe comprobaciones que lean el archivo

Pide un script que cargue el JSON y verifique un resultado por fila. El agente abre tu código fuente con read_file, encuentra la función con grep y propone el archivo de prueba como un diff. Mockear métodos estáticos en php es complicado, así que pide al agente que liste las llamadas estáticas antes de que escriba algo, y mantén esas llamadas detrás de una pequeña función que una prueba pueda reemplazar. Ask first mantiene el cambio hasta que lo aceptes. Lee cada aserción y pregunta si fallaría si la función estuviera incorrecta. Rechaza cualquier comprobación que solo repita el código que prueba. Luego añade una fila que debería fallar a propósito. Si el agente no puede decir qué función quieres decir, nómbrala en el prompt y menciona el archivo. Mantén un concepto por prueba.

Ejecuta las pruebas y lee el código de salida

Shell ejecuta tu comando de prueba en el entorno que elegiste, como Windows local, WSL o SSH a un servidor que poseas. La tarjeta muestra el código de salida real, y un código de salida cero significa que todas las comprobaciones pasaron, mientras que cualquier otro valor significa un fallo. Expande la tarjeta para leer la salida línea por línea. Si algo falla, el agente lee el mensaje y propone una corrección como un diff. No aceptes una corrección solo porque hace que la ejecución sea verde. Verifica primero el valor esperado en la prueba. Si sigue un segundo fallo, pide al agente que explique el primero antes de que edite de nuevo. Plan only es un buen primer paso si el comando es nuevo para ti, porque el agente escribe un plan y no ejecuta nada.

Decide qué código necesita una prueba

Una vez que las pruebas pasan, ejecuta tu comando de cobertura y deja que el agente lea el informe. Los equipos discuten si incluir el código de infraestructura en la cobertura de código, y la respuesta sensata es acordarlo antes de que el número se convierta en un objetivo. Algunos equipos también exigen cobertura de prueba obligatoria para métodos críticos, como verificaciones de precio o permisos. Pide al agente que liste esos métodos con grep y proponga pruebas para el primero. Revisa el diff, ejecuta las pruebas de nuevo y detente cuando las rutas críticas estén cubiertas. Escribe en qué carpetas contaste, para que la cifra del próximo mes signifique lo mismo. Pide al agente que ponga la lista de carpetas contadas en un archivo de texto simple en tu proyecto, y lee el diff antes de aceptarlo.

CycleMantle para Windows

Genera tu primer archivo de datos de prueba hoy

Descargar CycleMantle ↗