# Add a `WHERE.md` at repo root or `docs/`:
# - “Finding Code / Tests / Config / Docs” sections
# - Concrete path patterns + examples (not theory)
# - 5–10 copy/paste search commands for the repo

# WHERE.md - Quick Lookup Guide

## 🔍 Finding Code

### API Endpoints
```
Want: REST endpoint for /users
Look: src/api/routes/users.ts
Pattern: src/api/routes/{resource}.ts
```

### Business Logic
```
Want: User creation logic
Look: src/domain/users/services/createUser.ts
Pattern: src/domain/{entity}/services/{action}.ts
```

### Database Models
```
Want: User schema
Look: src/infrastructure/db/models/user.ts
Pattern: src/infrastructure/db/models/{entity}.ts
```

### Database Migrations
```
Want: Migration files
Look: prisma/migrations/
Pattern: prisma/migrations/{timestamp}_{name}/
```

### Type Definitions
```
Want: API request/response types
Look: src/api/types/{resource}.ts

Want: Domain types
Look: src/domain/{entity}/types.ts
```

### External API Integrations
```
Want: Stripe integration
Look: src/infrastructure/stripe/

Want: Email service
Look: src/infrastructure/email/
```

## 🧪 Finding Tests

### Unit Tests
```
Source: src/domain/users/services/createUser.ts
Test: tests/domain/users/services/createUser.test.ts
Pattern: tests/{mirror of src path}.test.ts
```

### Integration Tests
```
Look: tests/integration/{feature}/
Pattern: tests/integration/{feature}/*.test.ts
```

### E2E Tests
```
Look: tests/e2e/
Pattern: tests/e2e/{flow}.spec.ts
```

## ⚙️ Finding Configuration

| Config Type | Location |
|-------------|----------|
| Environment vars | `.env.example` |
| App config | `config/` |
| TypeScript | `tsconfig.json` |
| Linting | `.eslintrc.js` |
| Testing | `jest.config.js` |
| Docker | `Dockerfile`, `docker-compose.yml` |
| CI/CD | `.github/workflows/` |

## 📚 Finding Documentation

| Doc Type | Location |
|----------|----------|
| API reference | `docs/api/` |
| Architecture | `docs/architecture/` |
| Runbooks | `docs/runbooks/` |
| ADRs | `docs/adr/` |

## 🔧 Finding Scripts

| Script | Location | Usage |
|--------|----------|-------|
| Dev server | `npm run dev` | Local development |
| Build | `npm run build` | Production build |
| Migrations | `npm run db:migrate` | Run migrations |
| Seed data | `npm run db:seed` | Populate test data |

## 🗂️ By File Type

| I need... | File pattern | Example |
|-----------|--------------|---------|
| Controller | `*Controller.ts` | `UsersController.ts` |
| Service | `*Service.ts` | `UserService.ts` |
| Repository | `*Repository.ts` | `UserRepository.ts` |
| Middleware | `*Middleware.ts` | `AuthMiddleware.ts` |
| Validator | `*Validator.ts` | `UserValidator.ts` |
| DTO | `*Dto.ts` | `CreateUserDto.ts` |
```

# Find file by name
fd "UserService"

# Find definition
grep -r "class UserService" src/

# Find usage
grep -r "UserService" src/ --include="*.ts"

# Find tests for a file
fd "createUser.test" tests/