Skip to content

Module 02 / Lesson 08

Multi-Pass Collaboration

Plan, draft, test, and revise a real set of directions. See what each pass gives you to work with.

SanX InstructorIntroduction
Read the transcript

Introduction

In this lesson we’ll use four short passes to write directions to a school fair. You’ll see what changes after someone actually tries to follow them.

  1. Plan the route

    Imagine families are arriving at your school for the fair. They can find the main entrance, but they still need to get from there to the gym. Before we ask for directions, we need to be clear about who will use them and where they should end up. For our first pass, give the assistant three facts. Start at the main entrance, use the indoor hallway, and finish at the gym. Ask for an outline. This is where you decide what a good answer must cover so you have something to check in the next round.

  2. Draft from the plan

    For the next pass, ask the assistant to turn the route into directions that fit on a phone screen. It gives us two steps. Enter through the main entrance. Then turn left at the notice board and follow the hall to the gym. The notice board was in the notes we gave it. Read the draft as if you were coming here for the first time. It starts and finishes in the right places, and the turn sounds plausible. At this point, we can check that the draft follows the plan. To find out if a family can follow it, somebody has to try it.

  3. Watch someone try it

    Give the draft to someone who hasn’t seen the plan. They walk through the entrance and keep going straight. At the turn, the notice board is hard to see. They pass it and end up farther down the hallway. Now we know which part of the directions needs work. There’s a big clock above the same junction. For the next pass, give the assistant that observation and ask it to replace only the landmark. It changes the line to turn left at the big clock. The entrance and destination stay the same because the test showed that the turn was the problem.

  4. Verify the new directions

    Get someone else to try the new directions from the same entrance. They see the clock, turn left, and find the gym. That gives you a reason to trust the change. If they had missed the turn again, you’d use that new observation to decide what to try next. You can use the same approach in software. Agree on the goal, ask for one useful draft, watch what happens when somebody uses it, and make a specific revision. Each pass gives you information you can use in the next one.

Recap

Give each pass one job, and use what you learn to guide the next. Try the quick check to see what you’d change.

Listen to the audio only

Try it yourself

Someone misses the turn. What should the next request focus on?

Give each pass one job and use what you learn to guide the next.

Write a request a coding agent could use, then take the module quiz.

Try the module exerciseTake Module 02 quiz