MicrosoftKnown publishermicrosoft/microsoft-ui-xaml/dxaml/xcp/AGENTS.md

microsoft-ui-xaml / xcp

AGENTS.md8.6k starsChanged 51 days agoMITView on GitHub

Most code in this repo uses the IFC_RETURN macro to record some information about an HRESULT and return if it's a failure.

Jul 18, 2017Cross platform UX for .NET 5 — dotnet/maui217 reactions · 31 comments
Aug 28, 2019Proposal: Simplify Grid Column and Row Definitions — xamarin/Xamarin.Forms67 reactions · 13 comments
Aug 27, 2021[Enhancement] Cross platform media player — dotnet/maui44 reactions · 23 comments
Mar 23, 2022Support Global Exception Handling Mechanism for .NET MAUI — dotnet/maui41 reactions · 12 comments
Apr 26, 2019Adds UWP support to Shell — xamarin/Xamarin.Forms39 reactions · 45 comments

25 more on GitHub

Aug 28, 2019Proposal: Simplify Grid Column and Row Definitions — dotnet/wpf35 reactions · 7 comments
Jun 22, 2019Support using Win2D with WinUI — microsoft/Win2D35 reactions · 28 comments
May 19, 2020[WinUI3] Windows Community Toolkit 7.0.1 for Project Reunion 0.5 — CommunityToolkit/WindowsCommunityToolkit30 reactions · 49 comments
Mar 18, 2020Proposal: Allow the App to Print without showing the Confirmation Dialog to user — microsoft/WindowsAppSDK28 reactions · 47 comments
Oct 8, 2022Windows Unpackaged support in .NET MAUI — dotnet/maui27 reactions · 4 comments
May 29, 2020Discussion: Decouple MSIX from AppContainer — microsoft/WindowsAppSDK26 reactions · 14 comments
Aug 22, 2021BlazorWebView drag and drop does not work with MAUI Templates — dotnet/maui24 reactions · 96 comments
Nov 14, 2019[Enhancement] WinUI Support — xamarin/Xamarin.Forms23 reactions · 11 comments
Feb 7, 2025Fix issues with High CPU Usage on background — Devolutions/UniGetUI10 reactions
Jun 20, 2022Remove Xaml from `windows` crate — microsoft/windows-rs8 reactions · 16 comments
Dec 14, 2023XY focus — AvaloniaUI/Avalonia7 reactions · 10 comments
Jun 1, 2019Porting ItemsRepeater from WinUI — AvaloniaUI/Avalonia7 reactions · 14 comments
Feb 12, 2026Update to Windows App SDK 1.8 — microsoft/Win2D5 reactions · 1 comment
Jan 30, 2025Improve VisualState order and prevent sticky Focused visual state — dotnet/maui5 reactions · 84 comments
Dec 27, 2023Add BackgroundSizing — AvaloniaUI/Avalonia5 reactions · 16 comments
Mar 21, 2022Add new ColorSpectrum Primitive — AvaloniaUI/Avalonia5 reactions · 30 comments
Mar 19, 2025[Windows] Upgrade to Windows App SDK 1.7 — dotnet/maui4 reactions · 32 comments
Nov 17, 2023Create a "Similar Issues" bot — dotnet/maui4 reactions
Dec 17, 2021Do not copy UWP behavior with ListBoxItem horizontal alignment — AvaloniaUI/Avalonia4 reactions · 3 comments
Nov 29, 2021Make DispatcherQueueSynchronizationContext faster and zero-alloc — microsoft/CsWinRT4 reactions · 7 comments
Sep 15, 2021Update to MUX 2.7 — microsoft/terminal4 reactions · 3 comments
Aug 11, 2020Add support for WinUI 3 — mono/SkiaSharp4 reactions · 18 comments
Dec 3, 2025New functionalities of Storage.Pickers: SettingsIdentifier; InitialFileTypeIndex; Title; PickMultipleFoldersAsync; ShowOverwritePrompt; — microsoft/WindowsAppSDK3 reactions · 11 comments
Mar 15, 2025Add BreadcrumbBar — amwx/FluentAvalonia3 reactions · 1 comment
Sep 9, 2023[Keyboard Manager] Modernize the editor UI — microsoft/PowerToys3 reactions · 36 comments

On Stack Overflow · 30

Dec 10, 2021Where is the designer view in WinUI 3?17 votes
Sep 4, 2019Layout cycle detected. Layout could not complete. Layout cycle detected. Layout could not complete6 votes
Nov 11, 2020NavigationView Pane background5 votes
Jun 16, 2023c# WebView2 user directory "Access Denied"4 votes
Feb 13, 2023Remove ListViewItemPresenter border in Microsoft.UI.Xaml ListView3 votes

25 more on Stack Overflow

