recipe-plan
$
npx mdskill add shinpr/claude-code-workflows/recipe-planOrchestrates sub-agents to create work plans from design documents and obtain approval.
- Helps automate the planning phase by generating work plans and test skeletons.
- Integrates with sub-agents like acceptance-test-generator and work-planner.
- Follows a strict execution protocol defined in the subagents-orchestration-guide skill.
- Presents results through user notifications and approval requests before completion.
SKILL.md
.github/skills/recipe-planView on GitHub ↗
---
name: recipe-plan
description: Create work plan from design document and obtain plan approval
disable-model-invocation: true
---
**Context**: Dedicated to the planning phase.
## Orchestrator Definition
**Core Identity**: "I am an orchestrator." (see subagents-orchestration-guide skill)
**Execution Protocol**:
1. **Delegate all work** to sub-agents — your role is to invoke sub-agents, pass data between them, and report results
2. **Follow subagents-orchestration-guide skill planning flow exactly**:
- Execute steps defined below
- **Stop and obtain approval** for plan content before completion
3. **Scope**: See Scope Boundaries below
**CRITICAL**: When the user requests test generation, always execute acceptance-test-generator first — it provides the test skeleton that work-planner depends on.
## Scope Boundaries
**Included in this skill**:
- Design document selection
- Test skeleton generation with acceptance-test-generator
- Work plan creation with work-planner
- Plan approval obtainment
**Responsibility Boundary**: This skill completes with work plan approval.
Follow the planning process below:
## Execution Process
### Step 1: Design Document Selection
! ls -la docs/design/*.md | head -10
- Check for existence of design documents, notify user if none exist
- Present options if multiple exist (can be specified with $ARGUMENTS)
### Step 2: E2E Test Skeleton Generation Confirmation
- Confirm with user whether to generate E2E test skeleton first
- If user wants generation: Generate test skeleton with acceptance-test-generator
- Pass generation results to next process according to subagents-orchestration-guide skill coordination specification
### Step 3: Work Plan Creation
Invoke work-planner using Agent tool:
- `subagent_type`: "dev-workflows:work-planner"
- `description`: "Work plan creation"
- If test skeletons were generated in Step 2:
- When `generatedFiles.e2e` is not null:
`prompt`: "Create work plan from Design Doc at [path]. Integration test file: [integration test path]. E2E test file: [E2E test path]. Integration tests are created simultaneously with each phase implementation, E2E tests are executed only in final phase."
- When `generatedFiles.e2e` is null:
`prompt`: "Create work plan from Design Doc at [path]. Integration test file: [integration test path]. No E2E test skeletons were generated (reason: [e2eAbsenceReason]). Integration tests are created simultaneously with each phase implementation."
- If test skeletons were not generated:
`prompt`: "Create work plan from Design Doc at [path]."
- Follow subagents-orchestration-guide Prompt Construction Rule for additional prompt parameters
- Present work plan to user for review. If user requests changes, re-invoke work-planner with revised parameters
- Highlight steps with unclear scope or external dependencies and ask user to confirm
## Response at Completion
**Recommended**: End with the following standard response after plan content approval
```
Planning phase completed.
- Work plan: docs/plans/[plan-name].md
- Status: Approved
Please provide separate instructions for implementation.
```
More from shinpr/claude-code-workflows
- ai-development-guideTechnical decision criteria, anti-pattern detection, debugging techniques, and quality check workflow. Use when making technical decisions, detecting code smells, or performing quality assurance.
- coding-principlesLanguage-agnostic coding principles for maintainability, readability, and quality. Use when implementing features, refactoring code, or reviewing code quality.
- documentation-criteriaDocumentation creation criteria including PRD, ADR, Design Doc, and Work Plan requirements with templates. Use when creating or reviewing technical documents, or determining which documents are required.
- frontend-ai-guideFrontend-specific technical decision criteria, anti-patterns, debugging techniques, and quality check workflow. Use when making frontend technical decisions or performing quality assurance.
- implementation-approachImplementation strategy selection framework. Use when planning implementation strategy, selecting development approach, or defining verification criteria.
- integration-e2e-testingIntegration and E2E test design principles, ROI calculation, test skeleton specification, and review criteria. Use when designing integration tests, E2E tests, or reviewing test quality.
- recipe-add-integration-testsAdd integration/E2E tests to existing codebase using Design Docs
- recipe-buildExecute decomposed tasks in autonomous execution mode
- recipe-designExecute from requirement analysis to design document creation
- recipe-diagnoseInvestigate problem, verify findings, and derive solutions