mistral-reference-architecture

Implement Mistral AI reference architecture with best-practice project layout.\nUse when designing new Mistral AI integrations, reviewing project structure,\nor establishing architecture standards for Mistral AI applications.\nTrigger with phrases like \

1. Upewnij się, że Twój projekt to TypeScript/Node.js z obsługą ESM. Zainstaluj wymagane zależności: @mistralai/mistralai SDK, zod do walidacji konfiguracji oraz framework testowy (np. Vitest).

2. Stwórz strukturę katalogów zgodnie z architekturą warstwową: katalog mistral/ z plikami client.ts (singleton klienta), config.ts (konfiguracja walidowana Zodem), errors.ts (niestandardowe klasy błędów), types.ts (wspólne typy) i prompts.ts (szablony promptów).

3. W katalogu services/ utwórz moduły biznesowe: chat.service.ts z cachowaniem i retry'ami, embed.service.ts do embeddings i wyszukiwania, rag.service.ts dla pipeline'u RAG.

4. Dodaj warstwę API w katalogu api/ z plikami chat.route.ts (endpointy HTTP) i health.route.ts (health check).

5. Skonfiguruj zarządzanie konfiguracją w katalogu config/ z plikami base.ts (wspólne ustawienia), development.ts (przesłonięcia dla dev) i production.ts (przesłonięcia dla prod).

6. Wyzwól skill frazami takimi jak "mistral architecture", "mistral best practices", "mistral project structure" lub "how to organize mistral" – skill przeanalizuje Twój projekt i zaproponuje dostosowania do wzorcowej architektury.