design

Translate approved product specifications into feature tech-spec documents.

1|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/csackrider/AI-DLC --skill design-csackrider
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design
Source: https://github.com/csackrider/AI-DLC/tree/main/plugins/ai-dlc-skills/skills/design
Command: npx skills add https://github.com/csackrider/AI-DLC --skill design-csackrider

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design phase execution requires converting an approved Product Spec into a concrete Tech Spec that can guide implementation. This skill provides a structured process to translate intent into scope, architecture, data models, and acceptance criteria, ensuring traceability and a formal gate before build.

Core Features & Use Cases

  • Translate the approved Product Spec into a tech-spec in the feature directory (feature/<slug>/tech-spec.md).
  • Document scope, architecture, API/UI contracts, data models, acceptance criteria, and testing approach.
  • Enforce human approval before /build and link related ADRs, ADR templates, and spec-management guidance.

Quick Start

Translate the approved product spec into the tech-spec in the feature folder and prepare the human gate before the build.

Frequently Asked Questions about design

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

FAQPage Schema
How do I translate a product spec into a tech spec for feature implementation?

To translate a product spec into a tech spec, use this skill to convert approved intent into a concrete design-tech specification. It documents scope, architecture, data models, and acceptance criteria within the feature directory to guide implementation.

What is the best way to document architecture and data models before build?

The best way to document architecture and data models is generating a detailed tech-spec.md file in the feature folder. This process codifies technical scope, API/UI contracts, and testing approach to ensure traceability before the build phase.

How do I enforce human approval gates before proceeding to build?

To enforce human approval gates before build, the skill prepares a formal review step cross-referencing related plans and ADRs. This ensures the tech-spec documentation satisfies gating requirements requiring human approval prior to implementation.

Can I cross-reference ADRs and related plans within my design documentation?

Yes, you can cross-reference ADRs and related plans within your design documentation. The skill enforces linking related ADRs, ADR templates, and spec-management guidance directly inside the generated tech-spec to maintain formal traceability.

Does this design workflow support codifying acceptance criteria and testing approach?

Yes, this design workflow supports codifying acceptance criteria and testing approach. It translates an approved product specification into a detailed design-tech specification that explicitly documents these elements alongside architecture and data models.

When do I need a formal tech-spec for my feature directory?

You need a formal tech-spec for your feature directory when a feature's technical scope, architecture, and acceptance criteria must be codified and reviewed. This skill enforces a formal gate requiring human approval before proceeding to build.