A UI PR that says “added Empty and Error stories” without a link is half-finished handoff. Reviewers open Storybook, guess the title, scroll the sidebar, and hope they found the right export. Agents are especially good at this omission: the stories file lands in the diff, the PR body stays a wall of prose.
I’ve started treating a Storybook permalink in the PR body as a merge requirement for agent UI work — same tier as “tests green.” One URL. Named story. Reviewers stop foraging.
What the link actually is
Storybook builds a stable story id from the component title and the story name. A story titled Forms/ShippingForm with export Empty becomes something like forms-shippingform--empty , and the manager URL looks like:
https://storybook.example.com/?path=/story/forms-shippingform--empty
Enter fullscreen mode
Exit fullscreen mode
That ?path=/story/<id> form is the permalink reviewers need.…