skills.rest
bahayonghang
bahayonghangCOMMUNITY
Explore all skills by this author →
GitHub

tech-design-doc

Generate technical design documents using standardized ADR/RFC templates.

16|1|Updated Jan 2, 2026
Search Tags:#architecture#mermaid#ADR#RFC#design-doc#documentation-template#technical-spec
One-click install
npx skills add https://github.com/bahayonghang/my-claude-code-settings --skill tech-design-doc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tech-design-doc
Source: https://github.com/bahayonghang/my-claude-code-settings/tree/main/skills/tech-design-doc
Command: npx skills add https://github.com/bahayonghang/my-claude-code-settings --skill tech-design-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a systematic approach to creating thorough technical design documents (TDD), ADRs, and RFCs, including templates, guidance, and diagrams to improve architecture decision quality and project planning.

Core Features & Use Cases

  • Standardized templates for feature design, architecture decisions, ADRs/RFCs, and implementation planning.
  • Mermaid diagram support to visualize architecture, data flows, and component relationships within the document.
  • A guided workflow that scales templates to complexity levels and outputs ready-to-review documents.
  • Use case: design a new service with sections for background, goals, options, solution overview, data model, API design, and risk assessment.

Quick Start

Describe the feature you want documented and specify the desired level of detail; the skill will generate a complete technical design document based on the template.

Frequently Asked Questions about tech-design-doc

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

FAQPage Schema
How do I generate a technical design document for a new service architecture?▼

You can generate a technical design document by describing your feature and specifying the desired detail level. The skill outputs a complete TDD with sections for background, goals, architecture options, data models, API design, and risk assessment.

What is the best way to write an architecture decision record for a system refactoring?▼

The best way to write an architecture decision record is using standardized ADR templates. This skill guides you through documenting background, evaluated options, and the chosen solution to improve architecture decision quality for refactoring projects.

Can I include Mermaid diagrams in my technical specification to visualize data flows?▼

Yes, you can include Mermaid diagrams in your technical specification. The skill supports Mermaid diagram generation to visualize architecture, component relationships, and data flows directly within the generated design document.

Does this technical design doc template scale to different project complexity levels?▼

Yes, the technical design doc template scales to different complexity levels. A guided workflow adjusts the standardized sections based on your specified detail level, ensuring the output matches your project's specific scope.

What sections are included in an RFC generated for feature implementation planning?▼

An RFC generated for feature implementation planning includes sections for background, goals, options, solution overview, data models, API design, risk assessment, and an actionable implementation plan.

When should I use an automated design doc generator instead of writing technical specs manually?▼

You should use an automated design doc generator when you need a systematic approach to ensure thorough technical specs. It enforces standardized templates for ADRs and TDDs, reducing missing sections and improving project planning consistency.

Related Skills

Explore More Software Engineering Skills→
pradyumnasagarpradyumnasagar
6

agent-handoff

Automate inter-skill data transfer and provenance capture via JSON Material Passports.

Community
Advanced
lemieuxlemieux
8

finalizing-technical-docs

Resolve review markers, convert ASCII diagrams to Mermaid, and remove draft status sections from RFC drafts.

Community
Intermediate
RamonsDkaRamonsDka
1

mermaid-diagrams

Create Mermaid diagrams for software architecture and workflows.

Community
Advanced
juan-estrada-ittijuan-estrada-itti

rfc-builder

Construct structured Markdown RFC documents from PRDs and problem descriptions.

Community
Advanced