@nockdev/awf 6.2.0

package/.agent/skills/cross-cutting/ui-ux-pro-max/data/desktop-animation.yaml

@@ -0,0 +1,232 @@
+metadata:
+  skill: ui-ux-pro-max
+  domain: desktop_animation
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: desktop-animation.csv
+  patterns_count: 27
+  columns:
+  - platform
+  - technology
+  - technique
+  - description
+  - performance_rating
+  - example_code
+  - avoid
+patterns:
+- id: item_001
+  platform: cpp
+  technology: DirectX 12
+  technique: Batch Rendering
+  description: Combine multiple draw calls into single batch
+  performance_rating: '5'
+  example_code: commandList->DrawIndexedInstanced(count, instances, 0, 0, 0);
+  avoid: Individual draw calls per object
+- id: item_002
+  platform: cpp
+  technology: DirectX 12
+  technique: Instancing
+  description: GPU draws same geometry with different transforms
+  performance_rating: '5'
+  example_code: D3D12_INPUT_ELEMENT_DESC with D3D12_INPUT_CLASSIFICATION_PER_INSTANCE_DATA
+  avoid: Unique buffers for identical meshes
+- id: item_003
+  platform: cpp
+  technology: DirectX 12
+  technique: Swap Chain
+  description: Double/triple buffering for smooth frame display
+  performance_rating: '5'
+  example_code: IDXGISwapChain4, Present1() with DXGI_SWAP_EFFECT_FLIP_DISCARD
+  avoid: Single buffer rendering
+- id: item_004
+  platform: cpp
+  technology: DirectX 12
+  technique: Frustum Culling
+  description: Skip rendering objects outside camera view
+  performance_rating: '4'
+  example_code: BoundingFrustum::Contains(boundingBox) != ContainmentType::Disjoint
+  avoid: Render all objects unconditionally
+- id: item_005
+  platform: cpp
+  technology: DirectX 12
+  technique: Occlusion Culling
+  description: Skip hidden objects using GPU queries
+  performance_rating: '4'
+  example_code: ID3D12QueryHeap TYPE_OCCLUSION, BeginQuery/EndQuery
+  avoid: Render occluded geometry
+- id: item_006
+  platform: cpp
+  technology: Direct2D
+  technique: Hardware Accelerated 2D
+  description: GPU-accelerated 2D graphics for UI
+  performance_rating: '5'
+  example_code: ID2D1RenderTarget, D2D1CreateFactory with D2D1_FACTORY_TYPE_MULTI_THREADED
+  avoid: GDI+ for performance-critical paths
+- id: item_007
+  platform: cpp
+  technology: Direct2D
+  technique: Geometry Batching
+  description: Combine paths into single geometry
+  performance_rating: '4'
+  example_code: ID2D1GeometryGroup, CreateGeometryGroup()
+  avoid: Individual DrawGeometry calls
+- id: item_008
+  platform: csharp
+  technology: WPF
+  technique: RenderTransform Animation
+  description: Animate GPU-friendly transform properties
+  performance_rating: '5'
+  example_code: <DoubleAnimation Storyboard.TargetProperty='(UIElement.RenderTransform).(ScaleTransform.ScaleX)' To='1.2'/>
+  avoid: Animate Width/Height properties
+- id: item_009
+  platform: csharp
+  technology: WPF
+  technique: Opacity Animation
+  description: Fade using GPU compositing
+  performance_rating: '5'
+  example_code: <DoubleAnimation Storyboard.TargetProperty='Opacity' From='0' To='1' Duration='0:0:0.3'/>
+  avoid: Visibility toggle without fade
+- id: item_010
+  platform: csharp
+  technology: WPF
+  technique: EasingFunction
+  description: Natural motion curves for animations
+  performance_rating: '4'
+  example_code: <DoubleAnimation.EasingFunction><CubicEase EasingMode='EaseOut'/></DoubleAnimation.EasingFunction>
+  avoid: Linear animations only
+- id: item_011
+  platform: csharp
+  technology: WPF
+  technique: BitmapCache
+  description: Cache static content as bitmap
+  performance_rating: '4'
+  example_code: <Canvas CacheMode='BitmapCache'/>
+  avoid: Re-render static content each frame
+- id: item_012
+  platform: csharp
+  technology: WPF
+  technique: VirtualizingPanel
+  description: Virtualize long lists only render visible
+  performance_rating: '5'
+  example_code: <ListView VirtualizingStackPanel.VirtualizationMode='Recycling'/>
+  avoid: ItemsControl without virtualization
+- id: item_013
+  platform: csharp
+  technology: WinUI 3
+  technique: Composition API
+  description: Low-level animation with compositor
+  performance_rating: '5'
+  example_code: ElementCompositionPreview.GetElementVisual(element).StartAnimation('Opacity', animation);
+  avoid: WPF-style Storyboard animations
+- id: item_014
+  platform: csharp
+  technology: WinUI 3
+  technique: Implicit Animations
+  description: Auto-animate property changes
+  performance_rating: '4'
+  example_code: Visual.ImplicitAnimations = CreateImplicitAnimations();
+  avoid: Manual animation triggering
+- id: item_015
+  platform: csharp
+  technology: WinUI 3
+  technique: Expression Animations
+  description: Data-driven animations
+  performance_rating: '4'
+  example_code: 'ExpressionAnimation: ''this.Target.Offset.X + tracker.Position.X'''
+  avoid: Hardcoded animation values
+- id: item_016
+  platform: qt
+  technology: Qt Animation
+  technique: QPropertyAnimation
+  description: Animate any Q_PROPERTY
+  performance_rating: '4'
+  example_code: QPropertyAnimation* anim = new QPropertyAnimation(btn, 'geometry'); anim->setDuration(300);
+  avoid: Timer-based manual interpolation
+- id: item_017
+  platform: qt
+  technology: Qt Animation
+  technique: QEasingCurve
+  description: Built-in easing functions
+  performance_rating: '4'
+  example_code: anim->setEasingCurve(QEasingCurve::InOutQuad);
+  avoid: Linear interpolation only
+- id: item_018
+  platform: qt
+  technology: Qt Animation
+  technique: QParallelAnimationGroup
+  description: Run animations simultaneously
+  performance_rating: '4'
+  example_code: QParallelAnimationGroup* group = new QParallelAnimationGroup; group->addAnimation(anim1);
+  avoid: Sequential animations for parallel motion
+- id: item_019
+  platform: qt
+  technology: QML Animation
+  technique: Behavior on
+  description: Auto-animate property changes in QML
+  performance_rating: '5'
+  example_code: 'Behavior on x { NumberAnimation { duration: 200; easing.type: Easing.OutQuad } }'
+  avoid: Manual State transitions
+- id: item_020
+  platform: qt
+  technology: QML Animation
+  technique: States and Transitions
+  description: Declarative state machine
+  performance_rating: '4'
+  example_code: 'states: [State { name: ''pressed'' ... }] transitions: [Transition { ... }]'
+  avoid: Imperative show/hide logic
+- id: item_021
+  platform: avalonia
+  technology: Avalonia
+  technique: Transitions
+  description: XAML-defined transitions
+  performance_rating: '4'
+  example_code: <Style.Animations><Animation Duration='0:0:0.3'><DoubleAnimationUsingKeyFrames .../></Animation></Style.Animations>
+  avoid: Direct property changes
+- id: item_022
+  platform: python
+  technology: PyQt
+  technique: QPropertyAnimation
+  description: Same as Qt C++ animation
+  performance_rating: '4'
+  example_code: anim = QPropertyAnimation(widget, b'geometry'); anim.setDuration(300)
+  avoid: Thread-based animation
+- id: item_023
+  platform: python
+  technology: Flet
+  technique: animate_ properties
+  description: Built-in implicit animations
+  performance_rating: '4'
+  example_code: container.animate_opacity = 300; container.opacity = 1
+  avoid: Manual Timer updates
+- id: item_024
+  platform: electron
+  technology: CSS
+  technique: requestAnimationFrame
+  description: 60fps browser animation loop
+  performance_rating: '4'
+  example_code: requestAnimationFrame(timestamp => { element.style.transform = `translateX(${x}px)`; });
+  avoid: setInterval for animations
+- id: item_025
+  platform: electron
+  technology: CSS
+  technique: CSS Transitions
+  description: Declarative CSS animations
+  performance_rating: '5'
+  example_code: 'transition: transform 0.3s ease-out;'
+  avoid: JavaScript style manipulation
+- id: item_026
+  platform: electron
+  technology: Framer Motion
+  technique: Motion components
+  description: React animation library in Electron
+  performance_rating: '5'
+  example_code: '<motion.div animate={{ x: 100, opacity: 1 }} transition={{ duration: 0.3 }}/>'
+  avoid: CSS animations in React
+- id: item_027
+  platform: tauri
+  technology: CSS
+  technique: Native + CSS hybrid
+  description: Use native window effects + CSS animations
+  performance_rating: '5'
+  example_code: tauri-plugin-vibrancy for Mica; CSS for UI animations
+  avoid: Heavy CSS-only approaches

