
Planning Agent
Creates implementation plans and handoffs from conversation context
What You Can Do
This skill transforms high-level feature requests into actionable implementation plans by conducting deep requirement interviews, analyzing existing codebases (or planning greenfield projects), and producing comprehensive handoff documents. It distinguishes between brownfield development (with existing code to integrate) and greenfield projects (starting from scratch), ensuring your technical strategy accounts for your actual constraints and patterns.
Features
Asks multi-level discovery questions to clarify ambiguous requirements before planning
Reads codebase-map.md for brownfield projects to understand existing architecture and patterns
Automatically adapts planning strategy based on whether you're extending existing code or building new
Creates detailed implementation roadmaps with clear task breakdowns and dependencies
References session state through continuity ledger to maintain context across planning sessions
Surfaces hidden technical constraints and integration points before development begins
Organizes implementation steps in logical, testable phases
Example Output
Interview Output:
- Problem: "User spends 45 minutes daily exporting analytics data manually"
- Context: "Non-technical finance team needs daily reports by 9am"
- Constraint: "Must integrate with existing Salesforce API, not replace it"
Implementation Plan Output:
## Phase 1: Data Pipeline Setup
- Task 1.1: Create API client for Salesforce connector
- Task 1.2: Build data validation layer
- Task 1.3: Set up error handling & retry logic
## Phase 2: Export Engine
- Task 2.1: Implement CSV export formatter
- Task 2.2: Create email delivery service
- Task 2.3: Schedule daily execution
## Brownfield Integration Notes
- Extend existing `services/integrations/` directory
- Follow current authentication pattern in codebase
- Use existing error logging infrastructure
What's Included
- planning-agent SKILL.md: Core planning agent instructions and branching logic
- Interview template: Structured questions for requirement discovery across problem definition, user context, and technical constraints
- Handoff template: Markdown format for phase-based implementation plans with dependencies and entry points
- Brownfield checklist: Steps for codebase analysis and integration planning
- Continuity ledger reference: How to track and reference session state across planning iterations
Who It's For
- AI/Prompt Engineers — Building agent systems that require multi-stage planning workflows
- Software architects — Designing implementation strategies for complex features or system migrations
- Technical leads — Creating handoff documentation and task breakdowns for development teams
- Full-stack developers — Planning feature implementation across existing codebases with multiple constraints
- Product managers — Translating requirements into technical feasibility assessments and roadmaps
Best For
- Planning brownfield feature additions requiring integration with existing systems
- Greenfield project architecture design and tech stack planning
- Complex requirement gathering through structured discovery interviews
- Creating developer handoff documentation with phase sequencing
- Assessing technical feasibility and identifying hidden constraints early
- Building modular implementation plans with clear dependencies







