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.normativa-2026.md— Actualizaciones normativas 2025-2026. Prevalece sobre el resto de archivos cuando haya contradicción.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.
La carpeta fuentes/ contiene copias íntegras de los textos oficiales del BOE en los que se basa normativa-2026.md, para consulta y verificación.
La normativa y el propio examen han cambiado de forma sustancial. El sistema está actualizado y verificado contra el BOE a 3 de septiembre de 2026:
- El examen teórico ha cambiado. Sigue siendo un test de 30 preguntas con 3 fallos como máximo, pero desde el 1 de octubre de 2025 entran las señales del nuevo catálogo y durante 2026 se incorpora, de forma progresiva por centro, una pregunta con vídeo de percepción del riesgo. El objetivo declarado de la DGT es acabar con el aprobado memorístico.
- Nuevo catálogo de señales (RD 465/2025, en vigor desde el 1-7-2025): unos 130 pictogramas nuevos, nueva clasificación de las señales verticales y de las marcas viales, y señales suprimidas (S-30, S-31, S-6, R-308a, R-308b).
- Baliza V-16 conectada obligatoria desde el 1-1-2026 en todos los vehículos y todas las vías: los triángulos de emergencia ya no sirven.
- VMP: registro obligatorio en la DGT, certificado de circulación y seguro de responsabilidad civil (RD 52/2026, Ley 5/2025).
- Reforma de protección a usuarios vulnerables (RD 518/2026), en vigor el 1 de octubre de 2026: carril de emergencia en autopistas, cambio completo de carril y −20 km/h para adelantar a ciclistas, casco obligatorio en VMP, guantes y calzado cerrado en moto, nuevo Título VI de circulación urbana, y mucho más.
- En el horizonte, aún no aplicable: la Directiva (UE) 2025/2205 permitirá el permiso B a los 17 años con conducción acompañada, pero España debe transponerla antes del 26-11-2028. Hoy la edad mínima sigue siendo 18 años.
Todo el detalle, con referencias legales y fechas exactas de entrada en vigor, está en normativa-2026.md, que incluye además una tabla de erratas para detectar material de estudio desactualizado.
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.
START_HERE_OFFLINE.md se genera automáticamente a partir de los archivos fuente. Si editas cualquiera de ellos, vuelve a construirlo:
python3 scripts/build_offline_prompt.pyEl 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.