Shass27/stem-notes

Apuntes suplementarios STEM (LaTeX)

Genera material de estudio como archivos .tex a partir de cualquier material fuente STEM. El usuario guía cada decisión a través de preguntas de opción múltiple (AskUserQuestion), así que pregunta antes de construir.

Archivos de soporte (léelos cuando llegues al paso correspondiente):

• references/tooling.md: software, comandos de instalación y tamaños, comandos de conversión
• references/questions.md: el banco de preguntas MCQ (rondas de ingreso, incluida la pregunta de compilación)
• references/style-guide.md: diseño, etiquetado, formato de solución, verificación y reglas de discrepancia
• templates/formula_sheet.tex, templates/solutions.tex, templates/summary_notes.tex: preámbulos para copiar

Flujo de trabajo

1. Inventariar las fuentes

• Enumera los archivos que el usuario señaló (carpeta o rutas con @). Acepta PDF, PNG/JPG, PPTX/DOCX.
• Para cada PDF ejecuta pdfinfo (conteo de páginas) y pdftotext -layout en el bloc de notas de la sesión, luego cuenta las palabras. Menos de ~50 palabras por página significa un archivo escaneado o con muchas imágenes: lee cada página como una imagen; el volcado de texto es inútil.
• Las presentaciones de diapositivas a menudo mantienen ecuaciones y figuras solo como imágenes. Incluso cuando existe texto, visualiza las páginas de todos modos.

2. Verificar las herramientas (solo lectura primero)

Ejecuta which pdfinfo pdftotext pdftoppm soffice tectonic pdflatex. Cualquier cosa que falte y sea necesaria va a la primera ronda MCQ, con su tamaño (consulta references/tooling.md). Nunca instales sin una respuesta MCQ. LibreOffice solo es necesario cuando hay archivos de Office presentes. Si el usuario responde una pregunta con otra pregunta (por ejemplo, "¿cuánto almacenamiento?"), responde, luego vuelve a preguntar.

3. Preguntas MCQ de ingreso

Haz las rondas en references/questions.md, como máximo 4 preguntas por llamada a AskUserQuestion. Coloca la opción recomendada primero y márcala como "(Recomendado)". Solo pregunta los grupos de preguntas para las salidas que el usuario seleccionó. La pregunta de compilación siempre se hace, al final. Lee las respuestas literalmente: las respuestas de texto libre anulan las opciones.

4. Leer todo

• PDFs: usa la herramienta Leer con pages (máximo 20 páginas por llamada, así que divide rangos más grandes) y emite todas las lecturas de rango de páginas para todos los archivos en un lote paralelo. La herramienta Leer necesita pdftoppm de poppler.
• Imágenes: léelas directamente.
• PPTX/DOCX: conviértelos a PDF en el bloc de notas (soffice --headless --convert-to pdf --outdir <scratchpad> archivo), luego léelos como PDF.
• Anota para cada pregunta o ejemplo: archivo fuente, diapositiva/página, número de problema, si la fuente ya lo resuelve (completa o parcialmente), y cualquier respuesta impresa.

5. Resolver y verificar

• Trabaja cada problema dentro del alcance. Para cualquier cosa no trivial (ajustes de curvas, integrales, balances de momentos, cálculos numéricos de varios pasos), verifica los números con un script corto de python3 en el bloc de notas.
• Compara con las respuestas impresas. Si discrepan, vuelve a verificar, luego reporta la discrepancia en el documento y al usuario. Nunca fuerces el trabajo para que coincida con una respuesta impresa.
• Señala errores tipográficos en la fuente (signos incorrectos, términos incorrectos, datos inconsistentes) en una nota al pie o una nota de "Por qué está aquí".

6. Escribir los archivos .tex

• Comienza desde la plantilla correspondiente en templates/: mantén su preámbulo y reemplaza los marcadores de posición %% TODO.
• Sigue references/style-guide.md: etiqueta cada elemento con fuente · diapositiva/página · número de problema, agrega una tabla de cobertura, reformula cada pregunta completa, encierra las respuestas en recuadros.
• Usa solo código fuente ASCII. Los comentarios son solo comentarios de una línea con %, nunca comentarios de banner multilínea.
• La carpeta de salida predeterminada es latex/ junto a las fuentes, a menos que el usuario elija otra.

7. Compilar solo si el usuario eligió hacerlo

• Tectonic: tectonic -X compile archivo.tex. MacTeX: latexmk -pdf archivo.tex. Corrige errores y recompila hasta que esté limpio.
• Si el usuario dice detener, detén la tarea inmediatamente (TaskStop) y no reintentes.

8. Informar

Enumera brevemente: los archivos escritos, qué cubre cada uno, preguntas omitidas (ya resueltas en la fuente), discrepancias encontradas y estado de compilación. Si no compilaste, dilo claramente.