# Contributor handoff — storybookjs/storybook

> Canonical page: https://codevetter.com/unpack/storybook/agent-handoff

# Contributor handoff — storybookjs/storybook

Scanned commit dc9b30e8fd8a71383ec01b9510f38bee51457e8a (2026-10-02). Generated by codevetter codevetter 1.15.0 on 2026-10-02.

Source inspection; upstream code and tests were not executed.

Use this report as a source map for the pinned commit, then recheck checkout-specific instructions and implementation before editing. Tests and CI were inspected, not executed; verification commands below are guidance for subsequently authorized implementation work. Investigation covered more than twelve implementation files and three concrete flows, but remains bounded rather than exhaustive. Keep edits within the owning package and preserve contracts across server, manager, preview, and agent transports.
- AGENTS.md is canonical and CLAUDE.md is a reference; start core/preset/service/tools work with the architecture guide and read the linked testing/sandbox/task guides when relevant. — [AGENTS.md#L3-L5](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/AGENTS.md#L3-L5) [CLAUDE.md#L1-L1](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/CLAUDE.md#L1-L1) [AGENTS.md#L202-L213](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/AGENTS.md#L202-L213)
- The contributor environment pins Node 22.22.3 and Yarn 4.18.0 with node-modules linking; prefer existing NX compile/check targets and non-production configurations during routine iteration. — [.nvmrc#L1-L1](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/.nvmrc#L1-L1) [.yarnrc.yml#L20-L26](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/.yarnrc.yml#L20-L26) [.yarnrc.yml#L43-L43](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/.yarnrc.yml#L43-L43) [AGENTS.md#L23-L42](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/AGENTS.md#L23-L42)
- For later authorized validation, use focused yarn test patterns for utilities and stories with play functions for React behavior; tools attachment E2E requires the running internal UI from the same checkout. — [AGENTS.md#L108-L119](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/AGENTS.md#L108-L119) [code/core/src/cli/tools/README.md#L102-L108](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/code/core/src/cli/tools/README.md#L102-L108)
- After authorized edits, repository guidance requires oxfmt formatting from code/, targeted oxlint checks, explicit relative module extensions, and Storybook server/client loggers. — [AGENTS.md#L123-L138](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/AGENTS.md#L123-L138)
- Before changing agent operations, read the open-service and tools contracts; keep services/toolsets under the same gate, and preserve the distinction between thrown execution failures and returned ok:false outcomes. — [.agents/guidelines/architecture.md#L86-L100](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/.agents/guidelines/architecture.md#L86-L100) [code/core/src/shared/open-service/README.md#L119-L132](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/code/core/src/shared/open-service/README.md#L119-L132) [code/addons/vitest/src/preset.ts#L68-L82](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/code/addons/vitest/src/preset.ts#L68-L82)
- Avoid broad assumptions about CSF mutation: the preferred shared API exposes changed/mutationDiagnostics, while the Controls save implementation explicitly rejects arrow/call CSF2 forms except recognized CSF4 story calls. — [.agents/guidelines/architecture.md#L73-L82](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/.agents/guidelines/architecture.md#L73-L82) [code/core/src/core-server/utils/save-story/update-args-in-csf-file.ts#L14-L22](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/code/core/src/core-server/utils/save-story/update-args-in-csf-file.ts#L14-L22)
- Do not default to yarn start or untemplated yarn task dev; generated sandboxes belong beside the checkout, and accidental generated manager export changes should be excluded from unrelated diffs. — [AGENTS.md#L140-L158](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/AGENTS.md#L140-L158) [AGENTS.md#L180-L180](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/AGENTS.md#L180-L180)
- PRs target next and require Area: Summary plus Manual testing metadata; Danger evaluates trusted base-branch code, and the manually triggered NX workflow should not be mistaken for evidence of automated checks passing. — [AGENTS.md#L99-L106](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/AGENTS.md#L99-L106) [.github/workflows/danger-js.yml#L73-L83](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/.github/workflows/danger-js.yml#L73-L83) [.github/workflows/nx.yml#L3-L7](https://github.com/storybookjs/storybook/blob/dc9b30e8fd8a71383ec01b9510f38bee51457e8a/.github/workflows/nx.yml#L3-L7)

Every claim links to its cited files at the pinned commit. Citations identify source evidence; they do not establish runtime correctness. Independent CodeVetter scan — not reviewed by upstream maintainers.

## Public product links

- [CodeVetter](https://codevetter.com/)
- [Download](https://codevetter.com/download)
- [Documentation](https://codevetter.com/docs/)
- [Source](https://github.com/Codevetter/codevetter)