building-with-medusa

Installation
Summary

Comprehensive guide for Medusa backend architecture, workflows, and critical implementation rules.

  • Covers six rule categories (architecture, type safety, business logic placement, imports, data access, file organization) with specific anti-patterns and enforcement checks
  • Enforces strict layer separation: Module → Workflow → API Route → Frontend, with workflows required for all mutations and only GET/POST/DELETE HTTP methods allowed
  • Includes critical data handling rules: prices stored as-is (not in cents), query.graph() for cross-module retrieval, query.index() for filtering across linked modules
  • Provides reference files for custom modules, workflows, API routes, module links, querying, authentication, error handling, scheduled jobs, and subscribers
  • Requires build validation after implementation and includes testing checklist with cURL examples for API route verification
SKILL.md

Medusa Backend Development

Comprehensive backend development guide for Medusa applications. Contains patterns across 6 categories covering architecture, type safety, business logic placement, and common pitfalls.

When to Apply

Load this skill for ANY backend development task, including:

  • Creating or modifying custom modules and data models
  • Implementing workflows for mutations
  • Building API routes (store or admin)
  • Defining module links between entities
  • Writing business logic or validation
  • Querying data across modules
  • Implementing authentication/authorization

Also load these skills when:

  • building-admin-dashboard-customizations: Building admin UI (widgets, pages, forms)
  • building-storefronts: Calling backend API routes from storefronts (SDK integration)
Related skills

More from medusajs/medusa-agent-skills

Installs
1.8K
GitHub Stars
162
First Seen
Jan 26, 2026