package/.agent/skills/cross-cutting/ui-ux-pro-max/data/desktop-architecture.yaml

@@ -0,0 +1,140 @@
+metadata:
+  skill: ui-ux-pro-max
+  domain: desktop_architecture
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: desktop-architecture.csv
+  patterns_count: 11
+  columns:
+  - pattern
+  - full_name
+  - best_for
+  - data_binding
+  - testability
+  - coupling
+  - languages
+  - example_structure
+  - key_components
+  - anti_patterns
+patterns:
+- id: item_001
+  pattern: mvvm
+  full_name: Model-View-ViewModel
+  best_for: Complex data-driven UIs
+  data_binding: Auto two-way binding
+  testability: High - ViewModel testable without UI
+  coupling: Low - View knows ViewModel only
+  languages: C# WPF/WinUI/MAUI/Avalonia
+  example_structure: Models/ ViewModels/ Views/ Services/
+  key_components: Model (data/logic), View (XAML), ViewModel (INotifyPropertyChanged), Commands (ICommand)
+  anti_patterns: Fat ViewModel, View logic in codebehind, Direct Model-View coupling
+- id: item_002
+  pattern: mvp
+  full_name: Model-View-Presenter
+  best_for: Desktop apps requiring testability
+  data_binding: Manual via Presenter
+  testability: Very High - Presenter interface-driven
+  coupling: Low - View interface abstraction
+  languages: C++ Qt/wxWidgets/WinForms Java Swing
+  example_structure: Models/ Views/ Presenters/ Interfaces/
+  key_components: Model (data), View (IView interface), Presenter (business logic)
+  anti_patterns: Presenter calling View directly, Missing View interface, Business logic in View
+- id: item_003
+  pattern: mvc
+  full_name: Model-View-Controller
+  best_for: Simple applications
+  data_binding: Manual via Controller
+  testability: Medium - Controller testable
+  coupling: Medium - View can access Model
+  languages: C++ Qt MFC legacy apps
+  example_structure: Models/ Views/ Controllers/
+  key_components: Model (notifies View), View (displays), Controller (handles input)
+  anti_patterns: Massive Controller, View modifying Model, Tight coupling
+- id: item_004
+  pattern: flux
+  full_name: Flux/Redux Pattern
+  best_for: Complex state management
+  data_binding: Unidirectional via Store
+  testability: High - Predictable state
+  coupling: Low - Components subscribe to Store
+  languages: JS/TS React Electron
+  example_structure: store/ actions/ reducers/ components/
+  key_components: Actions, Dispatcher, Store, Components
+  anti_patterns: Mutating state directly, Side effects in reducers, Prop drilling
+- id: item_005
+  pattern: clean
+  full_name: Clean Architecture
+  best_for: Large maintainable systems
+  data_binding: Dependency injection
+  testability: Very High - All layers testable
+  coupling: Very Low - Dependency Rule
+  languages: Any language Qt .NET
+  example_structure: domain/ application/ infrastructure/ presentation/
+  key_components: Entities, Use Cases, Interface Adapters, Frameworks
+  anti_patterns: Dependencies pointing inward, Business logic in UI, Database in core
+- id: item_006
+  pattern: di
+  full_name: Dependency Injection
+  best_for: Decoupled systems
+  data_binding: Via injected services
+  testability: High - Mock dependencies
+  coupling: Very Low - Interface-based
+  languages: C# .NET C++ with containers
+  example_structure: Interfaces/ Implementations/ Composition Root
+  key_components: IServiceProvider, Constructor injection, Lifetime scopes
+  anti_patterns: Service Locator anti-pattern, Hidden dependencies, Tight coupling
+- id: item_007
+  pattern: observer
+  full_name: Observer Pattern
+  best_for: Event-driven updates
+  data_binding: Publish/Subscribe
+  testability: Medium
+  coupling: Low - Loose coupling
+  languages: C++ Qt Signals/Slots C# events
+  example_structure: Subjects (Observables) Observers (Listeners)
+  key_components: Subject maintains list, Notify on change, Observer registers/unregisters
+  anti_patterns: Memory leaks (no unsubscribe), Excessive notifications, Chain reactions
+- id: item_008
+  pattern: command
+  full_name: Command Pattern
+  best_for: Undo/Redo UI actions
+  data_binding: Commands encapsulate action
+  testability: High - Commands testable
+  coupling: Low - Invoker knows Command interface
+  languages: C# WPF ICommand C++ Qt QAction
+  example_structure: Commands/ Invokers/ Receivers/
+  key_components: Command interface (Execute/CanExecute), Invoker, Receiver
+  anti_patterns: Logic in CanExecute, Non-undoable commands for undoable actions
+- id: item_009
+  pattern: repository
+  full_name: Repository Pattern
+  best_for: Data access abstraction
+  data_binding: Via repository interface
+  testability: High - Mock data access
+  coupling: Low - Business logic isolated
+  languages: Any with database access
+  example_structure: Repositories/ Entities/ DataContext/
+  key_components: IRepository<T>, Add/Remove/Find methods, Unit of Work
+  anti_patterns: Fat repository, Business logic in repository, Leaky abstractions
+- id: item_010
+  pattern: singleton
+  full_name: Singleton Pattern
+  best_for: Global state management
+  data_binding: Direct access
+  testability: Low - Hard to mock
+  coupling: High - Global dependency
+  languages: Any language
+  example_structure: AppState.Instance, Logger.Instance
+  key_components: Private constructor, Static instance, Thread-safe initialization
+  anti_patterns: Overuse, Hidden dependencies, Global mutable state
+- id: item_011
+  pattern: factory
+  full_name: Factory Pattern
+  best_for: Object creation abstraction
+  data_binding: Via factory
+  testability: High - Mock object creation
+  coupling: Low - Client knows interface only
+  languages: C++ C# Python
+  example_structure: Factories/ Products/
+  key_components: IFactory, Create methods, Product interfaces
+  anti_patterns: God factory, Factory knowing implementation details