
Colombian accounting rules for Vendix automatic entries: PUC account selection, debit/credit direction, payroll provisions, parafiscales, mapping-key ownership, and validation of balanced journal entries. Trigger: When working with journal entries, mapping keys, PUC accounts, payroll provisions, parafiscales, or any debit/credit logic.
Automatic journal entry system: event-driven accounting, AutoEntryService, AccountingEventsListener, account mapping cascade, and mapping-key sync. Trigger: When adding automatic accounting flows, modifying auto-entry logic, adding mapping keys, or debugging missing journal entries.
Vendix app environments, public/private web apps, mobile app boundary, and domain/app type resolution. Trigger: When asking about different apps, environments (VENDIX_ADMIN, ORG_ADMIN, STORE_ADMIN, STORE_ECOMMERCE), mobile boundaries, or domain logic.
Business discovery for Vendix changes that directly affect the app's economic activity. Trigger: When the user explicitly requests business analysis, or when a change requires decisive business rules about the app's direct economic activity before how-to-plan.
AI streaming patterns with provider AsyncGenerators, AIEngineService.runStream, NestJS SSE endpoints, Angular EventSource wrappers, and streaming UI components. Trigger: When implementing streaming AI responses, working with SSE endpoints, or creating streaming UI components.
Backend authentication and authorization patterns: global JWT guard, public/optional auth, roles, permissions, and request user shape. Trigger: When implementing authentication, editing auth guards/decorators, or protecting backend endpoints.
Bruno API testing patterns for Vendix collections, request files, auth inheritance, DTO-aligned payloads, post_response scripting, and pragmatic assertions. Trigger: When creating API tests, editing .bru files, or verifying endpoints.
Deprecated legacy development rules. Trigger: Do not auto-invoke; use how-to-dev for development execution.
Checkout flow for STORE_ECOMMERCE: cart, shipping, payment methods, Wompi, WhatsApp checkout, bookings, and stock reservations. Trigger: When implementing or debugging ecommerce checkout, cart checkout, shipping/payment selection, or Wompi checkout.
Currency formatting patterns: custom Vendix CurrencyPipe, CurrencyFormatService, money inputs with [currency], format_style enum, Decimal string handling, and avoiding hardcoded money formatting. Trigger: When displaying or inputting money/currency values.
Creates or updates Vendix AI agent skills using the repository skill standard. Trigger: When creating a new skill, updating skill guidance, documenting repeatable AI patterns, or resolving a knowledge gap.
Embeddings and RAG pipeline: pgvector setup, OpenAI embedding generation, raw SQL vector storage/search, product event pipeline, RAG context building, and batch sync. Trigger: When working with embeddings, semantic search, pgvector, RAG, or the embedding pipeline.
Syncs skill metadata to AGENTS.md Auto-invoke sections. Trigger: When updating skill metadata (metadata.scope/metadata.auto_invoke), regenerating Auto-invoke tables, or running ./skills/skill-sync/assets/sync.sh (including --dry-run/--scope).
Vendix cloud operations guidance for using the private production runbook, SSH, and AWS CLI to inspect or administer cloud resources. Trigger: When consulting keys/README.md, using AWS CLI for Vendix cloud inventory, checking production resource locations, or deciding whether to use SSH versus AWS CLI.
S3 storage patterns for Vendix uploads: store S3 keys, never signed URLs, validate safe keys, centralize upload paths, use image presets, and sign URLs only for reads. Trigger: When uploading files, handling S3 URLs, or saving image/logo/favicon URLs to database.
Mobile-first UI/UX design philosophy, accessibility standards, visual quality checklist, and skill routing for Vendix frontend work. Trigger: When designing UI screens, implementing mobile-first layouts, checking accessibility, or creating landing pages.
Skill for reviewing Pull Requests from any GitHub repository using GitHub CLI (gh). Analyzes regression, security, logic, syntax, core files, and code quality. Trigger: When the user asks to review PRs, analyze PR code, or do code review.
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.
Rules and patterns for commits, PRs, branching, and conflict resolution. Trigger: When making commits, creating PRs, working with branches, or resolving git conflicts.
NestJS backend patterns for Vendix domains, controllers, services, DTOs, scoped Prisma, auth/permissions, validation, and module registration. Trigger: When editing files in apps/backend/, creating modules, or working with Prisma.
Standard mobile-first admin list module layout for Vendix: stats, sticky search/header, Card wrapper, and ResponsiveDataView. Trigger: When creating or refactoring STORE_ADMIN, SUPER_ADMIN, or other private admin list modules.
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.
Defines the Vendix planning protocol before development. Trigger: When creating implementation plans, analyzing non-trivial changes, decomposing work, or preparing multi-agent development.
Backend RBAC permission rows, @Permissions decorators, and PermissionsGuard behavior. Trigger: When adding permissions, editing @Permissions decorators, seeding roles/permissions, or distinguishing authorization from panel_ui visibility.
Angular 20 zoneless and signals patterns for Vendix frontend: app.config setup, signal inputs/outputs/models, toSignal in facades, CVA rules, audit script usage, and legacy patterns that must not be copied into new code.
Payment processor system: strategy registration, store credentials, webhooks, Wompi, and SaaS recurrent charges. Trigger: When adding payment processors, changing payment gateway logic, handling webhooks, or working with Wompi recurrent billing.
Monorepo workspaces, dependency placement, Docker, and CI/CD patterns for Vendix. Trigger: When installing dependencies, modifying package.json, adding/removing workspaces, creating Dockerfiles, or configuring CI/CD.
Frontend theme and branding patterns: ThemeService, CSS variables, tenant branding, user theme presets, RGB variables, browser guards, and deprecated theme APIs. Trigger: When styling/theming frontend UI or working with branding configuration.
Responsive stats/KPI card pattern using StatsComponent and the global stats-container. Trigger: When implementing stats cards, dashboard metrics, KPI summaries, or sticky stats sections in admin modules.
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.
Deprecated legacy store settings skill. Trigger: Do not auto-invoke; use vendix-settings-system instead.
Store and organization settings persistence, defaults, templates, branding, and frontend integration. Trigger: When working with settings configuration, adding settings sections, modifying store_settings/organization_settings, or debugging settings defaults/sync.
Panel UI module visibility system: backend defaults, NgRx selectors, MenuFilterService, module flows, and sidebar filtering. Trigger: When adding sidebar modules, configuring panel_ui visibility, debugging menu filtering, or distinguishing visibility from permissions.
Prisma schema editing patterns for Vendix: snake_case schema, Prisma 7 datasource config, relationships, indexes, enums, and migration workflow. Trigger: When editing Schema or adding/removing Prisma models, fields, relations, indexes, or enums.
Date and timezone handling patterns: UTC-safe date-only display, form date strings, chart labels, date range queries, print formatting, and off-by-one day prevention. Trigger: When displaying dates, formatting date labels, using DatePipe/toLocaleDateString, querying date ranges, or adding DateTime fields.
Angular component structure rules for Vendix: reuse shared components first, follow zoneless/signals patterns, and align component folder shape with real repo conventions instead of rigid outdated rules. Trigger: When creating Angular components.
Reusable sticky header pattern for Vendix form/detail pages. Trigger: When implementing sticky headers, page-level save/cancel actions, badges, or back navigation in frontend modules.
Frontend domain/app configuration patterns: AppConfigService domain detection, environment resolution, branding application, dynamic route selection, and cached app config. Trigger: When working on frontend domains.
Naming conventions for Vendix TypeScript, Angular, NestJS, Prisma, files, and routes. Trigger: Writing Code (Naming), creating files/classes/interfaces/enums, or reviewing naming consistency.
Establishes development best practices using the Vendix skills system. Trigger: ALWAYS when the user requests code changes, feature work, fixes, refactors, or development execution.
Backend domain architecture for Vendix: domains/* organization, flat namespaced controllers, scoped Prisma services, global guards/interceptors, and shared-service module ownership. Trigger: When working on backend domains.
Backend middleware and request-context patterns: ecommerce-only domain resolution, cache-manager usage, domain_context on the request, and AsyncLocalStorage request context population via interceptor. Trigger: When configuring middleware.
Build and runtime verification steps for Vendix development. Trigger: Verifying Build, checking Docker watch-mode logs, or confirming development changes do not introduce compile/runtime errors.
Interactive tour system for Vendix frontend: TourService state persistence, responsive tour modal, config-based steps, device-specific targets, and first-visit guidance flows. Trigger: When creating or modifying guided tours in frontend.
Organization fiscal scope for Vendix: STORE vs ORGANIZATION legal/tax entity behavior, DIAN configuration ownership, fiscal accounting entities, fiscal reports, and intercompany transfers. Trigger: When working with organizations.fiscal_scope, fiscal accounting entities, DIAN NIT ownership, fiscal reports by NIT, fiscal scope migrations, or intercompany stock-transfer entries.
Frontend caching patterns for Vendix Angular services: shareReplay TTL caches, instance fields, module-level Map caches, parameterized cache keys, and invalidation after writes. Trigger: When caching frontend HTTP data or reducing repeated dashboard/report requests.
Protocol for using and registering Lucide icons in the Vendix frontend. Trigger: When adding icons to components, buttons, menus, stats, tables, cards, or using app-icon.
Frontend web overview for Vendix Angular 20 app and routing to specialized frontend skills. Trigger: When editing files in apps/frontend, deciding which frontend skill applies, or understanding frontend web architecture.
Orchestrates subordinate agents for complex plans and user-requested agent teams. Trigger: Use only for complex plans, broad multi-domain work, or when the user explicitly requests agent teams, parallel agents, or delegated sub-agents.
Production-safe Prisma migration patterns for Vendix: idempotent SQL, enum handling, data-impact headers, destructive-operation bans, failed migration recovery, and Prisma 7 config. Trigger: When creating migrations, editing migration SQL, deploying migrations, or recovering from failed Prisma migrations.
Vendix EC2 production maintenance and troubleshooting: GitHub Actions to ECR + EC2 deploy, targeted Docker cleanup, CloudWatch/monitoring-first diagnosis, and safe SSH/AWS access expectations. Trigger: When dealing with EC2 deployment failures, disk pressure, Docker pull/layer errors, or server cleanup.
Modal implementation patterns for Vendix frontend: app-modal API, model-based visibility, slots, outputs, zoneless-safe close/open behavior, and modal wrapper usage in feature flows. Trigger: When creating or modifying modals in frontend.
Multi-tenant Prisma scoping system for Vendix: BasePrismaService, Global/Organization/Store/Ecommerce scoped services, model registration, scoped unique-operation caveats, manual-scope caveats, and withoutScope rules. Trigger: When working with Prisma scoped services, adding models to scopes, or debugging Forbidden/Unauthorized errors or Prisma WhereUnique/AND errors in database queries.
Product and service variant rules for Vendix: variants as sellable options, inventory-independent availability, service variant booking overrides, and ecommerce/POS/cart behavior. Trigger: When creating, editing, validating, or selling product variants, service variants, products without stock, or any flow where variant availability must not be confused with inventory.
Prisma ORM overview for Vendix: Prisma 7 config, schema location, scoped services, migrations, seeds, and correct workspace commands. Trigger: When editing schema.prisma, creating migrations, using Prisma client, or seeding database data.
Vendix validation patterns: global Nest ValidationPipe, DTO-first backend validation, class-validator/class-transformer usage, business-rule validation, and Angular reactive form validators. Trigger: When writing validation logic, DTOs, form validators, or request payload handling.
AI async queue system using BullMQ: generation jobs, embedding jobs, queue registration, processors, retries, and job status. Trigger: When working with AI async processing, BullMQ queues, AI job processors, or embedding/generation background jobs.
AI Agent system: AIAgentService ReAct loop, AIToolRegistry, domain tools, permission checks, and provider tool-use integration. Trigger: When creating AI tools, modifying the Tool Registry, working with the ReAct loop, or adding tool-use capabilities.
AI Chat system: conversation CRUD, sync and SSE message endpoints, agent/RAG routing, NgRx chat state, and chat widget. Trigger: When working with AI conversations, the chat widget, chat API endpoints, or NgRx chat state.
Vendix backend API endpoint patterns: flat namespaced controllers, DTO-first request validation, ResponseService helpers, pagination responses, and service/controller responsibilities. Trigger: When creating API endpoints.
Angular Reactive Forms patterns with strict typing, shared CVA components, and Zoneless-safe form state. Trigger: When creating Angular forms, fixing FormControl type errors, binding form controls in templates, or implementing ControlValueAccessor components.
Customer authentication patterns for STORE_ECOMMERCE using modal login/register, store-scoped auth endpoints, tenant context, and legal document acceptance. Trigger: When implementing customer login, registration, auth modal, or ecommerce auth flows.
Standardize calculated prices with taxes/fees: persist base/snapshot values only, calculate product final_price on reads, and keep tax-inclusive values out of create/update payloads. Trigger: When working with pricing that includes taxes/fees, UI price displays, or backend price calculations.
Angular module/feature structure patterns for Vendix: pages, services, interfaces, routes, standalone roots, and module-local components aligned to current repo reality. Trigger: When creating Frontend Modules.
Deprecated lazy-routing skill. Trigger: Do not auto-invoke; use vendix-frontend-routing instead.
Angular frontend web routing patterns, dynamic app routes, public/private route files, guards, and lazy loading. Trigger: Managing Routes, adding frontend routes, lazy-loading modules/components, or editing public/private route files.
Standardized backend/frontend error handling with VendixHttpException, error-codes.ts, AllExceptionsFilter, validation error mapping, frontend parseApiError, and UX message mapping. Trigger: When adding errors, handling exceptions, mapping API errors, or replacing generic Nest exceptions.
Responsive data display patterns using TableComponent, ItemListComponent, and ResponsiveDataViewComponent. Trigger: When displaying lists of records, creating responsive admin tables, or configuring mobile card views.
Frontend country/department/city handling patterns, including the two active CountryService implementations and the Colombia-only department/city API flow. Trigger: When building country, timezone, department, or city selectors in frontend forms.
Vendix frontend state patterns: NgRx facades with signal parallels, toSignal with initialValue, local signal state, takeUntilDestroyed, and pragmatic service-level cache/state. Trigger: When managing state.
Inventory stock management patterns: StockLevelManager, stock_levels source of truth, reservations, variant/base transitions, audit records, and denormalized stock sync. Trigger: When working with stock levels, inventory adjustments, stock transfers, reservations, or any operation that modifies product/variant quantities.
MCP Gateway for external AI clients: resources, tools, prompts, JWT auth, rate limiting, audit logging, and protocol responses. Trigger: When working with MCP server endpoints, adding MCP resources/tools/prompts, configuring MCP auth, or exposing Vendix data to AI clients.
Store notifications system: database notifications, SSE stream, Web Push/VAPID, subscriptions, and frontend NgRx integration. Trigger: When adding notification types, modifying SSE/Web Push delivery, notification preferences, or notification UI.
Inventory valuation rules for Vendix: current and historical valuation, CPP/FIFO costs, COGS, inventory snapshots, and alignment with accounting entities. Trigger: When implementing or debugging inventory valuation, COGS, cost layers, stock cost snapshots, or inventory valuation reports.
Organization operating scope for Vendix: STORE vs ORGANIZATION behavior for inventory, suppliers, purchases, accounting entities, transfers, reports, and tenant isolation. Trigger: When working with organization account_type, onboarding scope, inventory/accounting visibility, suppliers, locations, transfers, or cross-store data access.
Backend tenant context bridge from ecommerce domain resolution and JWT user context into AsyncLocalStorage. Trigger: Handling store context, implementing multi-tenant logic, or fixing Forbidden/403 errors in scoped services.
Product and variant pricing patterns: cost, margin, base price, variant price_override, sale price, tax-derived final_price, and frontend reactive calculations. Trigger: When editing product schemas, pricing logic, or advanced product forms.
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.
Vendix database seed patterns: current seed runner, production seed, flat seed modules, Prisma 7 shared client, idempotency, destructive dev cleanup, and the `syncRolePermissions` helper for canonical role-permission synchronization. Trigger: When creating seeds, editing seed modules, running seed scripts, or resetting development data.
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.
High-level AI Engine integration guide for Vendix: choosing the right AI subsystem, creating AI-powered features, and consuming AI Applications. Trigger: When creating AI-powered features, integrating AI Engine into domains, configuring AI providers/apps, or styling AI interaction elements.
Core AI Platform Layer: AIEngineService, providers, run/runStream, rate limiting, response sanitization, logging, cost tracking, and super-admin AI config/app CRUD. Trigger: When working with AIEngineService, adding providers, configuring AI applications, rate limiting, cost tracking, logging, or debugging AI requests.