| name | rebuild-restart-storybook |
| description | Rebuild and restart the internal Storybook UI after changes to internal Storybook code (core, addons, frameworks, renderers, libs, etc.), then optionally display a UI review. Use after editing any package in the Storybook monorepo's code/ directory, or when the user asks to rebuild and/or restart Storybook. |
| allowed-tools | Bash, Read |
Rebuild and Restart Storybook
After making changes to internal Storybook code (core, addons or otherwise), follow this workflow.
Step 1: Ask whether to rebuild and restart (in case of model invocation)
Unless the user explicitly ran /rebuild-restart-storybook, ask the user whether they want to rebuild and restart Storybook. If they decline, stop here.
Step 2: Determine modified packages
Build a space-separated list of the monorepo packages that were modified in the conversation. For each modified package, find its Nx project name in the project.json file in that package's directory (the name field), not the package.json name.
For example, if code/addons/review and code/addons/vitest were modified, the list is addon-review addon-vitest.
Step 3: Run the build and start commands in sequence
Run these in the code directory, in order. Substitute <extra packages> with the list from Step 2.
rm -rf node_modules/.cache
yarn
yarn build storybook <extra packages>
Then, run in the background:
NODE_OPTIONS="--preserve-symlinks" yarn storybook:ui --no-open
Handle an occupied port
A Storybook may already be running. If the port is occupied, cancel the start, kill the old process to free the port, then start Storybook again.
Step 4: Provide the URL and ask about a review
Once Storybook has started, give the user the URL. Then ask whether they want to display a review.
Step 5: Display the review
If the user wants a review, use Storybook's review-create MCP tool to create a UI review of relevant stories. Pick a set of stories related to the entirety of the conversation so far.
If there are no relevant stories because no UI elements were touched, ask the user what they would like to see a review for.
