# WinUI agent plugin (Microsoft) — setup for this repo

The [WinUI agent plugin](https://learn.microsoft.com/en-us/windows/apps/develop/ai-assisted/winui-agent-plugin) targets **GitHub Copilot CLI** and **Claude Code**. It does **not** plug into Cursor chat directly.

This WinForms project applies **Fluent Design tokens** from the plugin's `winui-design` skill in `Elfisa.UI` (`FluentWin11` theme).

## Prerequisites

```powershell
winget install Microsoft.winappcli --source winget
winget install GitHub.cli
```

GitHub Copilot subscription required for Copilot CLI.

## Install Copilot CLI + WinUI plugin

```powershell
gh auth login
gh extension install github/gh-copilot
gh copilot plugin install winui@awesome-copilot
gh copilot plugin list
```

## Use with Copilot CLI

```powershell
gh copilot -p "@winui-dev Review the WinForms shell in src/ElectronicPharmacy for Fluent alignment"
```

Interactive session:

```powershell
copilot
# then: @winui-dev Suggest toolbar layout improvements for FOrders
```

## WinForms adaptation (this repo)

| WinUI guidance | WinForms implementation |
|----------------|-------------------------|
| Semantic brushes, no hard-coded `#RRGGBB` in UI code | `ThemeColors` + `FluentWin11Palette` |
| Segoe UI typography | `Segoe UI` 12–14 in palette fonts |
| 8px spacing grid | Toolbar layout in `FOrders.ApplyToolbarLayout` |
| Developer-tool silhouette | `ModernAppHeader` + `ModernDocumentTabStrip` |
| WinUI `AccentButton` / `Button` | `ModernButton` + `ModernButtonStyles.ApplyAuto` |
| Focus ring | keyboard focus outline in `ModernButton` |
| Disabled opacity | muted fill/text when `Enabled = false` |

Default theme: `ThemeVariant.FluentWin11` in `Program.cs`.

## Claude Code (optional)

```powershell
claude plugin marketplace add microsoft/win-dev-skills
claude plugin install winui@win-dev-skills
```