Skip to content

Conversation

@kubaflo
Copy link
Contributor

@kubaflo kubaflo commented Nov 21, 2025

No description provided.

@dotnet-policy-service dotnet-policy-service bot added the community ✨ Community Contribution label Nov 21, 2025
@kubaflo kubaflo marked this pull request as ready for review November 22, 2025 14:07
Copilot AI review requested due to automatic review settings November 22, 2025 14:07
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR introduces comprehensive documentation for AI agents working on the .NET MAUI repository. The primary change is a shift from generic troubleshooting advice ("rebuild with --no-incremental") to emphasizing root cause investigation through crash log analysis. The PR adds extensive new documentation files organized into quick-start guides, quick-reference cards, and detailed workflow documentation for both PR reviewer and issue resolver agents.

Key Changes:

  • Replaced --no-incremental build flag suggestions with crash log investigation instructions across multiple files
  • Added new shared documentation structure (shared/platform-workflows.md, shared/error-handling-common.md, shared/fix-patterns.md, shared/checkpoints.md)
  • Created quick-start guides and quick-reference cards for both agent types
  • Introduced CollectionView handler detection guidance
  • Established progressive learning approach in agent entry points

Reviewed changes

Copilot reviewed 29 out of 29 changed files in this pull request and generated no comments.

Show a summary per file
File Description
docs/UITesting-Guide.md Updated Android crash troubleshooting to emphasize log investigation over incremental rebuilds
.github/instructions/uitests.instructions.md Replaced --no-incremental with crash log capture patterns for both iOS and Android
.github/instructions/shared/platform-workflows.md New file: Complete iOS/Android/MacCatalyst reproduction workflows with commands
.github/instructions/shared/fix-patterns.md New file: Comprehensive C# code patterns for common MAUI fixes
.github/instructions/shared/error-handling-common.md New file: Common build/deploy error solutions with crash log handling
.github/instructions/shared/checkpoints.md New file: Validation checkpoint templates for both agent types
.github/instructions/pr-reviewer-agent/testing-guidelines.md Added CollectionView handler detection, mandatory checkpoints, manual verification patterns
.github/instructions/pr-reviewer-agent/sandbox-setup.md Restructured to reference CollectionView handler detection and instrumentation guide
.github/instructions/pr-reviewer-agent/quick-start.md New file: 5-minute quick start guide for PR reviewers
.github/instructions/pr-reviewer-agent/quick-ref.md New file: Command and template cheat sheet for PR reviewers
.github/instructions/pr-reviewer-agent/output-format.md Added self-check checklist before posting reviews
.github/instructions/pr-reviewer-agent/error-handling.md Added extensive error handling for giving up without attempting solutions
.github/instructions/pr-reviewer-agent/core-guidelines.md Updated checkpoint workflow references
.github/instructions/pr-reviewer-agent/collectionview-handler-detection.md New file: Algorithm for detecting which CollectionView handler to enable
.github/instructions/pr-reviewer-agent/README.md New file: Navigation hub for all PR reviewer instructions
.github/instructions/issue-resolver-agent/*.md New files: Complete workflow documentation for issue resolution agent
.github/instructions/instrumentation.instructions.md Comprehensive rewrite with basic patterns, timing guidance, and best practices
.github/instructions/appium-control.instructions.md Updated crash troubleshooting to emphasize log investigation
.github/agents/pr-reviewer.md Restructured with progressive learning approach and quick-start emphasis

kubaflo and others added 3 commits November 22, 2025 15:19
- PR reviewer: Add collapsible review format with visible summary and expandable details
- PR reviewer: Require [PR-Reviewer] prefix for all agent PRs
- PR reviewer: Mandate Review_Feedback_Issue_XXXXX.md file creation
- Issue resolver: Add collapsible PR description format
- Issue resolver: Require [Issue-Resolver] prefix for all PRs
- Issue resolver: Add manual verification checkpoints for sandbox app and UI tests
@PureWeen
Copy link
Member

Need to update all the appium script parts to use most recent appium web driver

It keeps wanting to use 5.0.3

@PureWeen
Copy link
Member

@copilot update all references to appium web driver to the latest version on nuget

PureWeen
PureWeen previously approved these changes Nov 23, 2025
@PureWeen PureWeen merged commit d0179ac into dotnet:main Nov 23, 2025
2 checks passed
evgenygunko pushed a commit to evgenygunko/CopyWordsDA that referenced this pull request Dec 18, 2025
This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [Microsoft.Maui.Controls](https://github.com/dotnet/maui) | nuget | patch | `10.0.11` -> `10.0.20` |

---

### Release Notes

<details>
<summary>dotnet/maui (Microsoft.Maui.Controls)</summary>

### [`v10.0.20`](https://github.com/dotnet/maui/releases/tag/10.0.20): SR2

[Compare Source](dotnet/maui@10.0.11...10.0.20)

##### What's Changed

**Note:** This is a service release (SR2) tracking ongoing release/10.0.1xx-sr2 branch development. The version number 10.0.20 represents the second service release for .NET MAUI 10.

.NET MAUI 10.0.20 development introduces significant improvements across all platforms with focus on quality, performance, and developer experience. Current development includes enhancements to XAML Source Generator, iOS/macOS fixes, AppThemeBinding improvements, and improved developer tooling.

##### AI

-   PR Reviewer Agent by [@&#8203;PureWeen](https://github.com/PureWeen) in dotnet/maui#32340

-   \[AI] The Issue-Resolver agent by [@&#8203;kubaflo](https://github.com/kubaflo) in dotnet/maui#32804

-   \[AI] Fixed links for agents by [@&#8203;kubaflo](https://github.com/kubaflo) in dotnet/maui#32818

-   Add checkpoint/resume system for PR review agent by [@&#8203;kubaflo](https://github.com/kubaflo) in dotnet/maui#32774

-   Improved pr-reviewer AI agent and modified the usage instructions in README by [@&#8203;kubaflo](https://github.com/kubaflo) in dotnet/maui#32718

-   Agents scripts by [@&#8203;PureWeen](https://github.com/PureWeen) in dotnet/maui#32819

-   Simplify agent instructions and consolidate sandbox testing workflow by [@&#8203;Copilot](https://github.com/Copilot) in dotnet/maui#32950

##### Brushes

-   Fix SolidColorBrush.Equals to compare Color values instead of references by [@&#8203;StephaneDelcroix](https://github.com/StephaneDelcroix) in dotnet/maui#32956

    <details>
    <summary>🔧 Fixes</summary>

    -   [Using DynamicResource with OnPlatform<Color> causes infinite loop](dotnet/maui#27281)

    </details>

##### Data Binding

-   Fix CS8603 error for nullable reference types in SourceGen binding paths by [@&#8203;Copilot](https://github.com/Copilot) in dotnet/maui#32480

    <details>
    <summary>🔧 Fixes</summary>

    -   [error CS8603: Possible null reference return in generated code using SourceGen](dotnet/maui#32478)

    </details>

##### Docs

-   Add README-AI.md file by [@&#8203;PureWeen](https://github.com/PureWeen) in dotnet/maui#32502

-   Improve AI agent documentation and testing instructions by [@&#8203;Copilot](https://github.com/Copilot) in https://github.com/dotnet/maui/p...
This was referenced Dec 18, 2025
@github-actions github-actions bot locked and limited conversation to collaborators Dec 24, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

area-ai community ✨ Community Contribution

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants