🧭 How Clean Code Dojo works
A quick guide to every step of the session — from creating it to explaining a principle on the Demystifying Poster.
🚀 Creating a session
On the landing page, the trainer picks a session name, the number of teams,
and a deck of cards. This creates a throwaway instance reachable at a link
like …/i/clean-code-march — no login required for anyone.
🏠 Instance Overview
The overview page lists one button per team (each opens that team's own Card Board) plus one button to the shared Demystifying Poster. Share the overview link and each team opens their own Group button.
🎴 The Card Board — sorting the cards
Cards are drawn one at a time from the deck. For each card, the team discusses and rates it into one of three areas:
There are two ways to rate a card:
- Drag the card from the deck straight into a red/yellow/green area, or
- Click one of the colour buttons below it.
Either way rates the card and automatically shows the next one — the traffic-light "✕" marks the chosen area on the card itself. Changed your mind about an already-rated card? Drag it between areas to re-rate it; the "✕" moves with it.
Round 2 — Knowledge Transfer. Once every card has a rating, the team revisits only the red and yellow cards, discusses them further, and makes a final call. The same rating options from round 1 are still available, plus a way to confirm a card unchanged:
- Drag the staged card from the deck straight into a red/yellow/green area, or
- Click one of the colour buttons below it, or
- Drag it into a different area to change its rating, or
- Drag it back into its own area to confirm the rating unchanged.
Any of these counts as reviewed and moves the team on to the next flagged card.
✓ Done. Once the team has finished, they click ✓ Done so the trainer can see their progress on the Trainer Board.
📋 The Demystifying Poster
The poster is a matrix: rows are the deck's principles, columns are the teams. A card appears in a row only if that team flagged it red or yellow — green (well understood) cards never appear. Each row has one name field: the first person to type their name claims that principle to explain to the group.
| # | Group 1 | Group 2 | Name |
|---|---|---|---|
| 6 | 🟥 | 🟨 | Anna |
| 7 | — | — | — |
Claimed a row by mistake? An unclaim button releases it again so someone else can sign up.
🎛️ Trainer Board
The trainer controls when participants may open the poster:
Switch ON / Switch OFF toggles poster access for everyone, live.
The Trainer Board also shows each team's live progress — how many cards are sorted in round 1, how many red/yellow cards are revisited in round 2, and whether the team has clicked Done — plus a read-only preview of the poster itself.