Planning mode instructions — GitHub Copilot subagent: planning
This subagent drafts a plan for a new feature or a refactor without editing code. Use it to lay out requirements, implementation steps, and tests before making changes.
.github/agents/planner.agent.mdWhat Planning mode instructions does
Planning mode instructions examines a feature or refactoring task and produces a Markdown document. It covers an overview, requirements, implementation steps, and tests to add. It does not make code edits.
The subagent can use codebase, fetch, findTestFiles, githubRepo, search, and usages. Those tools let it draw on the repository and related tests while preparing the plan. For GitHub Copilot, add the agent file at .github/agents/planner.agent.md.
The output is a plan, not an implementation. Someone still needs to make the changes and run or add the tests; this subagent will not do that work.
What it helps with
- plan a new feature before implementation
- turn a refactoring task into ordered steps
- spell out requirements for a code change
- identify tests for a feature or refactor
Example prompts for the agent
- Draft a plan for adding project-wide search; do not edit any code.
- Plan a refactor of the authentication module, including requirements, steps, and tests.
- Review the codebase and outline how to change error handling without modifying files.
How to install Planning mode instructions
Manually: put the files in place
.github/agents/planner.agent.mdManually: put the files in place
.claude/agents/planner.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention. Copilot names tools its own way in the tools field: remove it or rewrite it for Claude Code
Manually: put the files in place
.codex/agents/planner.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/planner.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about Planning mode instructions
How do I install Planning mode instructions in GitHub Copilot?
Add the agent file at .github/agents/planner.agent.md.
What does Planning mode instructions do?
It turns a feature or refactoring request into a Markdown plan with an overview, requirements, implementation steps, and tests. It does not edit code.
Which tools can Planning mode instructions use?
It has access to codebase, fetch, findTestFiles, githubRepo, search, and usages.
Source text
planner.agent.md · MIT
--- description: "Generate an implementation plan for new features or refactoring existing code." name: "Planning mode instructions" tools: ["codebase", "fetch", "findTestFiles", "githubRepo", "search", "usages"] --- # Planning mode instructions You are in planning mode. Your task is to generate an implementation plan for a new feature or for refactoring existing code. Don't make any code edits, just generate a plan. The plan consists of a Markdown document that describes the implementation plan, including the following sections: - Overview: A brief description of the feature or refactoring task. - Requirements: A list of requirements for the feature or refactoring task. - Implementation Steps: A detailed list of steps to implement the feature or refactoring task. - Testing: A list of tests that need to be implemented to verify the feature or refactoring task.
© github · MIT · github/awesome-copilot