| name | sync-course |
| description | Use when weekly topics, dates, due dates, or course structure have been modified — verifies all course artifacts (schedule, readings, timeline, website, slides, projects) are consistent with each other |
Sync Course
Overview
Verify that all course artifacts agree on weekly topics, due dates, and structure. Catches drift caused by updating one file but forgetting others.
When to Use
- After changing weekly topics, module names, or due dates
- After adding/removing weeks or restructuring the schedule
- After modifying readings, slides, or project specs
- Periodically as a sanity check before deploying
Artifacts to Check
| Artifact | File | Key fields |
|---|
| Schedule | course/schedule.md | Module names, topics, deliverables per week |
| Readings | course/readings.md | Week headers, summary table at bottom |
| Course Memory | course/COURSE_MEMORY.md | Schedule table (~line 100), key dates (~line 1460) |
| Timeline | website/timeline.js | weeklyFocus entries, totalWeeks, phase ranges, project endWeek |
| Website table | website/index.pug | Schedule table rows, readings accordion sections |
| Slides | slides/XX_*/index.md | course-week span, title, "What We'll Cover" |
| Projects | course/projects/*.md | Due dates (line ~4 of each) |
Verification Steps
- Extract week count: Read
totalWeeks from timeline.js, count rows in schedule.md table, count weeks in pug table. All must match.
- For each week with a slide deck: Compare the module name in
schedule.md vs the slide title vs weeklyFocus[N].topic vs the pug table row.
- Check key dates: P1/P2/P3 due weeks and HW due weeks must match across
schedule.md, COURSE_MEMORY.md, timeline.js (project endWeek), index.pug badges, and projects/*.md.
- Check readings alignment: Each week header in
readings.md should match the module name in schedule.md. The summary table at the bottom of readings.md must include all lecture weeks.
- Flag missing slide decks: Any lecture week (not Spring Break, not Finals) without a
slides/XX_*/ folder.
Output Format
## Course Sync Report
### Mismatches Found
| Week | File A | File B | Field | A says | B says |
|------|--------|--------|-------|--------|--------|
### Missing Content
- [ ] Week X: No slide deck at slides/XX_*/
### Summary
X weeks checked, Y mismatches, Z missing items
Common Drift Patterns
- Updated
schedule.md but forgot readings.md week headers or summary table
- Changed due date in one file but not
timeline.js project endWeek
- Renamed a module in schedule but slide title still shows old name
- Added a new week to schedule but no
weeklyFocus entry in timeline.js
- Updated pug schedule table but forgot the readings accordion
