feat(assignments): add GitHub Classroom submodules with Colab badges

- Add 6 assignment template repos as submodules under assignments/
- Each notebook has 'Open in Colab' badge at top
- Add AGENTS.md files for each submodule and assignments directory
- Update root AGENTS.md with submodule documentation
- Update GitHub Actions to checkout submodules recursively
- Fix data file links in assignment pages to point to submodules
- Remove legacy 'Assignment X: NAME' directories (content now in submodules)

Submodules added:
- eliza-llm-course
- spam-classifier-llm-course
- embeddings-llm-course
- customer-service-bot-llm-course
- gpt-llm-course
- final-project-llm-course

Author: jeremymanning

.github/workflows/build-pages.yml

@@ -22,6 +22,7 @@ jobs:
         uses: actions/checkout@v4
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
+          submodules: recursive
 
       - name: Setup Python
         uses: actions/setup-python@v5

.github/workflows/deploy-demos.yml

@@ -34,6 +34,8 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
+        with:
+          submodules: recursive
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
@@ -83,6 +85,12 @@ jobs:
               cp -r "$dir" _site/assignments/
             fi
           done
+          # Copy assignment submodules (for data files like instructions.txt, training.zip)
+          for dir in assignments/*-llm-course; do
+            if [ -d "$dir" ]; then
+              cp -r "$dir" _site/assignments/
+            fi
+          done
           cp -r figures/* _site/figures/
           cp -r fonts/* _site/fonts/
 

AGENTS.md

@@ -19,11 +19,34 @@ llm-course/
 │   ├── week1-10/    # Each week symlinks to template_deck/themes/
 │   └── template_deck/  # Build engine (compile.sh, autoscale.js)
 ├── tests/           # 1500+ tests, custom TestRunner (no framework)
-├── assignments/     # Jupyter notebooks for students
+├── assignments/     # Assignment web pages + GitHub Classroom submodules
+│   ├── assignment-X/    # Rendered HTML instruction pages
+│   └── *-llm-course/    # Submodules (template repos with notebooks)
 ├── notes/           # Internal debugging logs (not student-facing)
 └── admin/           # Syllabus, fonts, compile scripts
 ```
 
+## SUBMODULES
+
+Assignment template repositories are git submodules under `assignments/`:
+
+| Submodule | Notebook | Data Files |
+|-----------|----------|------------|
+| `eliza-llm-course` | Assignment1_ELIZA.ipynb | instructions.txt |
+| `spam-classifier-llm-course` | Assignment2_SPAM_Classifier.ipynb | training.zip |
+| `embeddings-llm-course` | Assignment3_Wikipedia_Embeddings.ipynb | - |
+| `customer-service-bot-llm-course` | Assignment4_Customer_Service_Chatbot.ipynb | - |
+| `gpt-llm-course` | Assignment5_GPT.ipynb | - |
+| `final-project-llm-course` | FinalProject_Template.ipynb | - |
+
+Each notebook has an "Open in Colab" badge. Students fork via GitHub Classroom, not direct clone.
+
+**Submodule commands:**
+```bash
+git submodule update --init --recursive  # Clone submodules after fresh clone
+git submodule update --remote            # Pull latest from submodule remotes
+```
+
 ## WHERE TO LOOK
 
 | Task | Location | Notes |

assignments/AGENTS.md

@@ -0,0 +1,75 @@
+# ASSIGNMENTS KNOWLEDGE BASE
+
+**Parent:** [llm-course](https://github.com/ContextLab/llm-course) (see root AGENTS.md)
+
+## OVERVIEW
+
+Course assignments for PSYC 51.17. Contains web instruction pages and GitHub Classroom template repositories as submodules.
+
+## STRUCTURE
+
+```
+assignments/
+├── index.html              # Main assignments listing page
+├── assignment-1/           # ELIZA instructions (web page)
+├── assignment-2/           # SPAM Classifier instructions
+├── assignment-3/           # Wikipedia Embeddings instructions
+├── assignment-4/           # Customer Service Chatbot instructions
+├── assignment-5/           # Build GPT instructions
+├── final-project/          # Final Project instructions
+├── eliza-llm-course/           # [SUBMODULE] Template repo
+├── spam-classifier-llm-course/ # [SUBMODULE] Template repo
+├── embeddings-llm-course/      # [SUBMODULE] Template repo
+├── customer-service-bot-llm-course/ # [SUBMODULE] Template repo
+├── gpt-llm-course/             # [SUBMODULE] Template repo
+├── final-project-llm-course/   # [SUBMODULE] Template repo
+└── AGENTS.md               # This file
+```
+
+## TWO TYPES OF DIRECTORIES
+
+| Type | Pattern | Contents | Purpose |
+|------|---------|----------|---------|
+| Web pages | `assignment-X/` | `index.html` | Detailed instructions rendered from markdown |
+| Submodules | `*-llm-course/` | Notebooks, data files | GitHub Classroom templates students fork |
+
+## SUBMODULE DETAILS
+
+Each submodule is a separate GitHub repo under `ContextLab/`:
+
+| Submodule | Notebook | Data Files | Colab Badge |
+|-----------|----------|------------|-------------|
+| `eliza-llm-course` | Assignment1_ELIZA.ipynb | instructions.txt | Yes |
+| `spam-classifier-llm-course` | Assignment2_SPAM_Classifier.ipynb | training.zip | Yes |
+| `embeddings-llm-course` | Assignment3_Wikipedia_Embeddings.ipynb | - | Yes |
+| `customer-service-bot-llm-course` | Assignment4_Customer_Service_Chatbot.ipynb | - | Yes |
+| `gpt-llm-course` | Assignment5_GPT.ipynb | - | Yes |
+| `final-project-llm-course` | FinalProject_Template.ipynb | - | Yes |
+
+## CONVENTIONS
+
+- Web pages in `assignment-X/index.html` link to data files in submodules via `../eliza-llm-course/instructions.txt`
+- Each notebook has an "Open in Colab" badge at the top cell
+- Students fork via GitHub Classroom, not direct clone
+- Autograders are in private `ContextLabCourses/teaching-tools` repo
+
+## COMMANDS
+
+```bash
+git submodule update --init --recursive  # Initialize submodules after clone
+git submodule update --remote            # Pull latest from all submodules
+
+# To commit changes in a submodule:
+cd assignments/eliza-llm-course
+git add . && git commit -m "message"
+git push
+cd ../..
+git add assignments/eliza-llm-course
+git commit -m "Update eliza-llm-course submodule"
+```
+
+## ANTI-PATTERNS
+
+- Don't commit solution code to template repos
+- Don't modify data file formats (breaks student code)
+- Don't forget to push both submodule AND parent repo after changes