Convert embedded custom agents to prompt file format

[Copilot]

Conversion Plan: Custom Agents to Prompt Files

• Analyze current agent files in .github/agents/ directory
• Create .github/prompts/ directory structure
• Convert each agent file (.md) to prompt file format (.prompt.md):
  • create-agentic-workflow.md → create-agentic-workflow.prompt.md
  • setup-agentic-workflows.md → setup-agentic-workflows.prompt.md
  • debug-agentic-workflow.md → debug-agentic-workflow.prompt.md
  • create-shared-agentic-workflow.md → create-shared-agentic-workflow.prompt.md
  • All other embedded agents converted
• Update init command to generate prompt files instead of agent files:
  • Modify ensureAgentFromTemplate to ensurePromptFromTemplate
  • Update directory from .github/agents/ to .github/prompts/
  • Add .prompt.md extension to generated files
  • Add code to delete old agent files after creating prompts
• Update template files in pkg/cli/templates/:
  • Convert template format to prompt file format with proper frontmatter
  • Ensure mode: agent frontmatter is present
• Update tests:
  • Modify tests to expect prompt files instead of agent files
  • Update test assertions for new file locations
• Run full test suite and fix any failures
• Update documentation to reference prompts instead of agents
• Manual verification with CLI
• Fix Makefile to sync prompt templates
• Clarify documentation about prompt files vs custom agents

Summary

Successfully converted all embedded custom agents from .github/agents/*.md to .github/prompts/*.prompt.md format:

• Init command: Now generates prompt files instead of agent files
• Template files: All templates updated with mode: agent frontmatter
• Cleanup: Old agent files automatically deleted when creating prompts
• Tests: All unit tests updated and passing
• Documentation: Updated to reference prompts and slash commands instead of /agent selection
• Manual verification: Tested with gh aw init command, confirms proper file creation
• Makefile: Updated to sync prompt templates from .github/prompts/
• Glossary: Added Prompt Files entry and clarified Custom Agents entry to distinguish between:
  • Prompt files (.github/prompts/*.prompt.md) for Copilot Chat slash commands
  • Agent files (.github/agents/*.md) for workflow imports via imports field
  • Instruction files (.github/copilot/instructions/) for path-specific Copilot instructions

Original prompt

Convert all embedded custom agents (.github/agents/.md) to the prompt file format (.github/prompts/.prompt.md).

update init command to generate prompt file
add code in init to delete old agent file
update docs to notify that we are using prompts now

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[pelikhan]

@copilot reference to the agent /agent in the cli and docs and update to using prompt files.

[Copilot]

@copilot reference to the agent /agent in the cli and docs and update to using prompt files.

Updated documentation to clarify the distinction between prompt files and custom agents:

• Added "Prompt Files" entry to glossary explaining they're used for Copilot Chat slash commands (7489baf)
• Updated "Custom Agents" glossary entry to distinguish between:
  • Prompt files (.github/prompts/*.prompt.md) - for interactive Copilot Chat commands
  • Agent files (.github/agents/*.md) - for workflow imports via imports field
  • Instruction files (.github/copilot/instructions/) - for path-specific Copilot behavior
• Updated custom-agents.md reference to mention "Built-in Prompts" created by gh aw init

All previous commits already updated docs to change /agent command references to direct slash commands like /create-agentic-workflow.