dd-writing-design-specs

Orchestrates requirement grilling, spec writing, and three-agent parallel review for design specifications.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/marcocpt/trae_skills --skill dd-writing-design-specs-marcocpt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dd-writing-design-specs
Source: https://github.com/marcocpt/trae_skills/tree/main/dd-writing-design-specs
Command: npx skills add https://github.com/marcocpt/trae_skills --skill dd-writing-design-specs-marcocpt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing design specs without confirmed requirements or systematic review leads to rework, contradictions, and documents that cannot be turned into implementation plans. This Skill enforces a strict, auditable workflow so every design spec is grounded in confirmed requirements and passes multi-dimensional review before use. ## Core Features & Use Cases - Mandatory pre-work: Reads project docs.md rules, the app feature list, and recent existing specs before any writing begins, ensuring naming, structure, and style consistency. - Grilling before writing: Conducts one-question-at-a-time requirement interrogation covering goals, scope, data models, compatibility, and acceptance criteria before drafting. - Three-agent parallel review: Dispatches three sub-agents simultaneously to check completeness and docs.md compliance, planability and YAGNI scope, and verifiability with UI observability. - Per-step git commits: Every step produces a committed artifact, creating an auditable history with Conventional Commits messages. - Use Case: When starting a new feature or API migration, invoke this Skill to grill requirements, generate a 12-section design spec via a sub-agent, run three parallel reviews, and confirm with the user one question at a time before moving to visual prototypes or test case tables. ## Quick Start Ask the AI to write a design spec for the new feature using the dd-writing-design-specs workflow, starting by reading the project docs rules and grilling the requirements one question at a time.

Frequently Asked Questions about dd-writing-design-specs

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

FAQPage Schema
How do I write a design spec for a new feature with AI?

Follow a gated workflow: first read project documentation rules and existing specs, then grill requirements one question at a time, then have a sub-agent draft the spec with all required sections. Finish with a three-agent parallel review and single-question user confirmation before committing.

What sections should a software design specification include?

The default template uses 12 sections: background and goals, non-goals, user flows, behavior rules and state machines, data models and interfaces, compatibility and migration, observability, acceptance criteria, test strategy, UI observability matrix, phased design, and risks. Project docs.md rules override these defaults.

Why use multiple review agents instead of one for spec review?

A single agent has limited context and misses issues across dimensions. Three parallel agents each specialize: completeness and docs.md compliance, planability and YAGNI scope, and verifiability with UI observability, yielding higher problem detection rates.

When should I not use this design spec workflow?

Skip it for bug fixes, pure documentation edits, one-off small changes, or minor tweaks to an existing approved spec. It is designed for new features, large refactors, API migrations, and design-driven changes that need full requirement confirmation.

What happens if a workflow step is skipped or done out of order?

The skill defines targeted remediation per violation type rather than full restarts. For example, specs written without grilling must be rewritten with only ideas reused, and downstream documents based on unconfirmed upstream docs must be discarded.