technical-design

Translate specifications and constraints into architecture decisions, components, and interface contracts.

3|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/gener8v/gener8v.claude-skills --skill technical-design-gener8v
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: technical-design
Source: https://github.com/gener8v/gener8v.claude-skills/tree/main/skills/technical-design
Command: npx skills add https://github.com/gener8v/gener8v.claude-skills --skill technical-design-gener8v

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Teams often jump from requirements straight to tickets without settling technology and architecture choices, causing integration failures and relitigated decisions. This Skill turns specifications, constraints, and dependency maps into an explicit technical design document with recorded architecture decisions (AD-XXX), component boundaries, data models, and interface contracts under .gener8v/technical-design/. ## Core Features & Use Cases - Architecture Decision Records: Documents each decision with context, rationale, alternatives considered, consequences, and the requirement IDs it affects. - Component and Interface Design: Defines component responsibilities, dependencies, data model entities, and input/output/error contracts so developers can build sides of a boundary independently. - NFR-Traced Risks and Infrastructure: Ties every infrastructure item and technical risk to the non-functional requirement IDs it serves or threatens, feeding directly into ticket breakdown. - Use Case: After specifying a search capability with latency NFRs, run this Skill to decide between pgvector and a dedicated vector database, record the decision as AD-002 with alternatives, and hand Ticket Breakdown a technically grounded foundation. ## Quick Start Run the technical-design skill on the search-and-retrieval capability area to produce a draft architecture design from its specification and constraints.

Frequently Asked Questions about technical-design

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

FAQPage Schema
How do I create a technical design document from software requirements?▼

Provide completed specifications with numbered requirements and NFRs, plus constraints and dependency maps if available. The Skill evaluates decision points, documents each architecture decision with rationale and alternatives, and writes the design to .gener8v/technical-design/ following a fixed template.

What is an architecture decision record and when should I write one?▼

An architecture decision record (AD-XXX) captures the question, the decision, rationale, alternatives considered, and consequences. Write one whenever a technology, pattern, or boundary choice materially affects ticket scope or sequencing; skip it when the approach is obvious and uncontested.

Can I run technical design without constraints or dependency analysis?▼

Yes, but at least one specification with numbered requirements and NFRs is mandatory. Missing constraints or dependencies are noted as "Not yet performed" in Source Context, and decisions depending on them are flagged for revisiting.

When should I skip writing a technical design document?▼

Skip it when the implementation approach is obvious and uncontested, when the team has an established architecture the new work fits cleanly within, or when the scope is small enough that decisions can be made inside individual tickets.

What happens when an architecture decision is reversed after tickets cite it?▼

The old decision stays in the document marked "Status: Superseded by AD-XXX" and the replacement is added above the current maximum AD ID, since IDs are append-only. The design returns to Draft until the Architect approves it again.