Nov 12, 2020What is the <ColumnDefinition /> used for in Xamarin Forms and can it be replaced with a value setting?3 votes
Apr 22, 2020Is it possible to stop the first Entry getting Focus in a ScrollView in Xamarin Forms3 votes
Sep 21, 2018UWP NavigationView is not supported3 votes
Aug 4, 2025Difference between Windows App SDK and WinUI 32 votes
Nov 13, 2024How to fix MAUI application crash with "Layout cycle detected. Layout could not complete." exception when data is loaded into views beyond a limit2 votes · 1 answer
Jan 24, 2024How can I build a self-contained C# WinUI application from within a Windows Docker container (`XamlCompiler.exe` exits with code `-1073741515`)?2 votes
Sep 29, 2023MAUI Picker style in Windows Platforms2 votes
Sep 3, 2023UWP XAML NavigationView - CornerRadius on Content Panel2 votes
Apr 25, 2023WinUI 3 Circle Button needs to keep hover animation2 votes
Sep 4, 2021How to Access WinUI Generic.xaml file?2 votes
Nov 29, 2019How to automatically scroll ScrollViewer - only if the user did not change scroll position2 votes
Apr 12, 2024Cannot create a new WinUI 3 app and target .NET 81 vote · 1 answer
Apr 11, 2024Make window only as large as required1 vote
Mar 27, 2024What the equivalent to LocalPrintServer and PrintQueue that can be used in WinUI1 vote
Mar 8, 2024SwapChainPanel DPI Awareness1 vote
Jun 12, 2023Change Microsoft.UI.Xaml.Controls.Expander Title property when expanded1 vote · 1 answer
May 1, 2023WinUI 3/WASDK 1.3 How do I shorten the width of the month on a DatePicker control?1 vote · 1 answer
Nov 24, 2022Camera Video streaming control (CaptureElement) not available for Winui3 c#1 vote
Nov 9, 2022Winui3 Navigationview PanetoggleButton increase size1 vote
Mar 13, 2022WinUI 3 ItemsRepeater re-orders/removes items when scrolling within a ScrollViewer and using UniformGridLayout1 vote · 1 answer
Jan 23, 2022Using TabItemTemplateSelector in WinUI 3 in conjunction with a TemplateSelector resulting in weirdly nested controls1 vote
Feb 3, 2021Binding a Static Generic Class in XAML1 vote
Oct 25, 2020UWP CommandBar moves vertically when IsOpen changes1 vote · 1 answer
Jul 4, 2020Unable to change the background colour of TeachingTip in UWP1 vote
Jul 16, 2019Creating a Subclass of Page in UWP1 vote · 2 answers

On Hacker News · 11

May 14, 2026WinUI 3 Performance: A Leap Forward121 points · 141 comments
Oct 25, 2023WinUI3 Source Available4 points
Feb 13, 2022Dependency property is much slower in WinUI 3 than in WPF4 points
Jul 1, 2019Windows UI Library Roadmap4 points
Oct 25, 2023WinUI 3 is now open source3 points

6 more on Hacker News

Aug 29, 2026WinUI development is now happening on GitHub2 points
May 26, 2024Is WinUI 3 Dead?2 points
Nov 13, 2019Windows UI Library Roadmap Update2 points
Nov 6, 2019First WinUI 3.0 Alpha now available2 points
Aug 2, 2025WinUI OSS Update: Phased Rollout Toward Open Collaboration1 point
Jul 23, 2024Windows UI Library1 point

On Bluesky · 1

Jan 26, 2025Over here: github.com/microsoft/mi... — @dotmorten.xaml.dev1 likes and repost · 1 reply

Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.
Of the AGENTS.md files we read, the 31,542 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.
In this repository8 other files it gives its agents.
- Samples/TableViewSampleApp/AGENTS.mdAGENTS.md
- src/.github/copilot-instructions.mdCopilot instructions
- buildSkill
- code-coverage-calculationSkill
- code-reviewSkill
- test-on-vmSkill
- bt-buildSkill
- test-suite-setupSkill

The file

We split this AGENTS.md into the rules it gives an agent

3 rules. About 0 are common, 0 are distinctive, and 3 are very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Very specific:
Prefer IFC_RETURN where applicable.
line 5
Very specific:
Instead of using return <expr>.
line 6
Very specific:
Don't use S_FALSE
line 7

≈ “Common” is an estimate: at least 1 in 5 of the 40,246 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

AGENTS.md

Most code in this repo uses the IFC_RETURN macro to record some information about an HRESULT and return if it's a failure.

Prefer IFC_RETURN where applicable. Covert IFC to IFC_RETURN opportunistically, only if you're already changing that function.
Instead of using return <expr>; to return an HRESULT, prefer to IFC_RETURN(<expr>) first and then return S_OK;.
Don't use S_FALSE

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free