---
name: Lab Scaffolding
slug: lab-scaffolding
category: Writing
description: Lab Scaffolding helps design hands-on labs, projects, and capstones with the right level of guidance. Use it to set difficulty, create starter code, and plan self-directed learning paths.
github: "https://github.com/revfactory/harness-100/tree/main/en/08-course-builder/.claude/skills/lab-scaffolding"
stars: 1224
forks: 427
install: "npx degit https://github.com/revfactory/harness-100/tree/main/en/08-course-builder/.claude/skills/lab-scaffolding ~/.claude/skills/lab-scaffolding"
installs_to: ~/.claude/skills/lab-scaffolding
source_path: en/08-course-builder/.claude/skills/lab-scaffolding/skill.md
collection_size: 51
category_size: 1012
collection_url: "https://dirskills.com/collections/revfactory/harness-100"
added: 2026-08-12T04:43:20.909Z
last_synced: 2026-08-12T04:43:20.909Z
canonical_url: "https://dirskills.com/skills/lab-scaffolding"
---

# Lab Scaffolding

Lab Scaffolding helps design hands-on labs, projects, and capstones with the right level of guidance. Use it to set difficulty, create starter code, and plan self-directed learning paths.

**Install:**

```bash
npx degit https://github.com/revfactory/harness-100/tree/main/en/08-course-builder/.claude/skills/lab-scaffolding ~/.claude/skills/lab-scaffolding
```

## README

# Lab Scaffolding — Lab Scaffolding Methodology

Expert knowledge used by the lab-designer agent when designing hands-on assignments and projects.

## Why Scaffolding

If you tell learners "build a program" without support, 90% will give up. **Scaffolding** is the strategy of gradually providing support for what learners cannot do alone, then reducing support as their ability grows.

## Five-Level Lab Pyramid

```
          /\
         / 5 \  <- Capstone Project (open-ended)
        /-----\
       /   4    \  <- Mini Project (minimal guidance)
      /-----------\
     /      3       \  <- Challenge (hints provided)
    /-----------------\
   /        2          \  <- Guided Lab (step-by-step)
  /---------------------\
 /          1            \  <- Follow-Along (code walkthrough)
/---------------------------\
```

### Design by Level

| Level | Learner Autonomy | Support Level | Lab Format |
|-------|-----------------|---------------|-----------|
| **1. Follow-Along** | 0% | 100% guided | Type instructor's code verbatim |
| **2. Guided Lab** | 20% | 80% guided | Starter code + fill in the blanks |
| **3. Challenge** | 50% | Hints only | Requirements -> Hints -> Verification |
| **4. Mini Project** | 80% | Spec only | Feature requirements -> free implementation |
| **5. Capstone** | 95% | Mentoring only | Choose topic -> Design -> Implement -> Present |

## 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

```python
"""
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

| Situation | Strategy |
|-----------|---------|
| Learner is stuck | Hint 1 (direction) -> Hint 2 (specific) -> Hint 3 (partial code) -> Full solution |
| Too easy for learner | Add constraints, optimization challenges |
| Wide skill gap among learners | Separate required/optional tasks; assign mentoring roles to advanced learners |

### 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

| Course Type | Recommended Environment | Reason |
|------------|------------------------|--------|
| Programming Intro | Browser IDE (Replit, Google Colab) | Start instantly without installation |
| Web Development | GitHub Codespaces / Gitpod | Consistent environment guaranteed |
| Data Analysis | Google Colab / Kaggle Notebooks | GPU access, dataset hosting |
| Systems/Infrastructure | Docker + scripts | Reproducible environment |