recipe-design
Execute from codebase-scoped analysis through optional ADR decisions to complete Design Doc approval
npx skills add shinpr/claude-code-workflows --skill recipe-design --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
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. ## Outcome and Ownership Coordinate the design phase from repository evidence to an approved Design Doc. The orchestrator owns requirement convergence, 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-syn
- Outcome and Ownership
- Flow
- Step 1: Select the Governing Requirement Source
- Step 2: Collect Decision Material
- Step 3: Confirm Scope and ADR Decisions
- Step 4: Create and Approve an ADR Batch When Needed
- Step 5: Create the Design Doc
- Step 6: Verify and Resolve Repository Claims
- Step 7: Review and Approve
- Completion Criteria
What does the recipe-design skill do?
Execute from codebase-scoped analysis through optional ADR decisions to complete Design Doc approval
How do I install it?
Run `npx skills add shinpr/claude-code-workflows --skill recipe-design --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From shinpr/claude-code-workflows, a repository with 664 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.