design

Capture PRODUCT.md and DESIGN.md to generate design-phase artifacts and metadata.

8|1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/Heavy-Chain-Engineering/etc --skill design-heavy-chain-engineering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design
Source: https://github.com/Heavy-Chain-Engineering/etc/tree/main/skills/design
Command: npx skills add https://github.com/Heavy-Chain-Engineering/etc --skill design-heavy-chain-engineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Socratic design phase wraps impeccable capture to convert fuzzy product intents into a design-ready feature directory by capturing PRODUCT.md and DESIGN.md at repo root and orchestrating post-processing into etc-native artifacts.

Core Features & Use Cases

  • Interactive, question-driven capture that translates vague requirements into concrete design artifacts.
  • Post-processes outputs to produce gray-areas-design.md, design-tokens.json, component-specs.md, and updates to state.yaml.design_phase.
  • Ensures alignment with /spec prerequisites and prepares design metadata for downstream phases.

Quick Start

Invoke /design with your project intent to capture PRODUCT.md and DESIGN.md and post-process artifacts.

Frequently Asked Questions about design

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

FAQPage Schema
How do I translate fuzzy product intents into a design-ready feature directory?

To translate fuzzy product intents into a design-ready feature directory, this Skill uses interactive Socratic questioning to capture requirements and generate structured artifacts like component-specs.md and design-tokens.json.

What is a Socratic design workflow and when do I need it?

A Socratic design workflow uses interactive, question-driven capture to convert vague requirements into concrete design artifacts. You need it when translating fuzzy product intents into a structured, design-ready feature directory.

How do I generate design tokens and component specifications from markdown?

You generate design-tokens.json and component-specs.md by capturing PRODUCT.md and DESIGN.md at the repo root, then applying post-processing to orchestrate these outputs into etc-native artifacts.

Does the design workflow require any specific prerequisites or dependencies?

The design workflow requires no external dependencies but ensures alignment with /spec prerequisites. You invoke it with your project intent to capture markdown files and prepare design metadata for downstream phases.

How do I document gray areas and edge cases during product design?

To document gray areas during product design, the workflow post-processes captured markdown inputs to generate gray-areas-design.md, ensuring edge cases and ambiguities are recorded as etc-native artifacts for downstream phases.

Can I update state.yaml design phases automatically after capturing requirements?

Yes, you can update state.yaml.design_phase automatically by applying post-processing to the captured PRODUCT.md and DESIGN.md files, recording feature metadata for downstream phases.