Standalone Python generators under problems/*-problems/ emit quiz and homework
items via shared helpers in bptools.py. For layout and design see
docs/FILE_STRUCTURE.md and
docs/CODE_ARCHITECTURE.md.
- Python: docs/PYTHON_STYLE.md.
- Pytest: docs/PYTEST_STYLE.md.
- Markdown: docs/MARKDOWN_STYLE.md.
- Student-facing question text (stems, choices, hints, YAML statements and matching values): design with docs/QUESTION_PEDAGOGY_GUIDE.md, word with docs/QUESTION_VOICE_GUIDE.md, imitate docs/QUESTION_EXEMPLARS.md.
- Repo organization, git, commit, and changelog rules: docs/REPO_STYLE.md.
- Document every change in docs/CHANGELOG.md.
- Setup and run: see docs/INSTALL.md and docs/USAGE.md.
- Run the test suite with
source source_me.sh && pytest tests/.
- Blackboard HTML and inline-style rules: docs/BB_ULTRA_STYLE.md.
- For student assessments, prefer true randomness in scenario selection over deterministic round-robin/modulo cycling; predictable sequences make cheating easier. Use deterministic selection only for debugging, reproducibility, or unit tests.
- Agents must run Python using
source source_me.sh && python3