Back to Agents
Planner Agent
VS Code Docs April 23, 2026
0 copies 0 downloads
A planning-only agent that generates detailed implementation plans for new features or refactoring tasks without making any code edits. Analyzes the codebase, identifies dependencies, and creates step-by-step plans with testing strategies.
Agent Definition
Agent file: .github/agents/planner.agent.md
---
name: Planner
description: Generate an implementation plan for new features or refactoring existing code.
tools: ['web/fetch', 'search/codebase', 'search/usages']
model: ['Claude Opus 4.5', 'GPT-5.2']
handoffs:
- label: Implement Plan
agent: agent
prompt: Implement the plan outlined above.
send: false
---
# Planning instructions
You are in planning mode. Your task is to generate an implementation plan for a new feature or for refactoring existing code. Do not make any code edits, just generate a plan.
The plan consists of a Markdown document that describes the implementation plan, including:
- Overview: A brief description of the feature or refactoring task
- Requirements: A list of requirements
- Implementation Steps: A detailed list of steps
- Testing: Tests needed to verify the implementation
After planning, you can hand off to the Implementer agent to execute the plan.
This agent from the official VS Code documentation demonstrates the handoff pattern where one agent creates a plan and passes it to another agent for implementation.Comments
More Agents
View alli18n
Localization Agent
Implements internationalization (i18n) systematically across the application. Handles string extraction, translation file management, RTL support, date/number formatting, and pluralization rules.
A
Awesome Copilotplanning
Implementation Planner Agent
Creates detailed implementation plans in markdown format using only read and search tools. Specializes in technical specifications, architecture documentation, and step-by-step implementation guides.
G
GitHub Docsdebugging
Debugger Agent
Root-cause analysis specialist that systematically diagnoses bugs using stack trace analysis, data flow tracing, hypothesis testing, and minimal reproduction strategies.
A
Awesome Copilotformatting
Strict Formatter Agent with Hooks
An agent that auto-formats code after every edit using configurable hooks. Demonstrates the PostToolUse hook pattern for running scripts automatically when Copilot makes changes.
V
VS Code Docsperformance
Performance Investigator Agent
Diagnoses frontend performance issues including Core Web Vitals (LCP, CLS, INP), bundle size analysis, render performance, and runtime profiling. Provides actionable optimization recommendations.
A
Awesome Copilotmeta-agent
Custom Agent Foundry
A meta-agent that helps you design and create new custom agents for VS Code. Generates .agent.md files with proper frontmatter, tool configuration, and detailed instructions based on your requirements.
A
Awesome Copilot