-
Notifications
You must be signed in to change notification settings - Fork 1.7k
fix: plan agent file with up to date format to use with Copilot CLI #489
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pull request overview
This PR updates the plan.agent.md file to use a YAML-based tools format compatible with Copilot CLI, replacing the previous JSON array format. The update includes migrating tool names to use namespace prefixes (e.g., search/codebase, vscode/extensions) and removing the deprecated findTestFiles tool and its associated documentation reference.
Key Changes:
- Converted tools specification from JSON array to YAML list format
- Added namespace prefixes to tool names for Copilot CLI compatibility
- Removed
findTestFilestool from both front matter and content
| --- | ||
| description: "Strategic planning and architecture assistant focused on thoughtful analysis before implementation. Helps developers understand codebases, clarify requirements, and develop comprehensive implementation strategies." | ||
| name: "Plan Mode - Strategic Planning & Architecture" | ||
| tools: ["codebase", "extensions", "fetch", "findTestFiles", "githubRepo", "problems", "search", "searchResults", "usages", "vscodeAPI"] | ||
| tools: | ||
| - search/codebase | ||
| - vscode/extensions | ||
| - web/fetch | ||
| - web/githubRepo | ||
| - read/problems | ||
| - azure-mcp/search | ||
| - search/searchResults | ||
| - search/usages | ||
| - vscode/vscodeAPI | ||
| --- |
Copilot
AI
Dec 14, 2025
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The front matter is missing the model field. According to AGENTS.md, it's strongly recommended to specify the model field for agent files. Consider adding a line like model: GPT-4.1 (or the appropriate model this agent is optimized for) after the name field.
| ### Information Gathering Tools | ||
|
|
||
| - **Codebase Exploration**: Use the `codebase` tool to examine existing code structure, patterns, and architecture | ||
| - **Search & Discovery**: Use `search` and `searchResults` tools to find specific patterns, functions, or implementations across the project |
Copilot
AI
Dec 14, 2025
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The content references the search tool on line 33, but this tool is not listed in the front matter tools array. Looking at other agent files like janitor.agent.md, both search and namespaced search tools like search/searchResults should be included separately. Consider adding - search to the tools list in the front matter, or update the content to reference the specific search tool that's available.
Pull Request Checklist
npm startand verified thatREADME.mdis up to date.Description
This update ensures that this agent file works with the the Copilot CLI. After attempting to use it with the Copilot CLI it was initially broken but it now works on the Copilot CLI mode!
Copilot CLI still does not have Plan mode natively so having a proper agent file that folks can use is important for now until a native plan mode feature is released. There's an Issue for that here: github/copilot-cli#783
Type of Contribution
Additional Notes
By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.