MAUI DevFlow Session Review

Use this skill to turn prior MAUI DevFlow-assisted AI sessions into opt-in product feedback. The goal is not to fix bugs during the review; the goal is to identify where DevFlow caused friction, what workarounds were tried, and what outcome the agent eventually reached.

When to Use

Use this skill when:

• reviewing previous AI sessions that used maui devflow
• summarizing a long or stuck MAUI DevFlow debugging session
• finding repeated failed attempts, retries, or workarounds around DevFlow tools
• checking whether an advertised DevFlow feature did not work in practice
• preparing a markdown feedback report for MAUI DevFlow maintainers
• filing GitHub issues in dotnet/maui-labs from session evidence
• another DevFlow skill suggested an optional post-session feedback review

When to Stop

• The top actionable friction points are summarized with evidence, environment metadata, attempts, workaround, and final outcome.
• The markdown report is written or the requested GitHub issues are filed after a PII scrub.
• Remaining evidence would require scanning outside the user-approved scope.
• The finding is too ambiguous to classify without more context; label it unknown instead of continuing to mine private history.

Workflow

1. Confirm opt-in scope

If the user has provided session content directly in the message, start from step 4 (Classify friction) immediately — do not invoke live DevFlow CLI commands, search tools, or session history tools. The user has already supplied the evidence.

If no session content is provided, identify what the user wants reviewed:

• current session
• recent sessions matching MAUI DevFlow keywords
• a date range, target platform, feature, command family, or app framework
• sessions related to setup, connectivity, UI inspection, CDP, recording, logs, network, storage, profiler, or DevFlow Actions

Do not scan unrelated session history. This skill is opt-in telemetry: the user controls the scope and the output destination.

Do not ask the user for session IDs, transcript paths, log paths, artifact paths, or other local identifiers. If a tool requires an internal handle to inspect a session, use it only transiently and never include it in saved or shared output.

If another DevFlow skill suggested this review, preserve the trigger context: what challenge was stuck, which workarounds had already been tried, and whether the user wants markdown-only output or GitHub issue filing.

2. Find DevFlow-specific sessions

Use references/session-sources.md to choose the available data source. Good candidate signals include:

• maui devflow, maui-devflow-onboard, maui-devflow-debug, or this skill
• CLI commands such as maui devflow wait, maui devflow list, maui devflow agent status, maui devflow ui tree, maui devflow ui query, maui devflow recording, maui devflow logs, maui devflow network, maui devflow diagnose, or maui devflow mcp
• MCP tools such as maui_wait, maui_list_agents, maui_status, maui_tree, maui_query, maui_tap, maui_recording_start, maui_recording_stop, maui_logs, maui_network, maui_cdp_*, or maui_invoke_action
• package and API names such as Microsoft.Maui.DevFlow.Agent, Microsoft.Maui.DevFlow.Blazor, Microsoft.Maui.DevFlow.Agent.Gtk, Microsoft.Maui.DevFlow.Driver, builder.AddMauiDevFlowAgent(), or AddMauiBlazorDevFlowTools()
• broker or port evidence such as 19223, 9223, adb reverse, adb forward, agent registration, or direct port fallback

Start narrow and widen only when the first search does not find enough evidence.

3. Build the environment fingerprint

For every report and issue, collect the metadata in references/environment-fingerprint.md:

• host platform and OS version
• AI tool or host, if detectable
• model name and reasoning effort, if detectable
• MAUI, .NET SDK, and MAUI DevFlow package versions, if available
• target app platforms, such as Android, iOS, Mac Catalyst, macOS, Windows, Linux/GTK, or Blazor WebView runtime
• maui CLI version and invocation mode
• embedded DevFlow package/reference versions in the app

Unknown metadata is acceptable. Mark it as Unknown rather than guessing.

4. Classify friction

Use references/friction-rubric.md. Prioritize:

• advertised DevFlow features that failed or were unavailable
• repeated attempts at the same command, selector, connection, or setup step
• workaround chains that eventually succeeded
• broker discovery, direct agent port, or Android forwarding loops
• platform-specific setup, package, entitlement, or version mismatches
• missing stable AutomationIds or missing observability that made DevFlow less useful
• AI-host or model behavior that misused DevFlow guidance

Separate confirmed DevFlow issues from app bugs, environment setup problems, and unknown causes.

5. Capture attempts, workarounds, and outcome

For each finding, record:

• symptom
• sanitized evidence summary with no session IDs, file paths, usernames, machine names, emails, private URLs, or other PII
• attempts and retries, especially repeated or contradictory actions
• workarounds tried
• final outcome: unresolved, worked around, solved, or unknown
• confidence level and why

Paraphrase private transcript content. Before sending, saving, or filing any report, scrub PII and identifiers including names, emails, usernames, session IDs, local file paths, machine names, private URLs, secrets, credentials, request bodies, screenshots, and user-specific text.

6. Report or file issues

Use references/reporting.md. Default to a markdown report. File GitHub issues only when the user asks and repository access works. For markdown reports, include the exact sections ## Environment and ## Findings; put unknown environment details under ## Environment as Unknown rather than omitting or guessing them.

For GitHub issues, prefer one issue per actionable MAUI DevFlow product problem. Merge near-duplicate session evidence into the same issue body instead of opening many low-signal issues.

Before saving markdown or filing issues, do a final privacy pass. If a useful finding cannot be explained without PII or local identifiers, omit it or replace the details with a generic description. Do not repeat the original private value in the output, even to say that it was scrubbed; say only that local paths, emails, private URLs, or other identifiers were redacted.

Optional Feedback Nudge

Other MAUI DevFlow skills may suggest this review when an agent has retried the same DevFlow workflow several times, tried multiple workarounds, or finishes a long DevFlow-assisted debugging session. That nudge should ask the user whether they want an opt-in review; it should not run this skill automatically.

Critical Anti-Patterns

References

• Session sources: references/session-sources.md
• Friction rubric: references/friction-rubric.md
• Environment fingerprint: references/environment-fingerprint.md
• Reporting and GitHub issues: references/reporting.md