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.