{"id":"9b7ea328-274b-4d09-915c-fe3d1d6bda36","shortId":"M6uwFc","kind":"skill","title":"recipe-design","tagline":"Execute from requirement analysis to design document creation","description":"**Context**: Dedicated to the design phase.\n\n## Orchestrator Definition\n\n**Core Identity**: \"I am an orchestrator.\" (see subagents-orchestration-guide skill)\n\n**Execution Protocol**:\n1. **Delegate all work** to sub-agents — your role is to invoke sub-agents, pass data between them, and report results\n2. **Follow subagents-orchestration-guide skill design flow exactly**:\n   - Execute: requirement-analyzer → codebase-analyzer → technical-designer → code-verifier → document-reviewer → design-sync\n   - **Stop at every `[Stop: ...]` marker** → Wait for user approval before proceeding\n3. **Scope**: Complete when design documents receive approval\n\n**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.\n\n## Workflow Overview\n\n```\nRequirements → requirement-analyzer → [Stop: Scale determination]\n                                           ↓\n                                   codebase-analyzer → technical-designer\n                                           ↓\n                                   code-verifier → document-reviewer\n                                           ↓\n                                      design-sync → [Stop: Design approval]\n```\n\n## Scope Boundaries\n\n**Included in this skill**:\n- Requirement analysis with requirement-analyzer\n- Codebase analysis with codebase-analyzer (before technical design)\n- ADR creation (if architecture changes, new technology, or data flow changes)\n- Design Doc creation with technical-designer\n- Design Doc verification with code-verifier (before document review)\n- Document review with document-reviewer\n- Design Doc consistency verification with design-sync\n\n**Responsibility Boundary**: This skill completes with design document (ADR/Design Doc) approval. Work planning and beyond are outside scope.\n\nRequirements: $ARGUMENTS\n\nConsidering the deep impact on design, first engage in dialogue to understand the background and purpose of requirements:\n- What problems do you want to solve?\n- Expected outcomes and success criteria\n- Relationship with existing systems\n\nOnce the user has answered the three dialogue questions above, analyze with requirement-analyzer and create appropriate design documents according to scale.\n\nPresent at least two design alternatives with trade-offs for each.\n\nExecute the process below within design scope. Follow subagents-orchestration-guide Call Examples for codebase-analyzer and code-verifier invocations.\n\n## Completion Criteria\n\n- [ ] Executed requirement-analyzer and determined scale\n- [ ] Executed codebase-analyzer and passed results to technical-designer\n- [ ] Created appropriate design document (ADR or Design Doc) with technical-designer\n- [ ] Executed code-verifier on Design Doc and passed results to document-reviewer (skip for ADR-only)\n- [ ] Executed document-reviewer and addressed feedback\n- [ ] Executed design-sync for consistency verification\n- [ ] Obtained user approval for design document\n\n## Output Example\nDesign phase completed.\n- Design document: docs/design/[document-name].md or docs/adr/[document-name].md\n- Approval status: User approved","tags":["recipe","design","claude","code","workflows","shinpr","agent-skills","agentic-ai","ai-agents","automation","claude-code","claude-code-plugin"],"capabilities":["skill","source-shinpr","skill-recipe-design","topic-agent-skills","topic-agentic-ai","topic-ai-agents","topic-automation","topic-claude-code","topic-claude-code-plugin","topic-code-quality","topic-developer-tools","topic-development-workflow","topic-llm-orchestration","topic-productivity","topic-prompt-engineering"],"categories":["claude-code-workflows"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/shinpr/claude-code-workflows/recipe-design","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add shinpr/claude-code-workflows","source_repo":"https://github.com/shinpr/claude-code-workflows","install_from":"skills.sh"}},"qualityScore":"0.613","qualityRationale":"deterministic score 0.61 from registry signals: · indexed on github topic:agent-skills · 327 github stars · SKILL.md body (3,223 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T18:53:52.070Z","embedding":null,"createdAt":"2026-04-18T22:03:07.161Z","updatedAt":"2026-05-02T18:53:52.070Z","lastSeenAt":"2026-05-02T18:53:52.070Z","tsv":"'1':34 '2':57 '3':97 'accord':301 'address':395 'adr':185,363,388 'adr-on':387 'adr/design':235 'agent':41,49 'altern':309 'analysi':7,171,177 'analyz':70,73,142,148,175,181,291,295,333,344,351 'answer':285 'appropri':298,360 'approv':94,104,163,237,406,428,431 'architectur':188 'argument':246 'background':260 'beyond':241 'boundari':165,228 'call':328 'chang':189,195 'code':78,153,208,336,373 'code-verifi':77,152,207,335,372 'codebas':72,147,176,180,332,350 'codebase-analyz':71,146,179,331,349 'complet':99,231,339,414 'consid':247 'consist':221,402 'context':12 'core':20 'creat':297,359 'creation':11,186,198 'criteria':276,340 'critic':105 'data':51,193 'dedic':13 'deep':249 'defin':117 'definit':19 'deleg':35 'design':3,9,16,64,76,84,101,111,151,159,162,184,196,202,203,219,225,233,252,299,308,321,358,361,365,370,376,399,408,412,415 'design-sync':83,110,158,224,398 'determin':145,346 'dialogu':256,288 'doc':197,204,220,236,366,377 'docs/adr':423 'docs/design':417 'document':10,81,102,108,156,211,213,217,234,300,362,383,392,409,416,419,425 'document-nam':418,424 'document-review':80,107,155,216,382,391 'engag':254 'everi':88 'exact':66 'exampl':329,411 'execut':4,32,67,106,316,341,348,371,390,397 'exist':279 'expect':272 'feedback':396 'first':253 'flow':65,124,194 'follow':58,323 'gate':130 'guid':30,62,122,327 'ident':21 'impact':250 'includ':166 'inconsist':136 'invoc':338 'invok':46 'least':306 'marker':90 'md':421,427 'name':420,426 'new':190 'obtain':404 'off':313 'orchestr':18,25,29,61,121,326 'outcom':273 'output':410 'outsid':243 'overview':138 'pass':50,353,379 'phase':17,413 'plan':239 'point':116 'present':304 'problem':266 'proceed':96 'process':318 'protocol':33 'purpos':262 'qualiti':129 'question':289 'receiv':103 'recip':2 'recipe-design':1 'relationship':277 'report':55 'requir':6,69,139,141,170,174,245,264,294,343 'requirement-analyz':68,140,173,293,342 'respons':227 'result':56,354,380 'review':82,109,157,212,214,218,384,393 'risk':134 'role':43 'scale':144,303,347 'scope':98,164,244,322 'see':26 'serv':126 'skill':31,63,123,169,230 'skill-recipe-design' 'skip':131,385 'solv':271 'source-shinpr' 'status':429 'step':133 'stop':86,89,115,143,161 'sub':40,48 'sub-ag':39,47 'subag':28,60,120,325 'subagents-orchestration-guid':27,59,119,324 'success':275 'sync':85,112,160,226,400 'system':280 'technic':75,150,183,201,357,369 'technical-design':74,149,200,356,368 'technolog':191 'three':287 'topic-agent-skills' 'topic-agentic-ai' 'topic-ai-agents' 'topic-automation' 'topic-claude-code' 'topic-claude-code-plugin' 'topic-code-quality' 'topic-developer-tools' 'topic-development-workflow' 'topic-llm-orchestration' 'topic-productivity' 'topic-prompt-engineering' 'trade':312 'trade-off':311 'two':307 'understand':258 'undetect':135 'user':93,283,405,430 'verif':205,222,403 'verifi':79,154,209,337,374 'wait':91 'want':269 'within':320 'work':37,238 'workflow':137","prices":[{"id":"98fa1506-0dc2-43c8-beb2-7adbb4787a57","listingId":"9b7ea328-274b-4d09-915c-fe3d1d6bda36","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"shinpr","category":"claude-code-workflows","install_from":"skills.sh"},"createdAt":"2026-04-18T22:03:07.161Z"}],"sources":[{"listingId":"9b7ea328-274b-4d09-915c-fe3d1d6bda36","source":"github","sourceId":"shinpr/claude-code-workflows/recipe-design","sourceUrl":"https://github.com/shinpr/claude-code-workflows/tree/main/skills/recipe-design","isPrimary":false,"firstSeenAt":"2026-04-18T22:03:07.161Z","lastSeenAt":"2026-05-02T18:53:52.070Z"}],"details":{"listingId":"9b7ea328-274b-4d09-915c-fe3d1d6bda36","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"shinpr","slug":"recipe-design","github":{"repo":"shinpr/claude-code-workflows","stars":327,"topics":["agent-skills","agentic-ai","ai-agents","automation","claude-code","claude-code-plugin","code-quality","developer-tools","development-workflow","llm-orchestration","productivity","prompt-engineering","skills"],"license":"mit","html_url":"https://github.com/shinpr/claude-code-workflows","pushed_at":"2026-05-02T15:39:17Z","description":"Production-ready development workflows for Claude Code, powered by specialized AI agents.","skill_md_sha":"c3e64646e163c0cb1aaa924c33e8e50bb4380a2c","skill_md_path":"skills/recipe-design/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/shinpr/claude-code-workflows/tree/main/skills/recipe-design"},"layout":"multi","source":"github","category":"claude-code-workflows","frontmatter":{"name":"recipe-design","description":"Execute from requirement analysis to design document creation"},"skills_sh_url":"https://skills.sh/shinpr/claude-code-workflows/recipe-design"},"updatedAt":"2026-05-02T18:53:52.070Z"}}