skills/vendix-core/SKILL.md
Vendix repository architecture, app boundaries, and cross-app guidance. Trigger: When understanding Vendix architecture, working across apps/libs, or deciding which specialized skill owns a pattern.
npx skillsauth add rzyfront/vendix vendix-coreInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use this skill as the architecture map for Vendix. It explains the major apps and ownership boundaries; detailed implementation rules live in specialized skills.
| Area | Path | Role | Primary Skills |
| --- | --- | --- | --- |
| Backend API | apps/backend | NestJS API, Prisma, domains, jobs, auth, tenant context | vendix-backend, vendix-prisma, vendix-multi-tenant-context |
| Frontend web | apps/frontend | Angular 20 admin/ecommerce web app | vendix-frontend-*, vendix-zoneless-signals, vendix-ui-ux |
| Mobile app | apps/mobile | Expo/React Native mobile app | Knowledge gap until mobile-specific skills are created |
| Shared types | libs/shared-types | Cross-app TypeScript type package | vendix-monorepo-workspaces |
| Skills | skills | Source of AI agent guidance | skill-creator, skill-sync |
apps/frontend must also use vendix-zoneless-signals.apps/backend must use backend/domain/Prisma skills that match the change.apps/mobile is a current knowledge gap unless a mobile-specific skill exists for the task.vendix-monorepo-workspaces.| Question | Owner |
| --- | --- |
| Where should a dependency be installed? | vendix-monorepo-workspaces |
| How does Angular web UI use Signals/Zoneless? | vendix-zoneless-signals |
| How are admin modules structured? | vendix-frontend-standard-module / vendix-frontend-module |
| How are backend domains/API endpoints built? | vendix-backend-domain / vendix-backend-api |
| How is tenant/store context resolved? | vendix-multi-tenant-context / vendix-prisma-scopes |
| How are Prisma schema/migrations handled? | vendix-prisma-schema / vendix-prisma-migrations |
| How are mobile-native patterns handled? | Knowledge gap until mobile skill exists |
Vendix has apps/mobile using Expo/React Native, but the current skill set is mostly backend and web frontend. When planning or editing mobile work, mark missing native-mobile guidance as a knowledge gap and propose a focused skill such as vendix-mobile or vendix-mobile-navigation.
vendix-monorepo-workspaces - Workspaces, dependencies, Docker, CI/CDvendix-app-architecture - Product app environments and domain behaviorvendix-backend - Backend API implementation patternsvendix-frontend - Frontend web overview or indexvendix-zoneless-signals - Critical Angular 20 Signals/Zoneless rulesdevelopment
Mobile app development rules for Vendix Expo/React Native project. Trigger: When editing, creating, or modifying any file under apps/mobile, or when developing mobile-specific features.
development
Feature gating by store subscription state: global store write guard, AI feature gate, Redis feature resolution, quota consumption, frontend paywall interceptor, banner, and subscription UI states. Trigger: When adding feature gates, paywalls, subscription-based access control, protecting store write operations, AI feature gates, or rollout flags.
testing
SaaS subscription billing for Vendix stores: plan pricing, invoices, Wompi platform payments, manual payments, partner commissions, payouts, proration, and dunning. Trigger: When creating SaaS invoices, working with partner rev-share, margin/surcharge pricing, invoice sequence allocation, partner payout batches, subscription payments, manual payments, or dunning flows.
development
Periodic quota counters with Redis, UTC period keys, Lua-based idempotent AI quota consumption, request-id deduplication, and post-success consumption. Trigger: When building quota counters, enforcing monthly/daily feature caps, or reusing AI quota patterns for uploads, emails, exports, or rate-limited features.