recipe-design

Execute from requirement analysis to design document creation

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "recipe-design" with this command: npx skills add shinpr/claude-code-workflows/shinpr-claude-code-workflows-recipe-design

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:

  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 design flow exactly:
    • Execute: requirement-analyzer → technical-designer → document-reviewer → design-sync
    • Stop at every [Stop: ...] marker → Wait for user approval before proceeding
  3. 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

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

Coding

testing-principles

No summary provided by upstream source.

Repository SourceNeeds Review
Coding

coding-principles

No summary provided by upstream source.

Repository SourceNeeds Review
Coding

integration-e2e-testing

No summary provided by upstream source.

Repository SourceNeeds Review
Coding

ai-development-guide

No summary provided by upstream source.

Repository SourceNeeds Review