design-doc-generate

Generates checkpoint-ready design documents with decisions, domain model, risks, and API contracts.

201|19|Updated Dec 24, 2025
One-click install
npx skills add https://github.com/fabriqaai/specs.md --skill design-doc-generate-fabriqaai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-doc-generate
Source: https://github.com/fabriqaai/specs.md/tree/main/src/flows/fire/agents/planner/skills/design-doc-generate
Command: npx skills add https://github.com/fabriqaai/specs.md --skill design-doc-generate-fabriqaai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of formal design documents for high-complexity work items in the FIRE planning flow, ensuring decisions, risks, and implementation steps are captured before implementation.

Core Features & Use Cases

  • Template-driven design docs: Generates structured design docs including decisions, domain model, risks, and implementation checklists.
  • Checkpoint-ready: Produces a design document ready for checkpoint 1 review and approval.
  • Use Case: When a high-complexity work item requires a formal design before coding, this Skill produces a reusable doc to guide engineers and stakeholders.

Quick Start

Invoke the design-doc-generate skill during plan-review to produce a ready-to-review design document for a selected work item.

Frequently Asked Questions about design-doc-generate

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

FAQPage Schema
How do I generate a formal design doc for high-complexity engineering work items?

To generate a formal design doc for high-complexity engineering work items, invoke this Skill during the plan-review phase to automatically produce a structured document capturing decisions, domain models, and implementation checklists.

What should a checkpoint-ready architecture design document include?

A checkpoint-ready architecture design document should include structured sections for decision rationale, domain models, identified risks, API contracts, and an implementation checklist to guide stakeholders through validation.

When do I need to create a formal design document before coding?

You need to create a formal design document before coding when a high-complexity work item requires capturing decisions, risks, and implementation steps upfront for checkpoint review and approval in the planning flow.

How do I structure API contracts and domain models for a requirements checkpoint review?

To structure API contracts and domain models for a requirements checkpoint review, apply a template-driven approach that enforces formal sections for decision rationale, risks, and implementation checklists.

Can I automate design document generation for software architecture planning?

Yes, you can automate design document generation for software architecture planning by invoking this Skill during plan validation to output a reusable, checkpoint-ready artifact for selected work items.

Does this design doc template capture risk assessment and decision rationale?

Yes, this design doc template captures risk assessment and decision rationale, enforcing a structured format that includes domain models, API contracts, and implementation checklists for formal validation.