HDD Generate

Generate HDD design documents in wave-driven workflows with validation and human approval.

2|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/gaebalai/hdd-dev --skill hdd-generate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: HDD Generate
Source: https://github.com/gaebalai/hdd-dev/tree/main/skills/hdd-generate
Command: npx skills add https://github.com/gaebalai/hdd-dev --skill hdd-generate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables teams to generate HDD design documents in a controlled, wave-based workflow, ensuring validation and HITL review between waves to keep outputs coherent as requirements evolve.

Core Features & Use Cases

  • Wave-driven generation: produces design artifacts in ordered waves aligned to dependency graphs.
  • Validation & gating: validates frontmatter, dependencies, and requires human approval before the next wave.
  • Dependency refresh: updates the design-dependency graph after each wave generation.

Quick Start

Run hdd generate --wave 1 after setting up requirements, review Wave 1 outputs, verify frontmatter and dependencies, and obtain HITL approval before proceeding to Wave 2.

Frequently Asked Questions about HDD Generate

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

FAQPage Schema
How do I generate design docs in a wave-driven workflow with validation gates?

To generate design docs in a wave-driven workflow, this Skill automates artifact production in ordered waves aligned to dependency graphs, enforcing frontmatter validation and mandatory human approval before proceeding to the next wave.

What is a wave-based design document generation process?

A wave-based design document generation process produces iterative design artifacts sequentially, updating the dependency graph and requiring human-in-the-loop review between each wave to ensure outputs remain coherent as requirements evolve.

How do I start generating HDD design documents for a greenfield project?

To start generating HDD design documents for a greenfield project, ensure requirement documents and an hdd.yaml file exist, then run the generate command for Wave 1 and obtain human approval before advancing.

Do I need an hdd.yaml file to run design doc generation?

Yes, you need an hdd.yaml file present in your project. The Skill checks for prerequisites including the hdd.yaml configuration and existing requirement documents before allowing wave progression to begin.

How are dependencies validated during iterative design document generation?

Dependencies are validated during iterative design document generation by checking frontmatter and dependency rules after each wave, then refreshing the design-dependency graph to maintain coherence across subsequent generation waves.

Can I skip human approval gates between design doc generation waves?

No, you cannot skip human approval gates. The workflow coordinates generate, validate, scan, and human-in-the-loop steps, mandating explicit HITL approval between waves to ensure controlled progression.