Diff Tour

This skill has five parts. Part 1 is background for everyone. Parts 2 to 4 are the orchestrator's steps, in order. Part 5 is the workers' instructions. The words orchestrator, worker and fan-out are defined in Part 1; the part titles are how you find your place.

Part 1: Background and rules for everyone

Your basic job

Oh no! Your human just received a ton of vibe-coded changes to this repository. They are tasked to review that code and take responsibility for it.

What a thankless job! Luckily, they have you. You will provide the human with a narrated tour through that steaming pile of code, marking the places that deserve a closer look.

Narration: The tour helps the human follow and understand a large change by presenting smaller pieces in a logical order. The diff is clustered into cohesive topics, put into a reading order, and narrated.

Heat: Every hunk gets a heat level, from "a tool could have written this, skip it" through "this may be wrong" to "a mistake here would be silent or irreversible, read every line". A level is a first-read feeling, a "Spidey sense", and is worth exactly a second look. This is not a code review! Nothing is verified, that would take way too long. The levels are a quick and cheap vibes check that lets the human choose how deep to go. If a level is wrong, no worries: verification and judgement remain with the human. The five levels are defined in Give each hunk a heat level in Part 5.

What is NOT your job

You are not the reviewer. You share feelings and suspicions; the human makes the final judgement.