Agent skill

plan-implementation

Create implementation plans for features and changes. Use when user says "plan how to implement user authentication", "how should I add dark mode to the app", "what's the best way to refactor the database layer", "create a plan for migrating to the new API", or "I need to implement [feature] - help me plan it out".

View SKILL.md on GitHub Repository
Stars 30
Forks 9

Install this agent skill to your Project

npx add-skill https://github.com/Uniswap/ai-toolkit/tree/next/packages/plugins/development-planning/skills/plan-implementation

SKILL.md

Implementation Planner

Create clear, actionable implementation plans through collaborative multi-agent discussion and refinement.

When to Activate

  • User wants to implement a new feature
  • User asks "how should I implement X?"
  • User wants to add functionality
  • User needs to refactor or migrate code
  • Complex bug fixes requiring planning
  • Architectural changes or design decisions
  • Any task that benefits from structured planning

Quick Process

  1. Analyze Context: Understand the task, leverage any prior exploration
  2. Select Agents: Choose 3-10 specialists based on task complexity
  3. Collaborative Discussion: 2-3 rounds of multi-agent refinement
  4. Synthesize Plan: Generate comprehensive implementation plan
  5. Output File: Write plan to .claude-output/plan-[timestamp].md

Complexity-Based Planning

Task Type Agents Rounds Plan Length
Simple (bug fix, minor feature) 3-4 1-2 ~100-200 lines
Medium (features, refactors) 5-7 2-3 ~200-400 lines
Complex (architecture, major features) 8-10 2-3 ~400-600 lines

Plan Structure

Generated plans include:

  1. Overview - High-level summary
  2. Scope - What will/won't be implemented
  3. Current State - Relevant architecture and files
  4. API Design (optional) - Interfaces and data structures
  5. Implementation Steps - Clear sequential steps (5-7 typical)
  6. Files Summary - Files to create/modify
  7. Critical Challenges (optional) - Risks and mitigations
  8. Agent Collaboration Summary - Consensus and trade-offs

Workflow Integration

This is Step 2 of the implementation workflow:

  1. Explore → 2. Plan (this) → 3. Review → 4. Execute
  • Automatically uses context from prior exploration
  • Output plan can be reviewed with /review-plan
  • Approved plans execute with execute-plan skill

Detailed Reference

For agent selection, discussion protocols, and output formats, see planning-guide.md.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

Uniswap/ai-toolkit

review-plan

Review implementation plans for completeness and feasibility. Use when user says "review this plan before I start", "is this implementation plan complete", "check if this plan aligns with our patterns", "give me feedback on my implementation strategy", or "validate this plan before we execute it".

30 9
Explore
Uniswap/ai-toolkit

execute-plan

Execute implementation plans step-by-step. Use when user says "execute the plan", "implement the plan we created", "start building based on the plan", "go ahead and implement it", "proceed with the implementation", "execute as a stack", "create a PR stack while implementing", "implement with one PR per step", or references a plan file and wants to begin coding.

30 9
Explore
Uniswap/ai-toolkit

generate-commit-message

Generate well-structured git commit messages. Use when user says "generate commit message", "write a commit", "what should my commit message be", "create commit message for these changes", or needs help crafting conventional commit messages.

30 9
Explore
Uniswap/ai-toolkit

plan-swarm

Refine plans through multi-agent expert discussion. Use when user says "get multiple expert opinions on this plan", "I want different perspectives on this approach", "have the agents discuss this strategy", "refine the plan through collaborative review", or "what would different specialists think about this design".

30 9
Explore
Uniswap/ai-toolkit

create-pr

Create or update pull requests with conventional commits. Use when user says "create a PR for these changes", "submit this for review", "open a pull request", "push these changes and create a PR", "I'm ready to submit this work", or "create PR and link to issue

30 9
Explore
Uniswap/ai-toolkit

implement-spec

Orchestrate implementation of spec-workflow tasks. Use when user says "implement the spec", "execute spec tasks", "run the spec workflow", "implement spec-name tasks", or needs to coordinate agent execution for spec-workflow documents.

30 9
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results