Convert create-agentic-workflow.prompt.md to custom agent format #2837

Copilot · 2025-10-31T00:05:55Z

Plan: Convert create-agentic-workflow.prompt.md to custom agent format

Understanding

Currently: create-agentic-workflow.prompt.md is stored in .github/prompts/
Target: Convert to create-agentic-workflow.md in .github/agents/
The prompt file uses frontmatter with description, tools, and model fields
Custom agents use frontmatter with name, description, and tools fields
Custom agent files use .md extension (not .agent.md)

Changes Completed

Testing

All unit tests passing
Manual testing confirmed:
- Init command creates agent file at .github/agents/create-agentic-workflow.md
- Old prompt file is removed if it exists
- Success message displays correct agent path: @.github/agents/create-agentic-workflow.md
- Makefile sync works correctly with new file structure
- Build completes successfully
- All code properly formatted

Implementation Details

The conversion involved:

Converting frontmatter from prompt format (description, tools array as string, model) to agent format (name, description, tools array)
Creating new helper function ensureAgentFromTemplate similar to ensurePromptFromTemplate but for agents directory
Updating ensureAgenticWorkflowPrompt to remove old prompt files instead of creating them
Updating all test assertions to check for agent files instead of prompt files
Updating Makefile to sync from .github/agents/ instead of .github/prompts/
Running make fmt to ensure all code is properly formatted
Using .md extension to match the repository convention for custom agents (same as technical-doc-writer.md)

Original prompt

convert create-agentic-workflow.prompt.md to an custom agent

update "init" command to delete create-agentic-workflow.prompt.md and write agents/create-agentic-workflow.agent.md

💡 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.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

- Created new agent template at pkg/cli/templates/create-agentic-workflow.agent.md - Agent uses proper frontmatter with 'name', 'description', and 'tools' fields - Updated init command to create agent file instead of prompt file - Init command now removes old prompt file if it exists - Updated all tests to reflect the new agent file structure - Updated documentation in init_command.go and success messages - All unit tests passing Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

- Moved .github/prompts/create-agentic-workflow.prompt.md to .github/agents/create-agentic-workflow.agent.md - Updated Makefile sync-templates to copy agent file instead of prompt file - Removed old template file pkg/cli/templates/create-agentic-workflow.prompt.md - All tests passing with new file structure Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

pelikhan · 2025-10-31T00:51:06Z

@copilot format and fix tests

- Fixed trailing whitespace in agentic_workflow_prompt_test.go - Reformatted JSON arrays in github-workflow.json schema - All tests passing Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2025-10-31T00:56:43Z

@copilot format and fix tests

Done in 2f3f9ff. Ran make fmt which fixed trailing whitespace and reformatted JSON arrays. All tests passing.

github-actions · 2025-10-31T02:52:54Z

Agentic Changeset Generator triggered by this pull request.

Copilot

Pull Request Overview

This PR converts the existing create-agentic-workflow.prompt.md file to the custom agent format. The change migrates from GitHub Copilot slash commands to custom agents by converting frontmatter from prompt format to agent format and updating all related infrastructure.

Converted frontmatter from prompt format (description, tools array as string, model) to agent format (name, description, tools array)
Updated init command to create agent files instead of prompt files and remove old prompt files
Modified all tests and documentation to reference the new agent file structure

Reviewed Changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
pkg/cli/templates/create-agentic-workflow.agent.md	Converted template from prompt to agent format with proper YAML frontmatter
pkg/cli/init_test.go	Updated test assertions to verify agent file creation instead of prompt files
pkg/cli/init_command.go	Updated command description and success message to reference agent files
pkg/cli/init.go	Modified to remove old prompt files and create new agent files
pkg/cli/copilot-prompts.go	Added ensureAgentFromTemplate function for agent file management
pkg/cli/compile_instructions_test.go	Updated test variable names and error messages for agent files
pkg/cli/commands.go	Changed embedded template variable from prompt to agent
pkg/cli/agentic_workflow_prompt_test.go	Renamed test functions and updated to test agent functionality
pkg/cli/add_command.go	Modified ensureAgenticWorkflowPrompt to remove old files and added ensureAgenticWorkflowAgent
Makefile	Updated sync-templates rule to copy from agents directory instead of prompts
.github/workflows/unbloat-docs.lock.yml	Updated Node.js action version
.github/agents/create-agentic-workflow.agent.md	Converted agent file with proper frontmatter format

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

pelikhan · 2025-10-31T02:53:15Z

@copilot custom agent markdown files must be under .github/agents but they do not need the .agent.md extension

- Renamed .github/agents/create-agentic-workflow.agent.md to create-agentic-workflow.md - Renamed pkg/cli/templates/create-agentic-workflow.agent.md to create-agentic-workflow.md - Updated all references in code, tests, and Makefile - Custom agent files in .github/agents don't need .agent.md extension, just .md - Matches convention used by existing technical-doc-writer.md agent - All tests passing Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2025-10-31T03:01:47Z

