AGENTS

AGENTS.md — Reglas para transcribir/estructurar apuntes de clase

Este vault contiene apuntes de cursos en francés transcritos desde grabaciones de audio. Cuando se te pida estructurar una clase, aplica estas reglas.

Entradas que se te dan

• Transcripción: un .txt y/o .srt de whisper (con marcas de tiempo [hh:mm:ss]).
• Syllabus: textos extraídos de los PDFs en ~/.cache/syllabus/<Asignatura>/, con marcadores === PAGE N === (para citar la página exacta).
• Plantilla: Templates/Curso.md (o Templates/Exercice.md para TDs/ejercicios).

Salida

Un archivo .md dentro del vault, en la carpeta de la asignatura, con el nombre <Curso> - Cours N.md (o <Curso> - TDN.md). Sigue la plantilla Templates/Curso.md.

Estructura obligatoria de la nota

1. Frontmatter YAML: tags, cours, cours_num, date, langue: fr, duree, source_audio, support_ecrit, professeur, mots_cles.
2. Título H1: # <Curso> — Cours N : <título del tema>.
3. Línea del audio: 🔊 [Écouter la source audio](file:///ruta/al/audio.m4a).
4. ## Plan de la clase — lista de los temas tratados.
5. Línea de soporte escrito: > **Support écrit de référence** : [arquivo.pdf](file:///…) — chapitre X, § y (p. N).
6. Temas como títulos grandes (H2): ## N. <Tema> — *[hh:mm:ss → hh:mm:ss]*.
   • Regla clave: si el profe trata tres temas distintos, deben salir tres secciones H2. El título grande = de qué está hablando; debajo, las partes de la transcripción.
   • Bajo cada tema: primero la cita literal del profe y luego los apuntes.
   • Usa ### para subsecciones (definiciones, demostraciones, ejemplos).
7. Cierre: ## Points clés y ## Doutes / à vérifier.

Citas del profe

• Cita literal en francés, en bloque: > « texto exacto del profe » con marca [hh:mm:ss].
• Si el ASR escribió mal un término (teoremas, números, matemáticas), corrígelo y marca: « suites de cochi [sic : suites de Cauchy] ». Los nombres de teoremas, números y términos matemáticos son los errores más frecuentes.

LaTeX (obligatorio para toda la matemática)

• Inline: $...$ — Display: $$...$$.
• Nunca escribas una fórmula como texto plano ni como imagen: siempre en LaTeX. Ej.: el profe dice “l’intégrale de zéro à un de x carré” → $$\int_0^1 x^2\,dx = \frac{1}{3}.$$
• Usa \dfrac, \begin{pmatrix}, \boxed{...}, \mathbb{R}, \to, etc. como en las notas existentes.

Comparar con el syllabus

• Si el profe menciona el escrito (“comme dans le syllabus”, “à la page 30”, “l’exercice du syllabus”), localízalo en ~/.cache/syllabus/<Asignatura>/ y anota: > 🎓 *syllabus :* <arquivo> § x.y (p. N) — <qué dice esa parte>.
• Si no lo encuentras, NO inventes: déjalo en ## Doutes / à vérifier como algo a localizar.
• Cuando el profe siga el syllabus, enlaza source_audio y el PDF en support_ecrit.

Idioma

• Transcripción y citas: francés (tal cual, sin traducir).
• Cuerpo/redacción de la nota: francés (mantén el vocabulario del profe).
• Etiquetas de secciones: español (Plan de la clase, Points clés, Doutes / à vérifier).

Flashcards (mazos aparte, NUNCA dentro de la nota)

Las tarjetas no van en la nota de clase. Van a un archivo-mazo por asignatura: Flashcards/<Asignatura>.md, con la etiqueta #flashcards/<Asignatura-sin-espacios>.

• Lee primero Flashcards/_REGLAS.md (la «carta» del alumno) y respétala por encima de todo.
• Lee el mazo existente antes de añadir: no repitas tarjetas ya presentes (misma pregunta).
• Añade solo al final del archivo, bajo un encabezado ## 🟡 BORRADOR — <clase> (à trier), una lista de tarjetas de una línea:
  • normal: Pregunta :: Réponse
  • fórmula con nombre (reversible): Fórmula ::: significat
• NUNCA modifiques, reordenes ni borres el contenido previo, ni los comentarios <!--SR:...--> que puedas encontrar (son el progreso de repaso del alumno).
• Contenido permitido: définitions, énoncés de théorèmes, formules nommées (en francés, LaTeX, notación del curso). Prohibido: demostraciones, parejas recíprocas (A→B y B→A), logística/meta (examen, fechas, guardar archivos, horarios), trivialidades.
• Para TDs/ejercicios, añade además las tarjetas de error al mazo Flashcards/<Asignatura> Erreurs.md (etiqueta #flashcards/<Asignatura>-Erreurs), bajo el mismo tipo de encabezado de borrador.

Reglas de oro

• No inventes. Si el audio es ininteligible, marca ⚠️ y añádelo a Doutes / à vérifier.
• Marca con ⚠️ toda duda, mezcla de idiomas, zona contaminada del audio o numeración dudosa.
• Las flashcards no van en la nota: van al mazo Flashcards/<Asignatura>.md (ver arriba).
• No corrijas en silencio: toda corrección tuya al texto del profe va marcada con [sic : …].