Quick Start¶

This guide walks you through creating your first MultiSpec project.

Initialize a Project¶

Create a new project with the standard directory structure:

multispec init user-onboarding

This creates:

docs/specs/user-onboarding/
├── source/
│   ├── mrd.md      # Market Requirements (placeholder)
│   ├── prd.md      # Product Requirements (placeholder)
│   └── uxd.md      # User Experience Design (placeholder)
├── gtm/            # For LLM-generated GTM docs
├── technical/      # For LLM-generated technical docs
├── eval/           # For evaluation results
└── multispec.yaml  # Project configuration

Author Source Specs¶

Edit the source specifications in the source/ directory:

`source/mrd.md` - Market Requirements¶

# Market Requirements Document

## Problem Statement

What problem does this solve?

## Target Audience

Who benefits from this?

## Business Goals

What business metrics will improve?

`source/prd.md` - Product Requirements¶

# Product Requirements Document

## User Stories

- As a user, I want to...

## Functional Requirements

1. The system shall...

## Acceptance Criteria

- [ ] Criterion 1
- [ ] Criterion 2

`source/uxd.md` - User Experience Design¶

# User Experience Design

## User Journey

1. User opens app
2. User sees...

## Interaction Flows

Describe key interactions...

Validate Your Project¶

Check that your project follows MultiSpec conventions:

multispec lint user-onboarding

Check Project Status¶

View the current status and readiness:

# Terminal output
multispec status -p user-onboarding

# JSON format
multispec status -p user-onboarding --format json

# Generate HTML report
multispec status -p user-onboarding --format html > status.html

Readiness Gates¶

The status command shows readiness gates:

Gate	Requirement
Required specs present	mrd.md, prd.md, uxd.md, trd.md exist
Evaluations passing	No critical/high findings in evals
Approvals obtained	Required specs have approvals in multispec.yaml
Execution spec generated	spec.md exists

Next Steps¶

Once your source specs are complete:

Synthesize GTM docs

multispec synthesize press
multispec synthesize faq
multispec synthesize narrative

Synthesize technical docs

multispec synthesize trd
multispec synthesize ird

Run evaluations
```
multispec eval --all
```

Get approvals

multispec approve prd
multispec approve trd

Reconcile to execution spec
```
multispec reconcile
```
Export to target system
```
multispec export speckit
```

Extract and visualize requirement graph

multispec graph extract
multispec graph export --format html
multispec graph query --type requirement