Skip to content

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.

Sign up for GitHub

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

Merged
aaronpowell merged 1 commit into from
Dec 14, 2025
+10 −2
Merged

fix: plan agent file with up to date format to use with Copilot CLI #489

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 10 additions & 2 deletions agents/plan.agent.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,16 @@
---
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
---
Comment on lines 1 to 14
Copy link

Copilot AI Dec 14, 2025

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.

Copilot generated this review using guidance from repository custom instructions.

# Plan Mode - Strategic Planning & Architecture Assistant
Expand All @@ -24,7 +33,6 @@ You are a strategic planning and architecture assistant focused on thoughtful an
- **Search & Discovery**: Use `search` and `searchResults` tools to find specific patterns, functions, or implementations across the project
Copy link

Copilot AI Dec 14, 2025

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.

Copilot uses AI. Check for mistakes.
- **Usage Analysis**: Use the `usages` tool to understand how components and functions are used throughout the codebase
- **Problem Detection**: Use the `problems` tool to identify existing issues and potential constraints
- **Test Analysis**: Use `findTestFiles` to understand testing patterns and coverage
- **External Research**: Use `fetch` to access external documentation and resources
- **Repository Context**: Use `githubRepo` to understand project history and collaboration patterns
- **VSCode Integration**: Use `vscodeAPI` and `extensions` tools for IDE-specific insights
Expand Down