Convex DDD Architecture

Reference skill for organizing Convex projects with DDD and Hexagonal architecture. It keeps domain logic isolated from database and external API concerns so changes remain local and safer to evolve.

When to Use

Use this skill when work includes one or more of these signals:

• New Convex sub-domain design (schema, queries, mutations, domain, adapters)
• Legacy Convex code migration toward DDD/Hexagonal boundaries
• Business rules drifting into handlers instead of aggregates
• Direct ctx.db access spreading outside repositories
• External API calls requiring retries, orchestration, or translation layers
• Team-level need for consistent file layout and naming in Convex projects
• Choosing or refactoring identifiers (variables, functions): domain nouns on exports/models; shorter names inside modules/functions where scope already disambiguates (naming.md)

Do not use this as a strict template for tiny prototypes where speed matters more than architectural boundaries.

Project Shape