Add AGENTS.md documenting agentic workflows with MCP tools for compilation

[Copilot]

Created AGENTS.md to document that this repository contains GitHub Agentic Workflows, list available custom agents, and emphasize using the GitHub Agentic Workflows MCP tools for compilation.

Contents

• Overview: Explains agentic workflows are AI-powered automation workflows using markdown + YAML frontmatter
• Documentation reference: Links to .github/aw/github-agentic-workflows.md for complete workflow specification
• Custom agents: Documents two available agents:
  • create-agentic-workflow: Interactive workflow design and generation
  • debug-agentic-workflow: Log analysis and workflow troubleshooting
• Compilation requirement: Emphasizes agents MUST use the GitHub Agentic Workflows MCP tools (compile, status, logs, audit) for workflow compilation exclusively

MCP Tools (Only Method)

Agents must use the agentic-workflows MCP server tools:

tools:
  agentic-workflows:

This provides access to:

• compile - Compile markdown workflows to YAML
• status - Show workflow file status
• logs - Download and analyze workflow logs
• audit - Investigate workflow failures

Note: CLI commands (gh aw compile) are not available in the agent environment due to authentication constraints and have been removed from the documentation.

The file serves as the entry point for agents working with this repository, ensuring they understand the MCP-based workflow compilation tools are the required method for managing agentic workflows.

Original prompt

Create AGENT.md file that explains that this repository holds agentic workflows, which are explained in the GitHub agentic workflows.md file.

Also list the custom agents availabe.

Insist that after any operation, the agent should run "gh aw compile " and fix all errors.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[pelikhan]

@copilot

• rename to AGENTS.md
• insider on use the GitHub agentic workflows MCP tools to compile

[Copilot]

@copilot

• rename to AGENTS.md
• insider on use the GitHub agentic workflows MCP tools to compile

Done in 7252db9:

• Renamed to AGENTS.md (plural)
• Added prominent section emphasizing agents MUST use the GitHub Agentic Workflows MCP tools (compile, status, logs, audit) with CLI as fallback only

[pelikhan]

@copilot gh commands will not work because it is not authenticated.

[Copilot]

@copilot gh commands will not work because it is not authenticated.

Removed all gh CLI references in 5020b1e. Documentation now only mentions MCP tools as the compilation method since CLI commands won't work without authentication.