Skip to main content
subagent official · GitHub

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.

Install into GitHub Copilot · Manually: put the files in place All methods and platforms ↓
.github/agents/planner.agent.md
Open on GitHub

What 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.md

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

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set949

The whole set →
Power BI Data Modeling Expert Mode This subagent helps design star schemas, manage table relationships, and configure composite models in Power BI following Microsoft guidance. ★ 40,451repo stars PostgreSQL Database Administrator Subagent for managing PostgreSQL databases with the VS Code extension. It executes queries, inspects schemas, and handles admin tasks directly in Copilot. ★ 40,451repo stars Playwright Tester Mode A GitHub Copilot subagent that walks the site through Playwright MCP first, then writes and runs TypeScript tests. ★ 40,451repo stars Platform SRE for Kubernetes Enforces production-grade Kubernetes standards, strict security contexts, and safe rollout procedures with automated dry-run checks in GitHub Copilot. ★ 40,451repo stars Plan Mode - Strategic Planning & Architecture A subagent that reads your codebase and requirements before any code gets written. Useful when a task's scope is unclear and you need a starting point. ★ 40,451repo stars Pimcore Expert Assists with Pimcore 11+ architecture, Symfony 6 integration, and modern PHP 8.2 code. Helps model DataObjects, build Areabricks, and implement e-commerce workflows. ★ 40,451repo stars PHP MCP Expert Assists in building Model Context Protocol servers in PHP 8.2+ using the official PHP SDK. Generates tools, resources, and prompts with PHP attributes. ★ 40,451repo stars PagerDuty Incident Responder A GitHub Copilot subagent that works through PagerDuty incidents: reads the context, hunts for recent code changes, and proposes a fix as a pull request. ★ 40,451repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor