Skip to content

Engineering Standard v3.1

Core rules

  1. Request path: route → handler → service → repository → db
  2. Domain surface: each domain exposes one index.ts
  3. Dependency direction: ai → document → workflow → identity → tenant
  4. New packages: only when code is used 3+ times

Naming

  • Files: kebab-case
  • React components: PascalCase
  • TypeScript: classes PascalCase, functions/variables camelCase, constants UPPER_SNAKE_CASE
  • Zod schemas: <action><Entity>Schema
  • Hooks: use prefix

Cloudflare resources

<org>-<product>-<resource>-<domain>-<env>

Testing

  • Unit/integration: co-located *.test.ts
  • E2E: tests/e2e/ only

Full rules

See .cursor/rules/ in each repository for the complete Engineering Standard files.