technical-design

Generate a technical design document from brief.md and acceptance.feature inputs.

5|1|Updated May 9, 2026
One-click install
npx skills add https://github.com/ql-link/LinkRag --skill technical-design-ql-link
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: technical-design
Source: https://github.com/ql-link/LinkRag/tree/main/.ai/skills/technical-design
Command: npx skills add https://github.com/ql-link/LinkRag --skill technical-design-ql-link

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts validated brief.md and acceptance.feature into a concrete technical_design.md, ensuring input prerequisites are met and outputs align with real code, component docs, and public contracts.

Core Features & Use Cases

  • Validate and pull inputs from the same directory (brief.md and acceptance.feature) to generate a detailed technical design.
  • Produce a publication-ready technical_design.md that documents scope, API/mq/data design, and implementation plan, referencing existing components and contracts.
  • Support teams planning changes by turning high-level requirements into actionable design artifacts for implementation-execution.

Quick Start

Provide a brief.md and acceptance.feature in the working directory and instruct the skill to generate the technical design document.

Frequently Asked Questions about technical-design

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

FAQPage Schema
How do I generate a technical design document from a validated brief?

You generate a technical design by providing a validated brief.md and acceptance.feature in your directory, which produces a publication-ready technical_design.md documenting scope, API design, and implementation plans.

What inputs are required to create a technical design for a software project?

Creating a technical design requires validated brief.md and acceptance.feature files in the same directory, ensuring the generated design aligns with real code, component docs, and public contracts.

When do I need to use a technical design document for architecture changes?

You need a technical design document when planning software projects, design tasks, or architecture changes, converting high-level requirements into actionable design artifacts for implementation execution.

How does the technical design process handle input validation?

The technical design process validates input prerequisites by checking for brief.md and acceptance.feature before generating, ensuring outputs align with real code and updating state.yaml accordingly.

Can I use this technical design workflow without an acceptance contract?

No, the technical design workflow requires both brief.md and acceptance.feature as inputs, with the acceptance contract ensuring the generated design aligns with public contracts and real code components.

What is the best way to document API and data design for implementation?

The best way to document API and data design is generating a technical_design.md from validated briefs, referencing existing components and producing actionable artifacts for implementation execution.