design

Generate design.md from requirements.md with two-stage spec compliance review.

4|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/curdx/curdx-flow --skill design-curdx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design
Source: https://github.com/curdx/curdx-flow/tree/main/plugins/curdx-flow/skills/design
Command: npx skills add https://github.com/curdx/curdx-flow --skill design-curdx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It turns a spec’s requirements into a concrete, reviewable technical design artifact while preventing silent drift by gating progress on spec compliance and code-quality checks.

Core Features & Use Cases

  • Spec-to-design orchestration: Snapshots an active spec, loads requirements/research/context, and runs a coordinated design workflow that delegates architecture to the architect-reviewer.
  • Two-stage artifact review: Performs parallel spec-compliance review and code-quality review against the generated design.md, using explicit pass/fail verdicts stored in verification blocks.
  • Interactive walkthrough & approval: Presents a structured walkthrough summary and supports approval, review reruns, or request-for-changes loops.
  • Controlled state updates: Clears/sets approval flags, updates phase state, and (optionally) commits the design artifact to the repo.

Quick Start

Run /curdx-flow:design <spec-name> to generate ./specs/<spec-name>/design.md and get an approval-ready walkthrough.

Frequently Asked Questions about design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a technical design from a spec?

You can generate a reviewable technical design by running a workflow that transforms your spec's requirements.md into a structured design.md artifact. This process snapshots your active spec, loads context, and delegates architecture generation to a reviewer.

What is a two-stage review workflow for technical design?

A two-stage review workflow runs parallel spec-compliance and code-quality checks against your generated design.md. It uses explicit pass/fail verdicts stored in verification blocks to prevent silent drift from your original requirements.

How do I ensure my architecture review aligns with spec requirements?

To ensure architecture review aligns with spec requirements, use a workflow that applies a specCompliance hard gate. This blocks progress until the generated design passes verification checks against the original requirements.

Can I request changes during an approval workflow for a design artifact?

Yes, you can request changes during the approval workflow. The system presents a structured walkthrough summary and supports approval, review reruns, or request-for-changes loops before updating the phase state and proceeding to tasks.

Does the design generation process require state management for resumability?

Yes, the design generation process requires state management to snapshot your active spec and update phase state. This ensures the delivery workflow remains reviewable, resumable, and verifiably aligned before proceeding to tasks.

What are the limitations of automated technical design generation?

Automated technical design generation stops for explicit approval before tasks, meaning it cannot proceed without human intervention. It also relies entirely on the completeness of your requirements.md and optional research.md inputs.