Skills

Recipe Design

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

Install

npx skills add shinpr/claude-code-workflows --skill recipe-design -g -a claude-code -y
Category
Design
Updated
7d ago
License
MIT
Context cost
Mediumabout 2,344 tokens
Runs scripts
No, instructions only

What it does

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

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

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.

Read the whole SKILL.md on GitHub

More in Design