Comprehensive masterclass materials for teaching AI project leadership and decision-making frameworks.
- Review the structure: Read
PROJECT_STRUCTURE.mdto understand file organisation - Access instructor materials:
- Via website: Visit the companion site and click "π Instructor" (password:
instructor2025) - Via files: All guides are in
/instructor-materials/organised by activity
- Via website: Visit the companion site and click "π Instructor" (password:
- Prepare materials:
- Print facilitator quick reference (your day-of cheat sheet)
- Print student materials (cards, worksheets) from
/activities/materials/ - Review activity facilitation guides
- Build the website: Run
./scripts/render-all.shto generate all materials - Test locally: Open
docs/index.htmlin a browser
- Website: Access all materials at the companion website (hosted via GitHub Pages)
- Pre-readings: Available at the website before the course
- RetailFlow case study: Access the company simulation at retailflow.serveur.au
- Frameworks: Download reference materials from Resources menu
/activities/materials/ β Cards and cases used IN activities
/instructor-materials/ β Facilitation guides by activity (instructor-only)
βββ activity-1-pilot-scoping/
βββ activity-2-speed-dating/
βββ activity-3-crisis-management/
βββ activity-4-scale-pivot-kill/
/handouts/ β Reference materials students take home
/docs/ β Website files (auto-generated)
βββ index.html β Main companion site
βββ instructor.html β Password-protected instructor portal
βββ instructor/ β Rendered instructor materials
/retailflow-site/ β Company simulation website
βββ internal.html β Password-protected pilot data dashboard
/scripts/ β Build and utility scripts
See PROJECT_STRUCTURE.md for detailed explanation of the organisation logic.
Duration: 1 day (8 hours including breaks)
- Lecture (90 min) - Introduction and framework overview
- Morning Tea (30 min)
- Activity 1: Pilot Scoping (30 min working + 20 min debrief)
- Materials: Constraint cards, case brief
- Output: Pilot plan with success criteria
- Activity 2: Speed-Dating (40 min)
- Materials: Stakeholder role cards
- Output: Stakeholder mapping and communication strategies
- Lunch (45 min)
- Activity 3: Crisis Management (75 min)
- Materials: Crisis cards (3-4 scenarios)
- Framework: Diagnose β Decide β Communicate β Document
- Output: Crisis response plans
- Afternoon Tea (30 min)
- Debrief Crises (15 min)
- Activity 4: Scale/Pivot/Kill (45 min)
- Materials: Pilot data dashboard, original criteria
- Output: Scale/Pivot/Kill recommendation with rationale
- Wrap-up (30 min) - Action planning, Q&A
- Case: Scoping exercise worksheet
- Cards: Constraint cards (budget-cut, scope-creep, timeline-acceleration, vendor-lock-in)
- Handout: Project scoping framework
- Instructor guide:
instructor-materials/activity-1-pilot-scoping/
- Cards: 6 stakeholder role cards (CEO, CFO, Data Scientist, CS Manager, IT Security, End User)
- Handout: Stakeholder mapping template
- Instructor guide:
instructor-materials/activity-2-speed-dating/
- Cards: Crisis cards (data-quality, team-resistance, executive-pressure, ethical-dilemma)
- Handout: Crisis response framework (DDCD)
- Instructor guide:
instructor-materials/activity-3-crisis-management/
- Data: Pilot metrics dashboard (accessed via RetailFlow internal portal)
- Handout: Scale/Pivot/Kill decision framework
- Instructor guide:
instructor-materials/activity-4-scale-pivot-kill/
./scripts/render-all.shThis renders all .qmd files to HTML and PDF, then organizes them into the docs/ folder.
What gets rendered:
- Student materials β
docs/activities/,docs/handouts/ - Instructor materials β
docs/instructor/ - Slides β
docs/content/ - Pre-readings β
docs/pre-readings/
open docs/index.html- Ensure
docs/folder is committed to git - GitHub Pages settings: Deploy from
mainbranch,/docsfolder - Site will be live at:
https://[username].github.io/[repo-name]/
CONSTRAINT CARDS (/activities/materials/constraint-cards/)
- Used in: Activity 1 (Pilot Scoping)
- Represent: Planning challenges BEFORE pilot starts
- Examples: Budget cuts, scope creep, timeline pressure, vendor constraints
- Files:
budget-cut.qmd,scope-creep.qmd,timeline-acceleration.qmd,vendor-lock-in.qmd
CRISIS CARDS (/activities/materials/crisis-cards/)
- Used in: Activity 3 (Crisis Management)
- Represent: Issues that arise DURING live pilot
- Examples: Data quality, team resistance, executive pressure, ethical dilemmas
- Files:
data-quality.qmd,team-resistance.qmd,executive-pressure.qmd,ethical-dilemma.qmd
Don't mix them up! Constraints are for planning; crises are for simulation.
Student materials (concise, 1-2 pages):
- Location:
/handouts/and/activities/materials/ - Purpose: Quick reference during and after course
- Access: Via companion website Resources menu
Instructor materials (detailed, 10+ pages):
- Location:
/instructor-materials/(organized by activity) - Purpose: Facilitation guides, sample answers, teaching notes
- Access: Via instructor portal (password-protected)
Both exist for the same frameworks, just different detail levels.
Access: Click "π Instructor" in companion site navigation
Password: instructor2025
What's included:
- Facilitator quick reference (PRINT THIS!)
- Activity facilitation guides (all 4 activities)
- Framework walkthroughs
- Sample answers and assessment rubrics
- Feedback from previous deliveries
Main site: retailflow.serveur.au
- Company overview, staff bios, products
- Provides context for all activities
Internal portal: retailflow.serveur.au/internal
- Password:
pilot2024 - Contains Week 6 pilot data dashboard
- Used in Activity 4 (Scale/Pivot/Kill)
Never edit files in /docs/ directly - they're auto-generated.
- Edit: Files in
/activities/,/handouts/,/content/,/instructor-materials/ - Render: Run
./scripts/render-all.sh - Output: Appears in
/docs/
- Check Quarto is installed:
quarto --version - Ensure you're in the project root directory
- Run:
./scripts/render-all.sh(note: script is now in scripts/ folder) - Check .qmd files have valid YAML headers
- Re-run render script:
./scripts/render-all.sh - Check file names match links in
docs/index.html - Verify files were generated in
docs/folders
- Check source file exists in
/activities/materials/ - Re-run render script
- Check for errors in Quarto YAML headers
- Verify file naming (lowercase, no prefixes)
- Check
docs/instructor.htmlexists - Verify password:
instructor2025 - Clear browser cache and try again
- Check password:
pilot2024 - Verify
retailflow-site/internal.htmlexists - Clear browser cache
- PROJECT_STRUCTURE.md - Detailed organisation guide (read this!)
- scripts/render-all.sh - Build script for generating website
- instructor-materials/README.qmd - Instructor materials guide
For detailed explanations of:
- Folder organisation logic β See
PROJECT_STRUCTURE.md - Activity delivery structure β See
PROJECT_STRUCTURE.md> "Activity Delivery Map" - File naming conventions β See
PROJECT_STRUCTURE.md> "File Naming Conventions" - Adding new materials β See
PROJECT_STRUCTURE.md> "Common Tasks" - Instructor materials β See
instructor-materials/README.qmd
This masterclass was developed for Curtin University.
Last updated: October 30, 2024