Skip to content

feat(plugin): add storefront standards for coding agents#387

Draft
blurrah wants to merge 4 commits into
mainfrom
blurrah/build-storefront-skill
Draft

feat(plugin): add storefront standards for coding agents#387
blurrah wants to merge 4 commits into
mainfrom
blurrah/build-storefront-skill

Conversation

@blurrah

@blurrah blurrah commented Jun 26, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • add a build-storefront skill covering rendering dependencies, cache ownership, Suspense boundaries, Server and Client Components, mutations, and commerce-flow verification
  • provide focused guidance for home, collection, search, product, cart, and account work without prescribing visual composition
  • make Shopify AI Toolkit authoritative for Shopify API facts and validation
  • reduce shopify-graphql-reference to Vercel Shop integration guidance and remove the redundant schema wrapper
  • align Shopify CMS caching, invalidation guidance, documentation, and rollout metadata

Why

Coding agents should be able to redesign or extend Vercel Shop freely while preserving production-grade commerce architecture.

These skills capture the standards behind the template: non-blocking rendering, coherent caching, narrow client boundaries, correct mutations, and end-to-end commerce behavior, without constraining the resulting visual design.

Shopify API knowledge remains owned and validated by Shopify AI Toolkit. Vercel Shop owns how validated operations integrate with Next.js and Vercel.

No template routes or presentation components are removed or replaced.

Validation

  • pnpm --filter docs lint
  • pnpm --filter docs typecheck
  • pnpm --filter docs build
  • official skill validation for build-storefront, shopify-graphql-reference, and enable-shopify-cms
  • storefront audit: 0 errors, 6 existing Next.js image-priority review items

@vercel

vercel Bot commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
shop-docs Ready Ready Preview, Comment Jun 28, 2026 1:46pm
shop-template Ready Ready Preview, Comment, Open in v0 Jun 28, 2026 1:46pm

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.

1 participant