diff --git a/README.md b/README.md
index b8174eb..40f058a 100644
--- a/README.md
+++ b/README.md
@@ -15,7 +15,7 @@ Go top to bottom. The full map with every link is [docs/README.md](docs/README.m
 
 1. Levels, hand-built to capstone: [hand-built](docs/levels/hand-built.md), [boundary](docs/levels/boundary.md), [context](docs/levels/context.md), [skills](docs/levels/skills.md), [execution](docs/levels/execution.md), [verification](docs/levels/verification.md), [delivery](docs/levels/delivery.md), [sharing](docs/levels/sharing.md), [workflows](docs/levels/workflows.md), [capstone](docs/levels/capstone.md). Each ends with `make prove LEVEL=<name>`.
 2. Software Factory modules, F0 overview to F13 spend and safety: start at [f0-overview](docs/factory/f0-overview.md), then follow F1 to F13 in [docs/README.md](docs/README.md#2-software-factory-modules-f0-to-f13). Try it with `make factory ISSUE=1 FLAGS=--dry-run`.
-3. Labs, noob to advanced, lanes `start`, `daily`, `team`, `factory`, `advanced`: `make next` shows the next lab, `make lab` runs its proof, `make lab HINT=1` reveals a hint, `make progress` shows the lane map. See [docs/labs/README.md](docs/labs/README.md).
+3. Labs, noob to advanced, lanes `start`, `daily`, `team`, `factory`, `advanced`. Pick your workshop once with `make lab PATH_ID=pro` (Claude Code, beginner to pro) or `make lab PATH_ID=factory` (Software Factory). Then `make next` shows the next lab, `make lab` runs its proof, `make lab HINT=1` reveals a hint, `make progress` shows the lane map. Each lane has a step-by-step walkthrough: [start](docs/labs/walkthrough-start.md), [daily](docs/labs/walkthrough-daily.md), [team](docs/labs/walkthrough-team.md), [advanced](docs/labs/walkthrough-advanced.md). See [docs/labs/README.md](docs/labs/README.md).
 4. Cloud sessions: [F11](docs/factory/f11-cloud-sessions.md) runs the factory away from your laptop, then [F12 model routing](docs/factory/f12-model-routing.md) and [F13 spend and safety](docs/factory/f13-spend-and-safety.md).
 5. Agent track and electives: [docs/README.md](docs/README.md#5-agent-track).
 6. After the workshop: [take-home](docs/take-home.md).
diff --git a/docs/README.md b/docs/README.md
index 3dff1fd..1a925d5 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,6 +1,6 @@
 # Workshop map
 
-One app, Worksheet Studio, learned in a straight line: the levels, then the Software Factory modules, then the labs that make you do each step. Take each part in order.
+One app, Worksheet Studio, with two workshops: Claude Code, beginner to pro, and the Software Factory. Both share the levels and the labs. Pick yours with `make lab PATH_ID=pro` or `make lab PATH_ID=factory`, then take its parts in order.
 
 ## Set up
 
@@ -51,9 +51,10 @@ The same path as a ticket-to-merge pipeline. Questions: [factory FAQ](factory/fa
 
 ## 3. Labs, noob to advanced
 
-The labs are hands-on, one goal and one proof each. Full table and rules: [labs](labs/README.md). Progress sits in `.labs/`, which git ignores.
+The labs are hands-on, one goal and one proof each. Full table and rules: [labs](labs/README.md). Step-by-step walkthroughs: [start](labs/walkthrough-start.md), [daily](labs/walkthrough-daily.md), [team](labs/walkthrough-team.md), [advanced](labs/walkthrough-advanced.md). Progress sits in `.labs/`, which git ignores.
 
 ```
+make lab PATH_ID=pro   choose your workshop once (pro or factory)
 make progress          the lane map with a bar per lane
 make next              show the next lab without running anything
 make lab               show the current lab, run its proof, record a pass
diff --git a/docs/labs/README.md b/docs/labs/README.md
index 06fd1d0..3f89e3d 100644
--- a/docs/labs/README.md
+++ b/docs/labs/README.md
@@ -7,6 +7,8 @@ Two workshops share this folder. Pick yours once with `make lab PATH_ID=pro` or
 - **Claude Code, beginner to pro** (`PATH_ID=pro`): the `start`, `daily`, `team` and `advanced` lanes.
 - **Software Factory** (`PATH_ID=factory`): the `start`, `daily` and `factory` lanes.
 
+Each lane has a walkthrough that follows every step with the command, what you should see and why: [start](walkthrough-start.md), [daily](walkthrough-daily.md), [team](walkthrough-team.md), [advanced](walkthrough-advanced.md).
+
 ## Help fades as you go
 
 Every lab declares `**Help:** guided`, `hinted` or `goal`, and the path gets harder on purpose.