plan-generator

oimiragieo's avatarfrom oimiragieo

Creates structured plans from requirements. Generates comprehensive plans with steps, dependencies, risks, and success criteria. Coordinates with specialist agents for planning input and validates plan completeness.

⭐1stars🔀0forks📁View on GitHub🕐Updated Jan 11, 2026
[Project Management]

When & Why to Use This Skill

The Plan Generator skill is a powerful agentic tool designed to transform complex requirements into structured, actionable project plans. By coordinating with specialist agents and identifying critical dependencies, risks, and success criteria, it ensures that every phase of development—from feature implementation to system migration—is thoroughly validated and technically feasible, significantly reducing project ambiguity and execution errors.

Use Cases

  • New Feature Development: Automatically break down high-level product requirements into a sequence of actionable tasks with defined success criteria and agent assignments.
  • System Refactoring & Migration: Create detailed technical roadmaps for legacy system updates or cloud migrations, ensuring all dependencies and potential risks are mapped out.
  • Architecture Planning: Coordinate inputs from Architects and Database Experts to generate comprehensive system design plans before implementation begins.
  • Risk Assessment & Mitigation: Analyze project scopes to proactively identify technical, resource, or timeline risks and generate strategic mitigation plans.
  • Requirement Validation: Review existing project outlines to ensure all implicit and explicit requirements are addressed and that the plan is logically sound.
nameplan-generator
descriptionCreates structured plans from requirements. Generates comprehensive plans with steps, dependencies, risks, and success criteria. Coordinates with specialist agents for planning input and validates plan completeness.
allowed-toolsread, write, glob, search, codebase_search, Task
version1.0
error_handlinggraceful
streamingsupported
templates[feature-plan, refactoring-plan, migration-plan, architecture-plan]
Plan Generator Skill - Creates structured, validated plans from requirements by coordinating with specialist agents and generating comprehensive planning artifacts. - Creating plans for new features - Planning refactoring efforts - Planning system migrations - Planning architecture changes - Breaking down complex requirements - Validating existing plans

Step 1: Analyze Requirements

Parse user requirements:

  • Extract explicit requirements
  • Identify implicit requirements
  • Determine planning scope
  • Assess complexity

Step 2: Coordinate Specialists

Request planning input from relevant agents:

  • Analyst: Business requirements and market context
  • PM: Product requirements and user stories
  • Architect: Technical architecture and design
  • Database Architect: Data requirements
  • UX Expert: Interface requirements

Step 3: Generate Plan Structure

Create plan following template:

  • Load template from .factory/templates/plan-template.md
  • Define objectives
  • Break down into steps (≤7 steps per section)
  • Identify dependencies
  • Assign agents to steps

Step 4: Assess Risks

Identify risks and mitigation:

  • Technical risks
  • Resource risks
  • Timeline risks
  • Dependency risks
  • Mitigation strategies

Step 5: Validate Plan

Validate plan completeness:

  • All requirements addressed
  • Dependencies mapped
  • Success criteria defined
  • Risks identified
  • Plan is feasible

Step 6: Generate Artifacts

Create plan artifacts:

  • Plan markdown: .factory/context/artifacts/plan-<id>.md
  • Plan JSON: .factory/context/artifacts/plan-<id>.json
  • Plan summary
**Feature Development Plan**:
  • Objectives: Feature goals
  • Steps: Analysis → Design → Implementation → Testing
  • Agents: Analyst → PM → Architect → Developer → QA

Refactoring Plan:

  • Objectives: Code quality goals
  • Steps: Analysis → Planning → Implementation → Validation
  • Agents: Code Reviewer → Refactoring Specialist → Developer → QA

Migration Plan:

  • Objectives: Migration goals
  • Steps: Analysis → Planning → Execution → Validation
  • Agents: Architect → Legacy Modernizer → Developer → QA

Architecture Plan:

  • Objectives: Architecture goals
  • Steps: Analysis → Design → Validation → Documentation
  • Agents: Architect → Database Architect → Security Architect → Technical Writer
**Integration with Planner Agent**: Planner agent uses this skill to: - Generate plans from requirements - Coordinate specialist input - Validate plan completeness - Track plan execution
  1. Coordinate Early: Get specialist input before finalizing plan
  2. Keep Steps Focused: ≤7 steps per plan section
  3. Map Dependencies: Clearly identify prerequisites
  4. Assess Risks: Identify and mitigate risks proactively
  5. Validate Thoroughly: Ensure plan is complete and feasible
**Example Plan Output**

Command: "Generate plan for user authentication feature"

Generated Plan:

# Plan: User Authentication Feature

## Objectives

- Implement JWT-based authentication
- Support login, logout, and session management
- Provide secure password handling

## Steps

### Step 1: Requirements Analysis

- **Agent**: analyst
- **Dependencies**: none
- **Tasks**: Analyze auth requirements, research best practices
- **Success Criteria**: Requirements document complete

### Step 2: Architecture Design

- **Agent**: architect
- **Dependencies**: Step 1
- **Tasks**: Design auth architecture, select technologies
- **Success Criteria**: Architecture document complete

### Step 3: Implementation

- **Agent**: developer
- **Dependencies**: Step 2
- **Tasks**: Implement auth endpoints, JWT handling, password hashing
- **Success Criteria**: All tests passing, code reviewed

### Step 4: Testing

- **Agent**: qa
- **Dependencies**: Step 3
- **Tasks**: Write tests, perform security testing
- **Success Criteria**: Test coverage >80%, security validated