design-doc

Generate structured design documents with alternatives and trade-off analysis.

1|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/guicaulada/dotfiles --skill design-doc-guicaulada
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-doc
Source: https://github.com/guicaulada/dotfiles/tree/main/home/dot_claude/exact_skills/design-doc
Command: npx skills add https://github.com/guicaulada/dotfiles --skill design-doc-guicaulada

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill transforms rough ideas, vague proposals, and early-stage concepts into comprehensive, shareable design documents by guiding users through iterative clarification, focused research, multiple proposal generation, trade-off analysis, and consensus capture.

Core Features & Use Cases

  • Iterative requirements clarification: Asks one question at a time, logs the idea-honing Q&A, and waits for complete user responses before proceeding.
  • Research and evidence gathering: Conducts targeted research, documents findings by topic, and summarizes implications that inform design choices.
  • Structured, review-ready output: Produces a stand-alone Google Docs–compatible design document that always includes Proposal 0 (Do nothing) plus at least two alternative proposals, benefits, trade-offs, and a consensus section.

Quick Start

Create a design document for [topic] using Prompt-Driven Development and save artifacts to .design-docs/[slug].

Frequently Asked Questions about design-doc

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

FAQPage Schema
How do I turn a rough idea into a structured design document?▼

To turn a rough idea into a structured design document, the Skill uses iterative clarification to ask targeted questions, logs the Q&A, and conducts research to generate review-ready proposals with trade-off analysis.

What is the best way to write an RFC with multiple architecture proposals?▼

Writing an RFC with multiple architecture proposals is best handled by generating a baseline "Do nothing" option alongside at least two alternative solutions, automatically analyzing benefits, trade-offs, and consensus for each.

Can I use prompt-driven development to gather requirements for technical proposals?▼

Yes, you can use prompt-driven development to gather requirements for technical proposals by asking one question at a time, waiting for complete user responses, and logging the idea-honing Q&A before proceeding.

Does this design doc generation process save artifacts for Google Docs compatibility?▼

Yes, the design doc generation process saves artifacts to a project directory like .design-docs/[slug] and formats the final output specifically for Google Docs compatibility.

How does iterative clarification work when creating an architecture decision record?▼

Iterative clarification for an architecture decision record works by asking a single question at a time, waiting for complete user responses, and logging the Q&A to hone the initial rough idea before conducting targeted research.

What should a comprehensive design document include for trade-off analysis?▼

A comprehensive design document for trade-off analysis should include a Proposal 0 "Do nothing" baseline, at least two alternative proposals, documented benefits, trade-offs, research findings, and a consensus tracking section.