Avalonia Zafiro Development

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

1. Functional-Reactive MVVM: Pure MVVM logic using DynamicData and ReactiveUI.
2. Safety & Predictability: Explicit error handling with Result types and avoidance of exceptions for flow control.
3. Cross-Platform Excellence: Strictly Avalonia-independent ViewModels and composition-over-inheritance.
4. 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

1. Search First: Search the codebase for similar implementations or existing Zafiro helpers.
2. Reusable Extensions: If a helper is missing, propose a new reusable extension method instead of inlining complex logic.
3. 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.

AGI Framework Integration

Adapted for @techwavedev/agi-agent-kit Original source: antigravity-awesome-skills

Memory-First Protocol

Retrieve prior design decisions (color palettes, typography, spacing scales) to maintain visual consistency across sessions. Cache generated design tokens.

# Check for prior frontend/design context before starting
python3 execution/memory_manager.py auto --query "design system decisions and component patterns for Avalonia Zafiro Development"

Storing Results

After completing work, store frontend/design decisions for future sessions:

python3 execution/memory_manager.py store \
  --content "Design system: adopted 8px grid, Inter font family, HSL color tokens with dark mode support" \
  --type decision --project <project> \
  --tags avalonia-zafiro-development frontend

Multi-Agent Collaboration

Share design decisions with backend agents (API contract changes) and QA agents (visual regression baselines).

python3 execution/cross_agent_context.py store \
  --agent "<your-agent>" \
  --action "Implemented UI components — new design system with accessibility compliance (WCAG 2.1 AA)" \
  --project <project>

Design Memory Persistence

Store design system tokens and component decisions in Qdrant so any agent on any platform (Claude, Gemini, Cursor) can retrieve and apply consistent styling.