# MotoVaultPro - AI-First Modified Feature Capsule Architecture

## AI Quick Start (50 tokens)
Vehicle management platform using Modified Feature Capsules. Each feature in backend/src/features/[name]/ is 100% self-contained with API, domain, data, migrations, external integrations, tests, and docs. Single directory load gives complete context. No shared business logic, only pure utilities in shared-minimal/.

## Navigation
- Feature work: Load entire `backend/src/features/[feature]/`
- Cross-feature: Load each feature's `index.ts` and `README.md`
- System tools: `backend/src/_system/` for migrations and schema
- AI metadata: `.ai/` directory

## Feature Capsule Structure
```
features/[name]/
├── README.md          # Feature overview & API
├── index.ts           # Public exports only
├── api/               # HTTP layer
├── domain/            # Business logic
├── data/              # Database layer
├── migrations/        # Feature's schema
├── external/          # Feature's external APIs
├── events/            # Event handlers
├── tests/             # All tests
└── docs/              # Documentation
```

## Primary Entry Points
- Backend: `backend/src/index.ts` → `backend/src/app.ts`
- Frontend: `frontend/src/main.tsx` → `frontend/src/App.tsx`
- Features: `backend/src/features/[name]/index.ts`