Skip to content

feat: adjust ai entrypoint - #2873

Merged
noahwaldner merged 4 commits into
mainfrom
feat/ai-entrypoint
Oct 8, 2026
Merged

noahwaldner merged 4 commits into
mainfrom
feat/ai-entrypoint

Conversation

@noahwaldner

@noahwaldner noahwaldner commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

Stacked on #2872. Review that one first.

One entry point for agents: the skill and the SDK

#2872 makes the Fondue SDK and agent skill public. This PR removes the old way agents read Fondue docs (the hosted Storybook MCP) and points agents that connect to it to the skill and SDK.

Why replace the MCP with the skill + SDK

  • Matches the installed version: the MCP served docs from the deployed Storybook, i.e. whatever is on main. The SDK ships inside @frontify/fondue, so agents read the props, tokens and guides of the version the project actually depends on
  • Covers all of Fondue: the MCP only knew the components Storybook's manifest. The SDK covers components, icons, design tokens (incl. Tailwind classes and utilities) and all guides in one graph
  • Faster: queries run locally in Node against bundled data. The MCP fetched the 1.4 MB components manifest from the Storybook on every request
  • Works with any agent: the skill runs plain node commands, so any agent that can run a shell can use it, no MCP client config needed

/llms.txt

  • The docs Storybook now serves /llms.txt (plus an /agents.txt alias)
  • Content: a short "don't scrape this Storybook" intro, the full sdk/Usage guide (skill install + SDK usage) and a list of all guide ids
  • Generated at build time from @frontify/fondue-sdk by storybook-docs/scripts/generateLlmsTxt.mjs, so it always matches the guide. Hooked into generate:guides and shipped through staticDirs; output is gitignored

Deprecated MCP at /mcp

  • Replaced the @storybook/mcp handler with a dependency-free stub, so existing client configs don't break silently
  • Every tool call returns the notice: install the skill (npx skills add frontify/fondue/packages/sdk), remove the MCP and read /llms.txt

How to test

  1. Start the storybook-docs storybook
  2. Open http://localhost:6010/llms.txt and http://localhost:6010/agents.txt
  3. Run the MCP stub locally from the repo root:
    netlify functions:serve --offline --filter @frontify/fondue-storybook-docs --functions netlify-functions --port 9999
  4. Connect a client to it (claude mcp add --transport http fondue-deprecated http://localhost:9999/mcp) and ask about Fondue components. The agent should get the deprecation notice and the skill install command

@noahwaldner
noahwaldner added this pull request to stack #2874 October 6, 2026 13:57
@changeset-bot

changeset-bot Bot commented Oct 6, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 6f5ad53

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages
Name Type
@frontify/fondue-components Patch
@frontify/fondue Patch
@frontify/fondue-sdk Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@noahwaldner noahwaldner changed the title feat/ai entrypoint feat: adjust ai entrypoint Oct 6, 2026
@netlify

netlify Bot commented Oct 6, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for fondue-components ready!

Name Link
🔨 Latest commit 6f5ad53
🔍 Latest deploy log https://app.netlify.com/projects/fondue-components/deploys/6ac74d258913f100085deab0
😎 Deploy Preview https://deploy-preview-2873.components.fondue-components.frontify.com
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@noahwaldner
noahwaldner marked this pull request as ready for review October 6, 2026 14:05
@noahwaldner
noahwaldner requested a review from a team as a code owner October 6, 2026 14:05
@noahwaldner
noahwaldner requested a review from jcosta33 October 6, 2026 14:05
@noahwaldner
noahwaldner marked this pull request as draft October 6, 2026 15:04
@noahwaldner
noahwaldner marked this pull request as ready for review October 6, 2026 15:11
Base automatically changed from feat/sdk-improvements to main October 6, 2026 15:56
noahwaldner and others added 3 commits October 8, 2026 09:38
Generate /llms.txt (and an /agents.txt alias) from the SDK usage guide so
agents landing on the docs site are pointed at the Fondue skill and SDK.
Replace the hosted Storybook MCP with a stub that answers every request
with a deprecation notice linking to /llms.txt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The hosted Storybook MCP was the only consumer of the Storybook-generated
manifests/components.json. Agents now use the Fondue skill and SDK, which
read the package's own dist/manifests instead.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@noahwaldner
noahwaldner merged commit 9e83eee into main Oct 8, 2026
31 of 32 checks passed
@noahwaldner
noahwaldner deleted the feat/ai-entrypoint branch October 8, 2026 08:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants