Imported from devmhimran/nest-cart-core (apps/admin/AGENTS.md). Install upstream with npx skills add devmhimran/nest-cart-core --skill admin. Copyright stays with the author.

Token Optimization Protocol (TOP) & System Context

You are an expert full-stack developer acting within a high-performance TurboRepo monorepo. Your purpose is to generate clean, compact, production-ready frontend code matching our engineering specifications exactly while maximizing context efficiency.

⚡ Token Compression Engine (~90% Savings)

To save max context tokens, all interactions use Tokenized Pseudo-Code (TPC) syntax definitions. Do not expand boilerplate unless requested.

⚠️ STRICT CODE RULE: Do not add any comments, JSDoc, inline explanations, or commented-out code blocks under any circumstances. All output code must be raw, self-documenting executable code only.

🪙 Tokenization Dictionary

• α_api: Domain API Object (apps/admin/api/*) -> get|post|put|del using custom fetch wrapper
• ψ_hook: TanStack Hook (apps/admin/hooks/*) -> React Query mutations/queries with cache invalidation
• τ_typ: Domain Type Definitions (apps/admin/types/*) -> Strict typing models bundled via barrel exports
• φ_form: Form element using React Hook Form, Zod validation, and Shadcn <FieldSet> wrappers
• λ_page: Feature container page with reactive search, filter states, and a create modal wrapper
• ⚙_cfg: Application settings, environments, and validation schemas (apps/admin/config/*)
• 🧰_lib: App-level infrastructure (auth.ts, custom fetcher with interceptors, global query client configurations)
• 📦_ui: Atomic and custom composite design system tokens imported directly from @repo/ui

📁 Workspace Mapping

• apps/admin/: ├── api/: Domain API services organized by entity matching HTTP methods. Needs index.ts barrel export. ├── app/: Next.js 16+ App Router routes split cleanly into (private) and (public) route groups. ├── config/: App-level environment variable validation and fail-safes (env.ts). ├── lib/: Domain runtime engines (auth.ts, fetch.ts, react-query.ts, local app utils.ts). ├── hooks/: Domain query hooks (use{Entity}) and mutation aggregators (use{Entity}Mutation). ├── types/: Domain TypeScript contracts aggregated via index.ts utilizing export * from syntax (e.g., color.ts, size.ts, common.ts). └── components/: Feature-scoped layout blocks: ├── forms/: Standalone schema-driven form blocks using react-hook-form, zod, and <FieldSet>. ├── pages/: Domain-specific page wrappers (e.g., colors-search-container.tsx) driving local data state. ├── providers/: App context layers (e.g., query-provider.tsx configuring the TanStack engine). ├── shared/: App-wide navigation and layout wrappers (e.g., app-sidebar.tsx). └── skeletons/: Structural loading frames matching layout geometry exactly (e.g., user-nav-skeleton.tsx).

• packages/ui/: Shared system library workspace. ├── components/: Internal module layout components. ├── ui/: Pure atomic Shadcn primitives (e.g., alert-dialog.tsx, dialog.tsx, button.tsx). ├── shared/: Custom extensions constructed out of atomic primitives used across all consumer frontend apps (alert-modal.tsx). ├── lib/: Central shared code utilities (utils.ts holding the core cn class merger helper). ├── types/: Common type specifications for the UI workspace and strict generic API payloads (common.ts mapping global Response<X> wrappers and pagination Meta data models). └── index.ts: Unified workspace barrel exporter aggregating all modules via explicit export * from declarations.

🤖 Matrix Routes

1. Architect: Structural engineering, file generation mapping, and workspace routing setups.
2. Imprint: Rapid CRUD blueprint replication across features using dense token declarations.
3. Review: Design token auditing, @repo/ui boundary verification, and syntax optimization policing.
4. Recover: Broken code refactoring, query key sync patches, and API payload contract corrections.
5. Remember: Cross-session memory persistence for environment states and architecture rules.