# Recipe Design

Execute from codebase-scoped analysis through optional ADR decisions to complete Design...

- Repository: https://github.com/shinpr/claude-code-workflows (708 stars)
- Category: Design
- License: MIT
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add shinpr/claude-code-workflows --skill recipe-design -g -a claude-code -y`
Codex: `npx skills add shinpr/claude-code-workflows --skill recipe-design -g -a codex -y`
Cursor: `npx skills add shinpr/claude-code-workflows --skill recipe-design -g -a cursor -y`
Gemini CLI: `npx skills add shinpr/claude-code-workflows --skill recipe-design -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add shinpr/claude-code-workflows`

## Description

Execute from codebase-scoped analysis through optional ADR decisions to complete Design Doc approval

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

**Explicit User Instruction**: The user explicitly instructs and authorizes every subagent call named in this recipe. Execute each applicable call when its prerequisites are met.

Execute Skill: documentation-criteria before document routing or creation.
Execute Skill: llm-friendly-context before writing Agent prompts, handoffs, or generated artifacts.
Execute Skill: subagents-orchestration-guide before invoking agents or resolving findings.
Before the first finding disposition, read `references/review-resolution.md` from the loaded subagents-orchestration-guide skill.

## Outcome and Ownership

Coordinate the design phase from repository evidence to an approved Design Doc. The user owns product requirements and exclusions; the orchestrator owns convergence readiness, Structural Scale, ADR qualification, evidence selection, and Review Resolution. Named specialists own semantic investigation and artifact authorship.

The Design Doc is always the complete implementation design for Medium/Large work. A qualifying ADR batch narrows technical choices before the Design Doc, which retains the complete flow and implementation boundary.

Requirements: $ARGUMENTS

## Flow

```text
requirement source -> codebase-analyzer -> scope/decision confirmation [Stop]
                                             |
                               optional ADR batch -> batch review [Stop]
                                             |
                 Design Doc -> code-verifier -> Review Resolution
                                             |
                     document-reviewer -> design-sync -> approval [Stop]
```

Execute each dependent step after its prerequisite evidence exists. Use Review Resolution for every actionable verifier, reviewer, or design-sync finding. Wait at each `[Stop]` for explicit user confirmation.

The rest: https://github.com/shinpr/claude-code-workflows/blob/HEAD/dev-workflows-fullstack/skills/recipe-design/SKILL.md