Agent skill
recipe-design
Execute from requirement analysis to design document creation
Install this agent skill to your Project
npx add-skill https://github.com/shinpr/claude-code-workflows/tree/main/skills/recipe-design
SKILL.md
Context: Dedicated to the design phase.
Orchestrator Definition
Core Identity: "I am not a worker. I am an orchestrator." (see subagents-orchestration-guide skill)
Execution Protocol:
- Delegate all work to sub-agents — your role is to invoke sub-agents, pass data between them, and report results
- Follow subagents-orchestration-guide skill design flow exactly:
- Execute: requirement-analyzer → technical-designer → document-reviewer → design-sync
- Stop at every
[Stop: ...]marker → Wait for user approval before proceeding
- Scope: Complete when design documents receive approval
CRITICAL: Execute document-reviewer, design-sync, and all stopping points defined in subagents-orchestration-guide skill flows — each serves as a quality gate. Skipping any step risks undetected inconsistencies.
Workflow Overview
Requirements → requirement-analyzer → [Stop: Scale determination]
↓
technical-designer → document-reviewer
↓
design-sync → [Stop: Design approval]
Scope Boundaries
Included in this skill:
- Requirement analysis with requirement-analyzer
- ADR creation (if architecture changes, new technology, or data flow changes)
- Design Doc creation with technical-designer
- Document review with document-reviewer
- Design Doc consistency verification with design-sync
Responsibility Boundary: This skill completes with design document (ADR/Design Doc) approval. Work planning and beyond are outside scope.
Requirements: $ARGUMENTS
Considering the deep impact on design, first engage in dialogue to understand the background and purpose of requirements:
- What problems do you want to solve?
- Expected outcomes and success criteria
- Relationship with existing systems
Once requirements are moderately clarified, analyze with requirement-analyzer and create appropriate design documents according to scale.
Clearly present design alternatives and trade-offs.
Execute the process below within design scope.
Completion Criteria
- Executed requirement-analyzer and determined scale
- Created appropriate design document (ADR or Design Doc) with technical-designer
- Executed document-reviewer and addressed feedback
- Executed design-sync for consistency verification
- Obtained user approval for design document
Output Example
Design phase completed.
- Design document: docs/design/[document-name].md or docs/adr/[document-name].md
- Approval status: User approved
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
implementation-approach
Implementation strategy selection framework. Use when planning implementation strategy, selecting development approach, or defining verification criteria.
recipe-fullstack-build
Execute decomposed fullstack tasks with layer-aware agent routing
recipe-reverse-engineer
Generate PRD and Design Docs from existing codebase through discovery, generation, verification, and review workflow
task-analyzer
Performs metacognitive task analysis and skill selection. Use when determining task complexity, selecting appropriate skills, or estimating work scale.
test-implement
Test implementation patterns and conventions. Use when implementing unit tests, integration tests, or E2E tests, including RTL+Vitest+MSW component testing and Playwright E2E testing.
recipe-implement
Orchestrate the complete implementation lifecycle from requirements to deployment
Didn't find tool you were looking for?