Lab Scaffolding

Starter Code Design

Starter Code Principles

1. Runnable state: Starter code must execute without errors as-is
2. TODO markers: Clearly mark where learners should write code
3. Remove boilerplate: Pre-write code unrelated to learning objectives
4. Progressive disclosure: Provide more code early on, bare files later

Starter Code Template

"""
Lab: [Lab Title]
Learning Objective: [Skills to practice in this lab]
Estimated Duration: XX minutes
Difficulty: [1-5]
"""

# === Pre-written code (do not modify) ===
import flask
app = flask.Flask(__name__)

# === TODO 1: [Specific instruction] ===
# Hint: [Related concept or method to use]
# Expected lines of code: X


# === TODO 2: [Specific instruction] ===
# Hint: [Related concept or method to use]


# === Tests ===
# If the code below runs without errors, you've succeeded
if __name__ == "__main__":
    # Automated verification code
    pass

Capstone Project Design

Capstone Structure Template

## Capstone Project: [Title]

### Overview
[Purpose of the project and description of final deliverable]

### Learning Objective Mapping
This project comprehensively assesses the following learning objectives:
- [LO1]: [Learning objective]
- [LO2]: [Learning objective]
- ...

### Functional Requirements
#### Must Have
1. [Feature 1]
2. [Feature 2]
3. [Feature 3]

#### Nice to Have — Bonus Points
1. [Additional feature 1]
2. [Additional feature 2]

### Milestones
| Week | Deliverable | Checkpoint |
|------|------------|-----------|
| Week 1 | Design document + wireframes | Mentor review |
| Week 2 | Core feature prototype | Working demo |
| Week 3 | Full feature implementation | Code review |
| Week 4 | Testing + documentation + presentation | Final submission |

### Rubric
[Reference assessment-engineering skill rubric]

### Reference Resources
- [Related lesson links]
- [Official documentation links]
- [Example projects (reference only, no copying)]

Capstone Topic Design Rules

1. Real-world problems: Have learners build something they can actually use
2. Appropriate scope: Completable in 2-4 weeks
3. Learning objective integration: Must use all core skills taught in the course
4. Scalable: Required features are achievable; bonus features adjust difficulty
5. Portfolio value: The finished product should be resume-worthy

Difficulty Calibration Techniques

Dynamic Difficulty Adjustment

Hint System Design

[Attempt without hints] -> After 5 min
[Hint 1: Direction] "This problem uses the ~ concept" -> After 5 min
[Hint 2: Approach] "Look up the ~ method" -> After 5 min
[Hint 3: Code skeleton] "The structure looks like this: ..." -> After 5 min
[Full solution + explanation]

Recommended Lab Environments