Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Dec 20, 2025

Documented how to use the debug-agentic-workflow agent for interactive debugging and the /q command for automated workflow optimization.

Changes

AGENTS.md (+543 lines)

debug-agentic-workflow agent:

  • Invocation by selecting debug-agentic-workflow from the agents dropdown in Copilot Chat
  • 4 debugging scenarios: failed runs, general debugging, missing tools, performance
  • Step-by-step walkthrough with agent-user interaction flow
  • Available gh aw commands and debugging tips

/q command:

  • Automated workflow optimization via issue/PR comments
  • 4 use cases: general optimization, specific workflows, performance, permissions
  • Output expectations: comments when no changes needed, PRs with detailed analysis
  • Comparison table: /q (automated) vs debug agent (interactive)

Quick reference:

  • Decision tree for tool selection
  • Command reference table
  • Common problems → solutions mapping
  • Workflow debugging checklist

README.md (+9 lines)

Added "Debugging Workflows" section with links to both tools.

Examples

Interactive debugging:

First, select debug-agentic-workflow from the agents dropdown in Copilot Chat, then:

Investigate this failed run: 
https://github.com/owner/repo/actions/runs/12345678

Automated optimization:

/q Fix the issue-triage workflow - missing tool errors

Result: Creates PR with missing tools added, permissions fixed, and validation status.

Original prompt

Document

  • how to use debug-agentix-workflows agent to debug workflows
  • how to use /q to debug improve workflows

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI changed the title [WIP] Document usage of debug-agentix-workflows agent for debugging Add comprehensive documentation for debug-agentic-workflow agent and /q command Dec 20, 2025
Copilot AI requested a review from pelikhan December 20, 2025 21:04
README.md Outdated
When your agentic workflows need debugging or optimization:

- **Quick automated fixes**: Comment `/q` in any issue or PR to automatically optimize workflows
- **Interactive debugging**: Use `@debug-agentic-workflow` in GitHub Copilot Chat for guided troubleshooting
Copy link
Collaborator

Choose a reason for hiding this comment

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

@copilot this is not correct. The user must choose "debug-agentic-workflow" as the agent in the "create agentic task" dialog

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Fixed in commit 3a6c3a4. Updated documentation to correctly instruct users to select debug-agentic-workflow from the agents dropdown in Copilot Chat, rather than using @ mentions. All references throughout AGENTS.md and README.md have been updated with the correct invocation method.

Copilot AI requested a review from pelikhan December 20, 2025 21:14
@pelikhan pelikhan marked this pull request as ready for review December 20, 2025 21:16
@pelikhan pelikhan merged commit 845d48f into main Dec 20, 2025
@pelikhan pelikhan deleted the copilot/document-debug-workflows branch December 20, 2025 21:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants