architecture-well-architected-commerce

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).

Technical Foundation