mistral-reference-architecture

Skill do implementacji wzorcowej architektury Mistral AI w projektach TypeScript/Node.js. Zawiera gotowe wzory dla struktury katalogów, singleton'a klienta, walidacji konfiguracji za pomocą Zod, niestandardowych klas błędów, warstwy serwisów z cachowaniem, health checków i szablonów promptów. Użyj przy projektowaniu nowych integracji Mistral AI, przeglądzie struktury projektu lub ustalaniu standardów architektonicznych dla aplikacji Mistral.

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.