authoring-technical-design

Write implementable technical design documents for one feature traced to requirements.

1|1|Updated May 24, 2026
One-click install
npx skills add https://github.com/bm629/agent-skills --skill authoring-technical-design-bm629
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: authoring-technical-design
Source: https://github.com/bm629/agent-skills/tree/main/skills/authoring-technical-design
Command: npx skills add https://github.com/bm629/agent-skills --skill authoring-technical-design-bm629

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Engineers often write technical design documents that are vague, untraceable to requirements, or duplicate API specs and schemas, forcing implementers to re-derive the design. This Skill provides a design-research method and an 11-point implementability bar so a TDD for one feature can be built from directly. ## Core Features & Use Cases - Bidirectional requirement tracing: Every design decision traces to a PRD or feature-spec requirement, and every requirement gets a design, eliminating coverage gaps and scope creep. - Reference-not-duplicate discipline: Interfaces and schemas owned by an API spec or data model are referenced with only the delta stated, preventing documentation drift. - Amend-as-delta workflow: Approved TDDs are changed as scoped, versioned, ripple-analyzed deltas with changelogs rather than rewritten. - Use Case: Given an approved PRD and feature-spec for a CSV export feature, produce a TDD with component decomposition, a synced Mermaid sequence diagram plus narration, failure modes with handling, observability signals, a real alternative with a decision criterion, and a rollback plan with measurable triggers. ## Quick Start Use authoring-technical-design to write a technical design document for the export feature based on the approved PRD and feature-spec.

Frequently Asked Questions about authoring-technical-design

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

FAQPage Schema
How do I write a technical design document for a feature?

Start from the approved PRD and feature-spec, take the section structure from a technical-design template, then fill it with component decomposition, control and data flow, interfaces, failure modes, observability, testing, and rollout. Trace every decision bidirectionally to a requirement.

What is the difference between a TDD and an architecture document?

An architecture document designs system-wide structure, service topology, and technology choices. A TDD designs one feature or component within that architecture and references the architecture doc rather than redesigning it.

Should a design doc include the full API spec or database schema?

No. A TDD references the API spec or data model that owns the contract and states only the delta the feature introduces. Inlining endpoints or schema DDL duplicates the source of truth and drifts when it changes.

How do I amend an approved technical design document?

Amend it as a scoped, versioned delta: edit only the affected decisions, re-check their requirement trace and failure modes, analyze upstream and downstream ripple effects, bump the version with a changelog entry, and mark superseded decisions rather than deleting them.

When should I not use this design doc skill?

Do not use it for system-wide architecture design, for authoring the API contract or data schema themselves, for writing the PRD or feature-spec, or for reviewing a finished TDD, which is handled by the reviewing-technical-design gate.