spec-design

Name: spec-design
Availability: InStock
Author: LeeHusung

Translate requirements.md into architecture diagrams, Prisma schemas, and API contracts.

Updated Apr 21, 2026

Search Tags:#design #architecture #openapi #requirements #prisma #api-contract #data-model

Ready to run

npx skills add https://github.com/LeeHusung/harness --skill spec-design-leehusung

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: spec-design
Source: https://github.com/LeeHusung/harness/tree/main/.claude/skills/spec-design
Command: npx skills add https://github.com/LeeHusung/harness --skill spec-design-leehusung

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translate requirements.md into a complete design for architecture, data models, and API contracts.

Core Features & Use Cases

Generate architecture diagrams (Mermaid), data models (Prisma), and API contracts (OpenAPI) from the requirements.
Ensure strict alignment with steering/tech.md and capture blockers or trade-offs.
Use Case: Given requirements.md, produce a design.md detailing context, architecture, data model, API contracts, error taxonomy, observability, security, and alternatives.

Quick Start

Place requirements.md at .claude/specs/<id>/ requirements.md and run the spec-design workflow to generate design.md.

Frequently Asked Questions about spec-design

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

FAQPage Schema

How do I generate API contracts and data models from requirements?▼

To generate architecture diagrams from requirements, the system translates requirements.md into Mermaid diagrams, ensuring strict alignment with steering and tech constraints while capturing any technical trade-offs or blockers.

Do I need a requirements.md file to produce a Prisma schema and OpenAPI definitions?▼

Yes, you need a requirements.md file placed in the .claude/specs/ directory, as the workflow relies on existing requirements and steering constraints to produce the Prisma schema and OpenAPI definitions.

What is the best way to translate software requirements into architecture?▼

The generated design.md details context, architecture diagrams, data models, API contracts, error taxonomy, observability, security, and alternatives, providing a complete architectural blueprint for your project.

Does spec-design work with Prisma and OpenAPI for API contract generation?▼

Yes, spec-design works with Prisma and OpenAPI by taking your project requirements and translating them directly into Prisma data models and OpenAPI API contracts within the output design document.

How to ensure generated data models align with steering constraints?▼

To ensure generated data models align with steering constraints, the workflow checks your requirements against steering/tech.md, capturing blockers and trade-offs to maintain strict architectural alignment throughout the design process.