Planner — Agent Skill by GitHub

From the author

Generate an implementation plan for new features or refactoring existing code.

— the description by aaronpowell

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The planner skill acts as a preparatory agent designed to outline technical work before any code is written. By focusing exclusively on planning, it helps developers organize their thoughts, identify requirements, and define testing strategies for new features or refactoring efforts. It produces a structured Markdown document containing an overview, requirements, step-by-step implementation instructions, and a testing plan, ensuring that the development process is methodical and well-documented.

What it does

Generates comprehensive implementation plans for new software features.
Creates structured roadmaps for refactoring existing codebases.
Defines clear requirements and technical objectives for development tasks.
Outlines granular, step-by-step implementation procedures.
Identifies necessary testing strategies to validate changes.

When to use it

Before starting work on a complex new feature that requires architectural consideration.
When planning a significant refactor to ensure minimal disruption to existing functionality.
When you need to communicate a technical approach to team members before implementation.
To break down large development tasks into manageable, actionable steps.

Advantages

Prevents premature coding by enforcing a structured planning phase.
Improves code quality through thoughtful architectural design.
Provides a clear roadmap that reduces ambiguity during the development process.
Ensures that testing requirements are considered early in the lifecycle.

Usage examples

“Create an implementation plan for adding a user authentication feature using OAuth2.”: The agent generates a Markdown document detailing the requirements, API endpoints, database schema changes, and a step-by-step integration plan with a testing strategy.
“Generate a plan to refactor the existing payment processing module to improve error handling.”: The agent provides a structured plan outlining the current issues, proposed refactoring steps, and a list of unit tests to ensure no regressions occur during the process.

Install

Download the custom agent as a ZIP:
https://autogineer.com/agent-skills/github/planner/download

Extract the agent file into .github/agents, then commit it:

mkdir -p .github/agents && unzip -j planner.zip 'planner/planner.agent.md' -d .github/agents

Keep the LICENSE and ATTRIBUTION.md files from the ZIP with your copy.

Documentation by aaronpowell

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.

Files

ATTRIBUTION.mdAdded by AutoGineer862 B
LICENSELicence file added by AutoGineer1.0 KiB
planner.agent.md877 B

planner.agent.md

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.

Requirements and compatibility

Written for: GitHub Copilot

Works with: GitHub Copilot

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Setup TS Deep Modules
Matt Pocock· Community
Configures dependency-cruiser to enforce deep module boundaries in TypeScript repositories.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskHas scriptsGitHub stars of the source repository317.5k
To Spec
Matt Pocock· Community
Synthesizes conversation context into a structured technical specification and publishes it to a project issue tracker.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
Improve Codebase Architecture
Matt Pocock· Community
A systematic process to identify, visualize, and refine architectural deepening opportunities in a codebase.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
Domain Modeling
Matt Pocock· Community
An expert assistant for defining project terminology, maintaining a glossary, and documenting architectural decisions.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
Codebase Design
Matt Pocock· Community
A shared vocabulary and set of principles for designing deep, testable, and maintainable software modules.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
Prototype
Matt Pocock· Community
Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k