name	avalonia-zafiro-development
description	Mandatory skills, conventions, and behavioral rules for Avalonia UI development using the Zafiro toolkit.
risk	safe
source	community
date_added	2026-02-27

Avalonia Zafiro Development

This skill defines the mandatory conventions and behavioral rules for developing cross-platform applications with Avalonia UI and the Zafiro toolkit. These rules prioritize maintainability, correctness, and a functional-reactive approach.

Core Pillars

Functional-Reactive MVVM: Pure MVVM logic using DynamicData and ReactiveUI.
Safety & Predictability: Explicit error handling with Result types and avoidance of exceptions for flow control.
Cross-Platform Excellence: Strictly Avalonia-independent ViewModels and composition-over-inheritance.
Zafiro First: Leverage existing Zafiro abstractions and helpers to avoid redundancy.

Guides

Core Technical Skills & Architecture: Fundamental skills and architectural principles.
Naming & Coding Standards: Rules for naming, fields, and error handling.
Avalonia, Zafiro & Reactive Rules: Specific guidelines for UI, Zafiro integration, and DynamicData pipelines.
Zafiro Shortcuts: Concise mappings for common Rx/Zafiro operations.
Common Patterns: Advanced patterns like RefreshableCollection and Validation.

Procedure Before Writing Code

Search First: Search the codebase for similar implementations or existing Zafiro helpers.
Reusable Extensions: If a helper is missing, propose a new reusable extension method instead of inlining complex logic.
Reactive Pipelines: Ensure DynamicData operators are used instead of plain Rx where applicable.

When to Use

This skill is applicable to execute the workflow or actions described in the overview.

Limitations

Use this skill only when the task clearly matches the scope described above.
Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Avalonia Zafiro Development

Core Pillars

Functional-Reactive MVVM: Pure MVVM logic using DynamicData and ReactiveUI.

Safety & Predictability: Explicit error handling with Result types and avoidance of exceptions for flow control.

Cross-Platform Excellence: Strictly Avalonia-independent ViewModels and composition-over-inheritance.

Zafiro First: Leverage existing Zafiro abstractions and helpers to avoid redundancy.

Guides

Core Technical Skills & Architecture: Fundamental skills and architectural principles.

Naming & Coding Standards: Rules for naming, fields, and error handling.

Avalonia, Zafiro & Reactive Rules: Specific guidelines for UI, Zafiro integration, and DynamicData pipelines.

Zafiro Shortcuts: Concise mappings for common Rx/Zafiro operations.

Common Patterns: Advanced patterns like RefreshableCollection and Validation.

Procedure Before Writing Code

Search First: Search the codebase for similar implementations or existing Zafiro helpers.

Reusable Extensions: If a helper is missing, propose a new reusable extension method instead of inlining complex logic.

Reactive Pipelines: Ensure DynamicData operators are used instead of plain Rx where applicable.

When to Use

This skill is applicable to execute the workflow or actions described in the overview.

Limitations

Use this skill only when the task clearly matches the scope described above.

Do not treat the output as a substitute for environment-specific validation, testing, or expert review.

Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

avalonia-zafiro-development