Automatización de Android mediante lenguaje natural para asistentes de programación con IA y suites de pruebas, en teléfonos reales o emuladores.
16,7 mil+1 mil esta semana1,8 milPythonApache-2.0Actualizado el mes pasado
truecourse-ai/truecourse
Genera pruebas end-to-end de Playwright a partir de tus PRD, ADR y README, y detecta cuándo el producto y su documentación no coinciden.
- Estrellas
- 538
- Forks
- 44
- Issues abiertos
- 52
- Último commit
- hace 23 días
¿Qué es?
TrueCourse lee la documentación que el equipo ya escribe, como PRD, ADR, README y sitios de documentación, y la organiza en un conjunto de afirmaciones. Después determina los flujos que sigue cada usuario en el producto y escribe una prueba para cada uno contra las interfaces en ejecución.
Cuando una prueba falla, significa que el producto y la documentación ya no coinciden, y el fallo identifica la afirmación concreta implicada. Las pruebas se escriben como specs de Playwright, cada una con sus propios datos de inicialización para que no compartan estado. La herramienta funciona con un inicio de sesión de Claude Code e incluye un modo local que no requiere iniciar sesión, además de comprobaciones de pull requests mediante una GitHub App.
El proyecto está desarrollado en TypeScript, usa un monorepo de pnpm y PostgreSQL. Expone un endpoint MCP para que Claude Code pueda leer los documentos, flujos, ejecuciones y fallos del espacio de trabajo.
Funciones clave
- 01Convierte PRD, ADR, README y sitios de documentación en un corpus de afirmaciones que se pueden probar.
- 02Escribe pruebas end-to-end de Playwright para cada flujo de usuario contra el producto en ejecución.
- 03Informa de las pruebas fallidas e identifica la afirmación de la documentación con la que contradicen.
- 04Comprueba en GitHub si hay conflictos con la documentación y pruebas fallidas en los pull requests.
- 05Expone un endpoint MCP para que Claude Code consulte los resultados del espacio de trabajo.
Casos de uso
- Comprobar si el producto sigue comportándose como lo describen su PRD y la documentación para usuarios.
- Detectar divergencias entre los registros de decisiones de arquitectura y el sistema en ejecución.
- Ejecutar comprobaciones basadas en la documentación en los pull requests antes de fusionarlos.
Inicio rápido
- 1
Copia el archivo de entorno de ejemplo
cp .env.example .env - 2
Inicia Postgres con Docker Compose
docker compose up -d - 3
Instala las dependencias
pnpm install - 4
Inicia el servidor de desarrollo y abre http://localhost:3000
pnpm dev
Antes de usarlo
- Se necesita iniciar sesión en Claude Code y tener el binario claude en el PATH.
- El CLI de npm truecourse está obsoleto y ya no se mantiene.
- Para usar el código de ee/ en producción, se necesita una suscripción Enterprise.
En colecciones
Temas
Preguntas frecuentes
- ¿Qué es truecourse?
- Genera pruebas end-to-end de Playwright a partir de tus PRD, ADR y README, y detecta cuándo el producto y su documentación no coinciden. TrueCourse lee la documentación que el equipo ya escribe, como PRD, ADR, README y sitios de documentación, y la organiza en un conjunto de afirmaciones. Después determina los flujos que sigue cada usuario en el producto y escribe una prueba para cada uno contra las interfaces en ejecución.
- ¿truecourse es gratuito? ¿Qué licencia tiene?
- truecourse es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿truecourse sigue mantenido?
- Mantenimiento activo. El último commit de truecourse fue el 14 oct 2026.
- ¿Para qué puedo usar truecourse?
- Comprobar si el producto sigue comportándose como lo describen su PRD y la documentación para usuarios. Detectar divergencias entre los registros de decisiones de arquitectura y el sistema en ejecución. Ejecutar comprobaciones basadas en la documentación en los pull requests antes de fusionarlos.
- ¿Cómo se instala truecourse?
- Copia el archivo de entorno de ejemplo: cp .env.example .env Inicia Postgres con Docker Compose: docker compose up -d Instala las dependencias: pnpm install Inicia el servidor de desarrollo y abre http://localhost:3000: pnpm dev
- ¿Dónde consigo truecourse?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/truecourse-ai/truecourse
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Framework de pruebas end-to-end con IA: los tests se escriben en lenguaje natural y se ejecutan con Playwright y Anthropic Claude.
Herramientas para desarrolladores#end-to-end-testing#playwright#test-automation#anthropic#typescript
5,7 mil341TypeScriptMITActualizado hace 3 meses
Agente de testing con IA y de código abierto que convierte archivos de funcionalidades Gherkin en pruebas automatizadas de extremo a extremo para navegador, API, seguridad, accesibilidad y aspectos visuales.
1,2 mil+9 esta semana202PythonAGPL-3.0Bien mantenidoActualizado hace 8 días
Playwright es un framework de testing y automatización web que controla Chromium, Firefox y WebKit mediante una sola API.
99,4 mil+566 esta semana6,8 milTypeScriptApache-2.0Actualizado hace 17 horas
Framework de pruebas end-to-end para aplicaciones web y móviles que permite describir objetivos en lenguaje natural y usar un agente para interactuar con la aplicación.
13,3 mil+1,1 mil esta semana693TypeScriptApache-2.0Actualizado hace 17 horas
Una interfaz de línea de comandos para automatizar navegadores con Playwright, diseñada para que los agentes de programación controlen navegadores mediante comandos breves de shell y skills.
15 mil+231 esta semana899TypeScriptApache-2.0Bien mantenidoActualizado hace 17 horas