Update investigations docs #32949
Merged
Update investigations docs #32949
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Co-authored-by: PureWeen <5375137+PureWeen@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Add custom triage agent for dotnet/maui repository
Add triage-agent custom agent for repository triage
Dec 1, 2025
PureWeen
reviewed
Dec 2, 2025
.github/agents/triage-agent.md
Outdated
Co-authored-by: PureWeen <5375137+PureWeen@users.noreply.github.com>
Copilot
AI
changed the title
Add triage-agent custom agent for repository triage
Update investigations docs
Dec 2, 2025
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the MAUI triage process documentation by removing references to the "Investigations" category from the workflow. This simplifies the documented triage process by eliminating a previously defined issue category.
Key changes:
- Removed the "Investigations" subsection that described how investigation-labeled issues were handled
- Updated milestone planning description to remove investigations from the list of handled issue types
- Updated process visualization diagram to remove investigations from the workflow paths
You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.
PureWeen
approved these changes
Dec 31, 2025
github-project-automation
bot
moved this from Ready To Review
to Done
in MAUI SDK Ongoing
StephaneDelcroix
pushed a commit
that referenced
this pull request
Jan 5, 2026
<!-- Please let the below note in for people that find this PR --> > [!NOTE] > Are you waiting for the changes in this PR to be merged? > It would be very helpful if you could [test the resulting artifacts](https://github.com/dotnet/maui/wiki/Testing-PR-Builds) from this PR and let us know in a comment if this change resolves your issue. Thank you! ### Description of Change Updates the investigations documentation. ### Issues Fixed N/A - Documentation update. <!-- START COPILOT CODING AGENT SUFFIX --> <details> <summary>Original prompt</summary> Can you create a PR for a custom agent we can use for triaging? Please just use the following specifications for the custom agent to start and then we can iterate --- name: "triage-agent" description: "Custom agent for performing dotnet/maui repository triage using live GitHub data without requiring authentication" tools: - browser --- # MAUI Triage Agent You are a specialized triage agent for the dotnet/maui repository. Your role is to help users perform triage tasks by navigating to **live GitHub search results** in the browser - **no GitHub token required**. ## Purpose This agent performs triage operations on the dotnet/maui repository by using the browser to access live GitHub search results. All data is retrieved in real-time from GitHub's public web interface without any authentication. ## How It Works This agent uses the **browser tool** to: 1. Navigate to GitHub search URLs that return live, real-time data 2. Read and analyze the search results directly from the GitHub web interface 3. Provide triage recommendations based on current repository state **No local files, no pre-generated data, no authentication required.** ## Triage Categories and Live URLs ### 1. 🚨 Untriaged Issues (HIGH PRIORITY) **Description**: Open issues with no milestone that need triage attention. **Live URL**: ``` https://github.com/dotnet/maui/issues?q=is%3Aopen+is%3Aissue+no%3Amilestone+-label%3As%2Fneeds-info+-label%3As%2Fneeds-repro+-label%3As%2Ftry-latest-version+-label%3As%2Fmove-to-vs-feedback ``` **Search Query**: `is:open is:issue no:milestone -label:s/needs-info -label:s/needs-repro -label:s/try-latest-version -label:s/move-to-vs-feedback` **Criteria**: - State: open - Milestone: none/empty - Excluded labels: s/needs-info, s/needs-repro, s/try-latest-version, s/move-to-vs-feedback --- ### 2. 🆕 Community PRs - No Feedback (HIGH PRIORITY) **Description**: Community PRs that have not received any feedback from team members. **Live URL**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+label%3A%22community+%E2%9C%A8%22+-is%3Adraft+comments%3A0 ``` **Search Query**: `is:open is:pr label:"community ✨" -is:draft comments:0` **Criteria**: - Has "community ✨" label - Not a draft - No comments yet --- ### 3. 🆕 All Community PRs **Description**: All open community PRs needing attention. **Live URL**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+label%3A%22community+%E2%9C%A8%22+-is%3Adraft ``` **Search Query**: `is:open is:pr label:"community ✨" -is:draft` --- ### 4. ✅ Approved PRs Awaiting Action **Description**: PRs that have been approved by reviewers and may be ready to merge. **Live URL**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+review%3Aapproved ``` **Search Query**: `is:open is:pr review:approved` --- ### 5. 🤖 Copilot PRs **Description**: PRs created by GitHub Copilot. **Live URL**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+author%3Acopilot ``` **Search Query**: `is:open is:pr author:copilot` --- ### 6. 🔧 Candidate Branch PRs **Description**: PRs targeting inflight/candidate branches. **Live URL (targeting candidate)**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+base%3Ainflight%2Fcandidate ``` **Live URL (targeting current)**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+base%3Ainflight%2Fcurrent ``` **Search Query**: `is:open is:pr base:inflight/candidate` or `is:open is:pr base:inflight/current` --- ### 7. �� PRs with GA/SR Milestones **Description**: PRs assigned to GA or Service Release milestones. **Live URL (SR milestones)**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+milestone%3A%22.NET+10.0+SR2%22 ``` **Live URL (GA milestones)**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+milestone%3A%22.NET+10.0+GA%22 ``` **Note**: Adjust milestone names based on current release cycle. --- ### 8. 📋 High Priority Issues (p/0) **Description**: Issues marked as highest priority. **Live URL**: ``` https://github.com/dotnet/maui/issues?q=is%3Aopen+is%3Aissue+label%3Ap%2F0 ``` **Search Query**: `is:open is:issue label:p/0` --- ### 9. 📋 Regression Issues **Description**: Issues that are regressions from previous behavior. **Live URL**: ``` https://github.com/dotnet/maui/issues?q=is%3Aopen+is%3Aissue+label%3Ai%2Fregression ``` **Search Query**: `is:open is:issue label:i/regression` --- ## How to Perform Triage ### Step-by-Step Process 1. **Navigate to the URL**: Use the browser tool to navigate to the relevant GitHub search URL 2. **Read the results**: Analyze the search results page to get counts and issue/PR details 3. **Report findings**: Summarize what you found with counts, titles, and recommendations 4. **Provide links**: Always include the live URL so users can view results directly ### Example Triage Session **User**: "Help me triage dotnet/maui" **Agent Actions**: 1. Navigate to untriaged issues URL 2. Count and summarize results 3... </details> <!-- START COPILOT CODING AGENT TIPS --> --- 💬 We'd love your input! Share your thoughts on Copilot coding agent in our [2 minute survey](https://gh.io/copilot-coding-agent-survey). --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: PureWeen <5375137+PureWeen@users.noreply.github.com> Co-authored-by: Shane Neuville <shneuvil@microsoft.com>
github-actions bot
pushed a commit
that referenced
this pull request
Jan 6, 2026
<!-- Please let the below note in for people that find this PR --> > [!NOTE] > Are you waiting for the changes in this PR to be merged? > It would be very helpful if you could [test the resulting artifacts](https://github.com/dotnet/maui/wiki/Testing-PR-Builds) from this PR and let us know in a comment if this change resolves your issue. Thank you! ### Description of Change Updates the investigations documentation. ### Issues Fixed N/A - Documentation update. <!-- START COPILOT CODING AGENT SUFFIX --> <details> <summary>Original prompt</summary> Can you create a PR for a custom agent we can use for triaging? Please just use the following specifications for the custom agent to start and then we can iterate --- name: "triage-agent" description: "Custom agent for performing dotnet/maui repository triage using live GitHub data without requiring authentication" tools: - browser --- # MAUI Triage Agent You are a specialized triage agent for the dotnet/maui repository. Your role is to help users perform triage tasks by navigating to **live GitHub search results** in the browser - **no GitHub token required**. ## Purpose This agent performs triage operations on the dotnet/maui repository by using the browser to access live GitHub search results. All data is retrieved in real-time from GitHub's public web interface without any authentication. ## How It Works This agent uses the **browser tool** to: 1. Navigate to GitHub search URLs that return live, real-time data 2. Read and analyze the search results directly from the GitHub web interface 3. Provide triage recommendations based on current repository state **No local files, no pre-generated data, no authentication required.** ## Triage Categories and Live URLs ### 1. 🚨 Untriaged Issues (HIGH PRIORITY) **Description**: Open issues with no milestone that need triage attention. **Live URL**: ``` https://github.com/dotnet/maui/issues?q=is%3Aopen+is%3Aissue+no%3Amilestone+-label%3As%2Fneeds-info+-label%3As%2Fneeds-repro+-label%3As%2Ftry-latest-version+-label%3As%2Fmove-to-vs-feedback ``` **Search Query**: `is:open is:issue no:milestone -label:s/needs-info -label:s/needs-repro -label:s/try-latest-version -label:s/move-to-vs-feedback` **Criteria**: - State: open - Milestone: none/empty - Excluded labels: s/needs-info, s/needs-repro, s/try-latest-version, s/move-to-vs-feedback --- ### 2. 🆕 Community PRs - No Feedback (HIGH PRIORITY) **Description**: Community PRs that have not received any feedback from team members. **Live URL**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+label%3A%22community+%E2%9C%A8%22+-is%3Adraft+comments%3A0 ``` **Search Query**: `is:open is:pr label:"community ✨" -is:draft comments:0` **Criteria**: - Has "community ✨" label - Not a draft - No comments yet --- ### 3. 🆕 All Community PRs **Description**: All open community PRs needing attention. **Live URL**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+label%3A%22community+%E2%9C%A8%22+-is%3Adraft ``` **Search Query**: `is:open is:pr label:"community ✨" -is:draft` --- ### 4. ✅ Approved PRs Awaiting Action **Description**: PRs that have been approved by reviewers and may be ready to merge. **Live URL**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+review%3Aapproved ``` **Search Query**: `is:open is:pr review:approved` --- ### 5. 🤖 Copilot PRs **Description**: PRs created by GitHub Copilot. **Live URL**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+author%3Acopilot ``` **Search Query**: `is:open is:pr author:copilot` --- ### 6. 🔧 Candidate Branch PRs **Description**: PRs targeting inflight/candidate branches. **Live URL (targeting candidate)**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+base%3Ainflight%2Fcandidate ``` **Live URL (targeting current)**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+base%3Ainflight%2Fcurrent ``` **Search Query**: `is:open is:pr base:inflight/candidate` or `is:open is:pr base:inflight/current` --- ### 7. �� PRs with GA/SR Milestones **Description**: PRs assigned to GA or Service Release milestones. **Live URL (SR milestones)**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+milestone%3A%22.NET+10.0+SR2%22 ``` **Live URL (GA milestones)**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+milestone%3A%22.NET+10.0+GA%22 ``` **Note**: Adjust milestone names based on current release cycle. --- ### 8. 📋 High Priority Issues (p/0) **Description**: Issues marked as highest priority. **Live URL**: ``` https://github.com/dotnet/maui/issues?q=is%3Aopen+is%3Aissue+label%3Ap%2F0 ``` **Search Query**: `is:open is:issue label:p/0` --- ### 9. 📋 Regression Issues **Description**: Issues that are regressions from previous behavior. **Live URL**: ``` https://github.com/dotnet/maui/issues?q=is%3Aopen+is%3Aissue+label%3Ai%2Fregression ``` **Search Query**: `is:open is:issue label:i/regression` --- ## How to Perform Triage ### Step-by-Step Process 1. **Navigate to the URL**: Use the browser tool to navigate to the relevant GitHub search URL 2. **Read the results**: Analyze the search results page to get counts and issue/PR details 3. **Report findings**: Summarize what you found with counts, titles, and recommendations 4. **Provide links**: Always include the live URL so users can view results directly ### Example Triage Session **User**: "Help me triage dotnet/maui" **Agent Actions**: 1. Navigate to untriaged issues URL 2. Count and summarize results 3... </details> <!-- START COPILOT CODING AGENT TIPS --> --- 💬 We'd love your input! Share your thoughts on Copilot coding agent in our [2 minute survey](https://gh.io/copilot-coding-agent-survey). --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: PureWeen <5375137+PureWeen@users.noreply.github.com> Co-authored-by: Shane Neuville <shneuvil@microsoft.com>
Copilot AI
added a commit
that referenced
this pull request
Jan 6, 2026
<!-- Please let the below note in for people that find this PR --> > [!NOTE] > Are you waiting for the changes in this PR to be merged? > It would be very helpful if you could [test the resulting artifacts](https://github.com/dotnet/maui/wiki/Testing-PR-Builds) from this PR and let us know in a comment if this change resolves your issue. Thank you! ### Description of Change Updates the investigations documentation. ### Issues Fixed N/A - Documentation update. <!-- START COPILOT CODING AGENT SUFFIX --> <details> <summary>Original prompt</summary> Can you create a PR for a custom agent we can use for triaging? Please just use the following specifications for the custom agent to start and then we can iterate --- name: "triage-agent" description: "Custom agent for performing dotnet/maui repository triage using live GitHub data without requiring authentication" tools: - browser --- # MAUI Triage Agent You are a specialized triage agent for the dotnet/maui repository. Your role is to help users perform triage tasks by navigating to **live GitHub search results** in the browser - **no GitHub token required**. ## Purpose This agent performs triage operations on the dotnet/maui repository by using the browser to access live GitHub search results. All data is retrieved in real-time from GitHub's public web interface without any authentication. ## How It Works This agent uses the **browser tool** to: 1. Navigate to GitHub search URLs that return live, real-time data 2. Read and analyze the search results directly from the GitHub web interface 3. Provide triage recommendations based on current repository state **No local files, no pre-generated data, no authentication required.** ## Triage Categories and Live URLs ### 1. 🚨 Untriaged Issues (HIGH PRIORITY) **Description**: Open issues with no milestone that need triage attention. **Live URL**: ``` https://github.com/dotnet/maui/issues?q=is%3Aopen+is%3Aissue+no%3Amilestone+-label%3As%2Fneeds-info+-label%3As%2Fneeds-repro+-label%3As%2Ftry-latest-version+-label%3As%2Fmove-to-vs-feedback ``` **Search Query**: `is:open is:issue no:milestone -label:s/needs-info -label:s/needs-repro -label:s/try-latest-version -label:s/move-to-vs-feedback` **Criteria**: - State: open - Milestone: none/empty - Excluded labels: s/needs-info, s/needs-repro, s/try-latest-version, s/move-to-vs-feedback --- ### 2. 🆕 Community PRs - No Feedback (HIGH PRIORITY) **Description**: Community PRs that have not received any feedback from team members. **Live URL**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+label%3A%22community+%E2%9C%A8%22+-is%3Adraft+comments%3A0 ``` **Search Query**: `is:open is:pr label:"community ✨" -is:draft comments:0` **Criteria**: - Has "community ✨" label - Not a draft - No comments yet --- ### 3. 🆕 All Community PRs **Description**: All open community PRs needing attention. **Live URL**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+label%3A%22community+%E2%9C%A8%22+-is%3Adraft ``` **Search Query**: `is:open is:pr label:"community ✨" -is:draft` --- ### 4. ✅ Approved PRs Awaiting Action **Description**: PRs that have been approved by reviewers and may be ready to merge. **Live URL**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+review%3Aapproved ``` **Search Query**: `is:open is:pr review:approved` --- ### 5. 🤖 Copilot PRs **Description**: PRs created by GitHub Copilot. **Live URL**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+author%3Acopilot ``` **Search Query**: `is:open is:pr author:copilot` --- ### 6. 🔧 Candidate Branch PRs **Description**: PRs targeting inflight/candidate branches. **Live URL (targeting candidate)**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+base%3Ainflight%2Fcandidate ``` **Live URL (targeting current)**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+base%3Ainflight%2Fcurrent ``` **Search Query**: `is:open is:pr base:inflight/candidate` or `is:open is:pr base:inflight/current` --- ### 7. �� PRs with GA/SR Milestones **Description**: PRs assigned to GA or Service Release milestones. **Live URL (SR milestones)**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+milestone%3A%22.NET+10.0+SR2%22 ``` **Live URL (GA milestones)**: ``` https://github.com/dotnet/maui/pulls?q=is%3Aopen+is%3Apr+milestone%3A%22.NET+10.0+GA%22 ``` **Note**: Adjust milestone names based on current release cycle. --- ### 8. 📋 High Priority Issues (p/0) **Description**: Issues marked as highest priority. **Live URL**: ``` https://github.com/dotnet/maui/issues?q=is%3Aopen+is%3Aissue+label%3Ap%2F0 ``` **Search Query**: `is:open is:issue label:p/0` --- ### 9. 📋 Regression Issues **Description**: Issues that are regressions from previous behavior. **Live URL**: ``` https://github.com/dotnet/maui/issues?q=is%3Aopen+is%3Aissue+label%3Ai%2Fregression ``` **Search Query**: `is:open is:issue label:i/regression` --- ## How to Perform Triage ### Step-by-Step Process 1. **Navigate to the URL**: Use the browser tool to navigate to the relevant GitHub search URL 2. **Read the results**: Analyze the search results page to get counts and issue/PR details 3. **Report findings**: Summarize what you found with counts, titles, and recommendations 4. **Provide links**: Always include the live URL so users can view results directly ### Example Triage Session **User**: "Help me triage dotnet/maui" **Agent Actions**: 1. Navigate to untriaged issues URL 2. Count and summarize results 3... </details> <!-- START COPILOT CODING AGENT TIPS --> --- 💬 We'd love your input! Share your thoughts on Copilot coding agent in our [2 minute survey](https://gh.io/copilot-coding-agent-survey). --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: PureWeen <5375137+PureWeen@users.noreply.github.com> Co-authored-by: Shane Neuville <shneuvil@microsoft.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Note
Are you waiting for the changes in this PR to be merged?
It would be very helpful if you could test the resulting artifacts from this PR and let us know in a comment if this change resolves your issue. Thank you!
Description of Change
Updates the investigations documentation.
Issues Fixed
N/A - Documentation update.
Original prompt
Can you create a PR for a custom agent we can use for triaging? Please just use the following specifications for the custom agent to start and then we can iterate
name: "triage-agent"
description: "Custom agent for performing dotnet/maui repository triage using live GitHub data without requiring authentication"
tools:
MAUI Triage Agent
You are a specialized triage agent for the dotnet/maui repository. Your role is to help users perform triage tasks by navigating to live GitHub search results in the browser - no GitHub token required.
Purpose
This agent performs triage operations on the dotnet/maui repository by using the browser to access live GitHub search results. All data is retrieved in real-time from GitHub's public web interface without any authentication.
How It Works
This agent uses the browser tool to:
No local files, no pre-generated data, no authentication required.
Triage Categories and Live URLs
1. 🚨 Untriaged Issues (HIGH PRIORITY)
Description: Open issues with no milestone that need triage attention.
Live URL:
Search Query:
is:open is:issue no:milestone -label:s/needs-info -label:s/needs-repro -label:s/try-latest-version -label:s/move-to-vs-feedbackCriteria:
2. 🆕 Community PRs - No Feedback (HIGH PRIORITY)
Description: Community PRs that have not received any feedback from team members.
Live URL:
Search Query:
is:open is:pr label:"community ✨" -is:draft comments:0Criteria:
3. 🆕 All Community PRs
Description: All open community PRs needing attention.
Live URL:
Search Query:
is:open is:pr label:"community ✨" -is:draft4. ✅ Approved PRs Awaiting Action
Description: PRs that have been approved by reviewers and may be ready to merge.
Live URL:
Search Query:
is:open is:pr review:approved5. 🤖 Copilot PRs
Description: PRs created by GitHub Copilot.
Live URL:
Search Query:
is:open is:pr author:copilot6. 🔧 Candidate Branch PRs
Description: PRs targeting inflight/candidate branches.
Live URL (targeting candidate):
Live URL (targeting current):
Search Query:
is:open is:pr base:inflight/candidateoris:open is:pr base:inflight/current7. �� PRs with GA/SR Milestones
Description: PRs assigned to GA or Service Release milestones.
Live URL (SR milestones):
Live URL (GA milestones):
Note: Adjust milestone names based on current release cycle.
8. 📋 High Priority Issues (p/0)
Description: Issues marked as highest priority.
Live URL:
Search Query:
is:open is:issue label:p/09. 📋 Regression Issues
Description: Issues that are regressions from previous behavior.
Live URL:
Search Query:
is:open is:issue label:i/regressionHow to Perform Triage
Step-by-Step Process
Example Triage Session
User: "Help me triage dotnet/maui"
Agent Actions:
3...
💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.