feat: Add CLAUDE.md

Author: LubomirGeorgiev

.cursor/rules/002-project-technical-details.mdc

@@ -55,49 +55,96 @@ Never generate SQL migration files. Instead after making changes to `./src/db/mi
 
 ```
 ├── src/                          # Source directory
+│   ├── actions/                  # Server actions
+│   │   ├── credits.action.ts
+│   │   ├── sign-out.action.ts
+│   │   ├── team-actions.ts
+│   │   ├── team-membership-actions.ts
+│   │   └── team-role-actions.ts
 │   ├── app/                      # Next.js App Router
+│   │   ├── (admin)/              # Admin routes
+│   │   │   └── admin/
+│   │   │       ├── _actions/     # Admin-specific actions
+│   │   │       ├── _components/  # Admin-specific components
+│   │   │       └── users/        # User management
 │   │   ├── (auth)/               # Auth-related routes
+│   │   │   ├── _components/      # Auth components (SSO buttons, etc.)
 │   │   │   ├── sign-in/          # Sign in functionality
 │   │   │   ├── sign-up/          # Sign up functionality
 │   │   │   ├── forgot-password/  # Password reset request
-│   │   │   └── reset-password/   # Password reset completion
+│   │   │   ├── reset-password/   # Password reset completion
+│   │   │   ├── passkey/          # Passkey/WebAuthn authentication
+│   │   │   ├── sso/              # SSO authentication
+│   │   │   │   └── google/       # Google OAuth
+│   │   │   ├── team-invite/      # Team invitation acceptance
+│   │   │   └── verify-email/     # Email verification
 │   │   ├── (dashboard)/          # Dashboard and app features
+│   │   │   ├── dashboard/        # Main dashboard
+│   │   │   └── layout.tsx
 │   │   ├── (legal)/              # Legal pages (terms, privacy)
 │   │   ├── (marketing)/          # Landing pages and marketing
 │   │   ├── (settings)/           # User settings pages
 │   │   │   └── settings/
 │   │   │       ├── profile/      # Profile settings
 │   │   │       └── sessions/     # Session management
 │   │   ├── teams/                # Team management
-│   │   │   ├── [teamId]/         # Team-specific routes
+│   │   │   ├── [teamSlug]/       # Team-specific routes (dynamic)
 │   │   │   │   ├── members/      # Team member management
 │   │   │   │   ├── settings/     # Team settings
 │   │   │   │   └── billing/      # Team billing
 │   │   │   └── create/           # Team creation
+│   │   ├── dashboard/            # Additional dashboard routes
+│   │   │   └── billing/          # User billing
 │   │   ├── api/                  # API routes
+│   │   │   ├── auth/             # Auth API endpoints
+│   │   │   └── get-session/      # Session retrieval
 │   │   └── globals.css           # Global styles
 │   ├── components/               # React components
-│   │   ├── auth/                 # Authentication components
-│   │   ├── layout/               # Layout components
+│   │   ├── landing/              # Landing page components
 │   │   ├── teams/                # Team-related components
 │   │   └── ui/                   # Shadcn UI components
 │   ├── db/                       # Database related code
 │   │   ├── migrations/           # Database migrations
 │   │   └── schema.ts             # DrizzleORM schema
+│   ├── hooks/                    # Custom React hooks
+│   │   ├── useMediaQuery.ts
+│   │   └── useSignOut.ts
+│   ├── icons/                    # Custom icon components
+│   ├── layouts/                  # Layout components
+│   ├── lib/                      # Library utilities
+│   │   ├── sso/                  # SSO integrations
+│   │   ├── stripe.ts             # Stripe integration
+│   │   ├── try-catch.ts          # Error handling utilities
+│   │   └── utils.ts              # General utilities
 │   ├── react-email/              # Email templates with react-email
 │   │   ├── reset-password.tsx
 │   │   ├── verify-email.tsx
-│   │   └── team-invitation.tsx   # Team invitation email
+│   │   └── team-invite.tsx
 │   ├── schemas/                  # Zod validation schemas
+│   ├── server/                   # Server-side utilities
+│   │   ├── team-members.ts
+│   │   ├── team-roles.ts
+│   │   └── teams.ts
 │   ├── state/                    # Client state management (Zustand)
-│   │   ├── session.ts            # Session state store
-│   │   └── team.ts               # Team context state
-│   └── utils/                    # Core utilities
-│       ├── auth.ts               # Authentication logic
-│       ├── email.tsx             # Email sending utilities
-│       ├── kv-session.ts         # Session handling with KV
-│       └── team-auth.ts          # Team authorization utilities
+│   │   ├── config.ts
+│   │   ├── nav.ts
+│   │   ├── session.ts
+│   │   └── transaction.ts
+│   ├── utils/                    # Core utilities
+│   │   ├── auth.ts               # Authentication logic
+│   │   ├── auth-utils.ts         # Auth helper utilities
+│   │   ├── credits.ts            # Credit system utilities
+│   │   ├── email.tsx             # Email sending utilities
+│   │   ├── kv-session.ts         # Session handling with KV
+│   │   ├── team-auth.ts          # Team authorization utilities
+│   │   ├── rate-limit.ts         # Rate limiting
+│   │   ├── webauthn.ts           # WebAuthn/Passkey utilities
+│   │   └── with-kv-cache.ts      # KV caching utilities
+│   ├── constants.ts              # Application constants
+│   ├── flags.ts                  # Feature flags
+│   └── types.ts                  # Type definitions
 ├── public/                       # Static assets
+├── scripts/                      # Build and deployment scripts
 └── .wrangler/                    # Cloudflare Workers config
 ```