AGENTS.md

Working conventions

  • It is fine to run quarto render as needed to verify changes.
  • But prefer invoking quarto render directly rather than wrapping multiple renders in shell loops or compound shell commands. That is, don’t do “files=(1-questions-and-data/labs/unvotes/lab_rubric.qmd 2-summarizing-data/labs/class-survey/lab_rubric.qmd 2-summarizing-data/labs/flights/lab_rubric.qmd); for f in $files;” and then just run quarto render of those files in the loop. And anytime you chain a quarto render command to another command with && just do the render first and then run the rest.
  • Treat generated PDFs as build artifacts: do not edit them directly. Make changes to the source .qmd files and regenerate the PDFs with Quarto.