mx-review

Umiejętność Claude'a do przeglądu kodu zgodnie z konwencjami projektu MX Space. Sprawdza wzorce NestJS, modele TypeGoose, schematy Zod, projektowanie API i testy. Analizuje kontrolery, serwisy, modele danych oraz DTOs, weryfikując poprawność dekoratorów, injekcji zależności, obsługi błędów i struktury odpowiedzi API. Idealna dla zespołów pracujących nad projektem MX Space, którzy chcą utrzymać spójność kodu i zgodność ze standardami.

1. Przygotuj plik lub ścieżkę do przeglądu. Umiejętność akceptuje argument w postaci ścieżki do pliku, który chcesz sprawdzić (np. kontroler, serwis lub model).

2. Uruchom przegląd, podając ścieżkę do pliku jako argument. Claude przeanalizuje kod pod kątem wszystkich kategorii konwencji projektu: kontrolerów, serwisów, modeli, schematów DTO oraz projektowania API.

3. Sprawdź listę kontrolną dla kontrolerów — weryfikacja użycia dekoratorów @ApiController(), @Auth(), paginacji, walidacji parametrów za pomocą DTO oraz poprawności kodów HTTP.

4. Przejrzyj wyniki dla serwisów — sprawdzenie injekcji modeli, użycia .lean() w zapytaniach, agregacji, obsługi zdarzeń przez eventManager oraz harmonogramowania zadań.

5. Zweryfikuj modele i schematy — analiza dziedziczenia z BaseModel, konfiguracji kolekcji, indeksów, referencji oraz użycia Zod zamiast class-validator.

6. Przeanalizuj projekt API — potwierdzenie nazewnictwa RESTful, poprawnych kodów statusu, struktury odpowiedzi z data i pagination oraz obsługi błędów przez BusinessException.