avalonia-zafiro-development

Mandatory skills, conventions, and behavioral rules for Avalonia UI development using the Zafiro toolkit.

1. Zapoznaj się z czterema filarami podejścia: funkcyjno-reaktywnym MVVM, bezpieczeństwem i przewidywalnością poprzez Result types, niezależnością ViewModeli od platformy Avalonia oraz pierwszeństwem Zafiro — te zasady stanowią fundament każdego projektu.

2. Przed napisaniem kodu przeszukaj istniejący kod źródłowy w poszukiwaniu podobnych implementacji lub dostępnych helperów Zafiro, aby uniknąć duplikacji i konsekwentnie stosować już ustalone wzorce.

3. Jeśli brakuje ci helpera, zamiast wpisywać złożoną logikę inline, zaproponuj nową metodę rozszerzającą, którą będzie można ponownie wykorzystać w innych miejscach projektu.

4. Stosuj DynamicData operators zamiast zwykłych Rx do budowania reaktywnych pipelinów — to zapewnia lepszą wydajność i czytelność kodu.

5. Zapoznaj się z dokumentacją zawartą w repozytorium: przeczytaj Core Technical Skills & Architecture, Naming & Coding Standards, Avalonia, Zafiro & Reactive Rules, Zafiro Shortcuts oraz Common Patterns, aby w pełni zrozumieć konwencje projektu.

6. Stosuj jawną obsługę błędów z użyciem Result types zamiast wyjątków do kontroli przepływu, a upewnij się, że ViewModele są całkowicie niezależne od Avalonia — używaj kompozycji zamiast dziedziczenia.