@copilot custom agent markdown files must be under .github/agents but they do not need the .agent.md extension

Fixed in 5553402. Renamed from create-agentic-workflow.agent.md to create-agentic-workflow.md to match the convention used by other agents like technical-doc-writer.md. Updated all references in code, tests, and Makefile.

This PR updates the documentation based on features merged in the last 24 hours. ## Documentation Updates ### Custom Agent Files (PR #2838, #2837) - Added comprehensive documentation for custom agent files in the AI Engines reference - Documented the new imports-based approach for agent files - Provided migration guide from deprecated `engine.custom-agent` field - Included examples of creating and using custom agents ### Permission Validation (PR #2843) - Documented new permission validation behavior in non-strict mode - Added examples of warning messages when permissions are under-provisioned - Explained the difference between non-strict and strict mode validation - Provided actionable guidance for resolving permission warnings ### Agent File Imports (PR #2838) - Updated Imports reference to explain agent file imports - Clarified that only one agent file can be imported per workflow - Cross-referenced Custom Agent Files documentation in Engines reference ## Changes Made - Updated `docs/src/content/docs/reference/engines.md`: - Added "Custom Agent Files" section with creation and usage examples - Documented agent file requirements and constraints - Provided migration guide from `engine.custom-agent` to `imports` - Updated `docs/src/content/docs/reference/frontmatter.md`: - Added "Permission Validation" subsection under Permissions - Documented non-strict mode warning behavior - Documented strict mode error behavior - Included example warning messages - Updated `docs/src/content/docs/reference/imports.md`: - Added "Agent Files" section - Updated "Frontmatter Merging" to mention agent file fields 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>

Initial plan

d75cfce

Copilot AI assigned Copilot and pelikhan Oct 31, 2025

Copilot started work on behalf of pelikhan October 31, 2025 00:06 View session

Copilot AI and others added 3 commits October 31, 2025 00:14

Initial exploration complete

d5fab5e

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Convert create-agentic-workflow prompt to custom agent~~ Convert create-agentic-workflow.prompt.md to custom agent format Oct 31, 2025

Copilot finished work on behalf of pelikhan October 31, 2025 00:27

Copilot AI requested a review from pelikhan October 31, 2025 00:27

pelikhan approved these changes Oct 31, 2025

View reviewed changes

Copilot started work on behalf of pelikhan October 31, 2025 00:51 View session

Run formatting and fix tests

2f3f9ff

- Fixed trailing whitespace in agentic_workflow_prompt_test.go - Reformatted JSON arrays in github-workflow.json schema - All tests passing Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI requested a review from pelikhan October 31, 2025 00:57

Copilot finished work on behalf of pelikhan October 31, 2025 00:57

pelikhan marked this pull request as ready for review October 31, 2025 02:52

Copilot AI review requested due to automatic review settings October 31, 2025 02:52

Copilot AI reviewed Oct 31, 2025

View reviewed changes

Copilot started work on behalf of pelikhan October 31, 2025 02:53 View session

Copilot finished work on behalf of pelikhan October 31, 2025 03:03

pelikhan merged commit cf9598e into main Oct 31, 2025
4 checks passed

pelikhan deleted the copilot/convert-create-agentic-workflow branch October 31, 2025 03:15

github-actions bot mentioned this pull request Oct 31, 2025

[docs] Update documentation for features from 2025-10-31 #2851

Merged

Copilot AI mentioned this pull request Oct 31, 2025

Format code and recompile workflows #2873

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Convert create-agentic-workflow.prompt.md to custom agent format #2837

Convert create-agentic-workflow.prompt.md to custom agent format #2837

Uh oh!

Copilot AI commented Oct 31, 2025 •

edited

Loading

Uh oh!

pelikhan commented Oct 31, 2025

Uh oh!

Copilot AI commented Oct 31, 2025

Uh oh!

github-actions bot commented Oct 31, 2025

Uh oh!

Copilot AI left a comment

Uh oh!

pelikhan commented Oct 31, 2025

Uh oh!

Copilot AI commented Oct 31, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Convert create-agentic-workflow.prompt.md to custom agent format #2837

Convert create-agentic-workflow.prompt.md to custom agent format #2837

Uh oh!

Conversation

Copilot AI commented Oct 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Plan: Convert create-agentic-workflow.prompt.md to custom agent format

Understanding

Changes Completed

Testing

Implementation Details

Uh oh!

pelikhan commented Oct 31, 2025

Uh oh!

Copilot AI commented Oct 31, 2025

Uh oh!

github-actions bot commented Oct 31, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

pelikhan commented Oct 31, 2025

Uh oh!

Copilot AI commented Oct 31, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Oct 31, 2025 •

edited

Loading