architecture-well-architected-commerce
Originally fromvtexdocs/ai-skills
Installation
SKILL.md
Well-Architected Commerce on VTEX
When this skill applies
Use this skill when the task is cross-cutting or decision-oriented across VTEX commerce capabilities — not when a single product skill already fully defines the work.
- Defining or reviewing solution architecture (storefront model + integrations + operations).
- Choosing between native VTEX capabilities and custom services (IO apps, external BFFs, middleware).
- Running an architecture or readiness review (security baseline, scalability posture, observability, delivery process).
- Scoping work that will span FastStore, Headless, VTEX IO, Marketplace, Payments and/or any other VTEX module.
Do not use this skill as a substitute for product skills when the task is already localized (e.g. “implement PPP refunds” → payment track; “Feed v3 vs Hook” → marketplace track).
Three pillars (framework)
These pillars are the Well-Architected Commerce lens for every architecture choice. Summaries below follow the internal framework narrative; for full objectives, core values, and critical areas of focus, use the Well-Architected Commerce MCP (and your program’s canonical framework document).