Use when a thesis chapter edit, bibliography change, or formatting update requires rebuilding full.tex, diagnosing LaTeX errors, or resolving undefined citation, reference, or label warnings.
Read AGENTS.md for exact build commands, VS Code task names, and log-check patterns. This skill provides decision guidance only.
| Situation | Build |
|---|---|
| Prose-only changes, no new citations or labels | Quick: single xelatex pass |
New \cite{}, renamed keys, or new \label | Full: xelatex → bibtex → xelatex → xelatex |
Bibliography file (library.bib) edited | Full build — BibTeX must reprocess |
| Stage completion before commit | At minimum a quick build; full build if bibliography was touched |
grep -i "undefined" full.log # missing labels and citations
grep -i "multiply defined" full.log # duplicate labels
grep -i "overfull" full.log # check only after build correctness is confirmed
| Error pattern | Likely cause | Fix |
|---|---|---|
Citation ... undefined | Key used in chapter not in library.bib | Add the entry or fix the key spelling |
Reference ... undefined | \label renamed or missing | Check that the label name matches in both places |
Label ... multiply defined | Same \label in two files | Rename one |
Overfull \hbox | Long URL, wide table, or non-breaking math | Wrap URL with \url{}, split math, or adjust column widths |
Infinite glue shrinkage | longtable formatting | Pre-existing from the template; confirm it was not introduced by the edit |
State:
Do not flag pre-existing warnings as new problems.
library.bib — undefined citations will persist until BibTeX runs.Underfull \hbox, Infinite glue shrinkage) are cosmetic and pre-existing.\include removal or \newpage duplication can silently drop pages.