MVP Build

AI_README.md

@@ -0,0 +1,30 @@
+# 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`