version: "1.0.0" name: agentic-storybook-development description: Develop, run, bundle, or troubleshoot the agentic-components Storybook app on macOS or Windows, including CocoaPods, Xcode, Metro, Fabric, and offline builds. license: MIT

Agentic Storybook development

Work on the native Storybook application in apps/storybook.

Workflow

1. Read the repository AGENTS.md, then the compact

agent map. Read the Storybook instructions and README only as needed for the task.

1. Inspect the Storybook package.json and run its declared workspace scripts; do not invent direct runner commands.
2. Use storybook-agent to query runtime story IDs, select stories, and sweep renderability. Reproduce the first

failure from the Storybook workspace so pnpm-linked React Native tooling resolves from the app.

1. Treat native workspaces, Pods, lockfiles, generated solutions, build directories, and DerivedData as disposable

outputs. Fix the owning manifest, Podfile, configuration, or script instead.

1. After dependency or workaround changes, regenerate the affected native dependency source and use a clean build so

stale output cannot produce a false success. When adding a codegen-enabled workspace dependency to existing macOS Pods, the first pod install can generate its spec without refreshing ReactCodegen's source list. If the clean build then reports a missing generated spec header, run pods:macos once more before changing native configuration.

1. Validate the JavaScript bundle and the affected native build. Run Storybook format/lint and the root build when

manifests or shared package references changed.

Keep component API, slot, token, and rendering work in the agentic-component-authoring skill; use this skill for the Storybook application and its native toolchains.