Este repositorio contiene un sistema de tutoría basado en IA mediante archivos markdown, diseñado para ayudarte a preparar el examen teórico del "Permiso B" de la DGT en España. A diferencia de los ejercicios de tarjetas de memoria (flashcards) tradicionales, este es un compañero de estudio conversacional y socrático. No se limita a examinarte; explica conceptos, desafía tu razonamiento con escenarios y se adapta a tu progreso mediante un Sistema de Repetición Espaciada (SRS) silencioso que se ejecuta íntegramente dentro de la lógica de la IA.
El DGT Tutor está diseñado para ser:
- Conversacional: Participa en un diálogo natural para enseñar y reforzar conceptos.
- Socrático: Te pide que razones a través de escenarios antes de proporcionarte la respuesta.
- Adaptativo: Dirige el plan de estudio basándose en tus puntos débiles y tu dominio actual.
- Puro Markdown: Sin código, sin bases de datos. La IA lee los archivos proporcionados y adopta la personalidad y el comportamiento descritos.
Para asegurar que la IA comprenda todo el contexto y las reglas del sistema, debe leer estos archivos en el siguiente orden al inicio de cada sesión:
README.md— Este archivo; proporciona una visión general del sistema y una guía de navegación.tutor.md— Define la personalidad de la IA, las pautas de comportamiento y el enfoque pedagógico.knowledge-base.md— El conocimiento principal del dominio, incluyendo reglas legales, cifras críticas y trampas comunes del examen.srs.md— La lógica del Sistema de Repetición Espaciada utilizada para seguir el progreso y programar los temas.session-template.md— El arco estructurado de una sesión de estudio (Apertura, Bucle de Estudio, Cierre).orchestrator.md— La secuencia de arranque y las reglas de ejecución que rigen el funcionamiento de la IA.
El sistema funciona con cualquier interfaz de chat de IA moderna y capaz, incluyendo:
- Claude (Anthropic)
- ChatGPT (OpenAI)
- Gemini (Google)
La forma más sencilla de comenzar una sesión es utilizar el archivo START_HERE.md. Contiene un prompt de "pegar e ir" que instruye a la IA para obtener todos los archivos necesarios de este repositorio e inicializar la sesión de tutoría automáticamente.
Si tu chatbot no puede recuperar URLs (por ejemplo, ChatGPT sin navegación), usa en su lugar START_HERE_OFFLINE.md: un prompt autocontenido con toda la base de conocimiento ya incluida, que no requiere acceso a internet.
El tutor cubre los siguientes 18 temas del programa oficial de la DGT:
- T01 Definiciones
- T02 Documentación
- T03 Normas generales
- T04 Velocidad
- T05 Prioridad
- T06 Adelantamientos
- T07 Cambios de dirección/sentido
- T08 Parada y estacionamiento
- T09 Alumbrado
- T10 Señalización I (agentes/semáforos)
- T11 Señalización II (verticales y marcas)
- T12 Transporte personas/carga
- T13 Alcohol/drogas/distracciones
- T14 Seguridad activa/pasiva
- T15 Mecánica y mantenimiento
- T16 Accidentes/primeros auxilios
- T17 Conducción eficiente/meteorología
- T18 Sanciones y puntos
Para cada tema, el tutor realiza un seguimiento de tu progreso a través de cuatro niveles de dificultad:
- N1 (Definiciones/Cloze): Conceptos básicos y definiciones.
- N2 (MCQ Simple): Preguntas estándar de opción múltiple.
- N3 (Escenario): Aplicación de reglas a escenarios de conducción específicos.
- N4 (Trampas estilo DGT): Preguntas avanzadas diseñadas para detectar errores comunes de los estudiantes, reflejando el estilo del examen de la DGT.
Para comenzar tu sesión, simplemente pega el contenido de START_HERE.md en el chat de IA que hayas elegido.
Una vez que comience la sesión, el tutor te hablará en español. Puedes interactuar de forma natural. Si necesitas parar, puedes decir "para" o "ya basta" para recibir un resumen de tu sesión y tu progreso actual antes de finalizar el chat.