@sprouted/create-vibes/templates/base/ai-docs/navigation.md

Create a new Vibes monorepo

# AI Navigation Guide for Vibes

## Quick Commands for AI Tools

### Finding Code
- **"Find authentication code"** → `features/user-auth/`
- **"Find API endpoints"** → `features/*/api/routes/`
- **"Find UI components"** → `features/*/ui/components/`
- **"Find business logic"** → `features/*/logic/services/`
- **"Find shared utilities"** → `shared/utils/`

### Common Tasks

#### 1. Add a New API Endpoint
1. Navigate to `features/[feature-name]/api/routes/`
2. Create or modify route file
3. Add handler in `features/[feature-name]/api/handlers/`
4. Update exports in `features/[feature-name]/api/index.ts`

#### 2. Create a New UI Component
1. Go to `features/[feature-name]/ui/components/`
2. Create component file (PascalCase)
3. Export from `features/[feature-name]/ui/index.ts`
4. Import in screens as needed

#### 3. Add Business Logic
1. Navigate to `features/[feature-name]/logic/services/`
2. Create service class
3. Inject dependencies (repositories, other services)
4. Export from `features/[feature-name]/logic/index.ts`

#### 4. Work with Data Models
1. Go to `features/[feature-name]/data/models/`
2. Define TypeScript interfaces/types
3. Create repository in `features/[feature-name]/data/repositories/`
4. Export from `features/[feature-name]/data/index.ts`

## Architecture Rules
- **Vertical Slices**: Each feature contains all its layers
- **No Cross-Feature Imports**: Features don't import from each other
- **Shared Code**: Only truly generic code goes in shared/
- **Barrel Exports**: Each layer has an index.ts file

## Search Patterns
```bash
# Find all API routes
features/*/api/routes/*.ts

# Find all React components
features/*/ui/components/*.tsx

# Find all services
features/*/logic/services/*.ts

# Find all tests
features/*/tests/**/*.test.ts
```