§ Start here

Getting started.

Sign in, create a workspace, and ship your first spec.

A new account can ship its first spec in under an hour. This page is the shortest path.

1. Sign in #

SpecGraph uses passwordless sign-in. Enter an email address on the sign-in page and a magic link is sent through Resend. Click the link — the same one works on any device — and you land on your dashboard.

If you don't see the email after a minute, check spam. The sender is noreply@specgraph.dev.

2. Pick or create a workspace #

The first time you sign in, a personal workspace is created automatically. The workspace ID lives in the URL: every authenticated route is /o/<workspace-id>/.... You can switch between workspaces from the dropdown next to the SpecGraph logo in the top nav.

To collaborate with other people, see Team & invites.

3. Start a project #

From the dashboard, click New project. The wizard asks for:

  • A short name and one-paragraph description
  • An optional template (blank, web app, internal tool, mobile)
  • Whether to seed it from an existing knowledge base entry

Templates only set defaults — every field stays editable afterward.

4. Move through the phases #

A project moves through nine phases in order. Each phase has an owning department, a few structured fields, and either an interview-style chat or a direct edit form.

text
P-01 Vision & Scope        → business
P-02 Features & Stories    → product
P-03 Product Brief         → product
P-04 Design & UX           → design
P-05 Technical Architecture → engineering
P-06 Quality & Testing     → qa
P-07 Security & DevOps     → security
P-08 Handoff               → system
P-09 Progress              → system

You don't have to finish a phase to peek at the next one — but you do have to lock an upstream phase before downstream sections trust its content. Locking is reversible; unlocking it triggers a regeneration of any AI-drafted downstream sections.

For the full phase model, see Phases.

5. Export the spec #

When P-08 (Handoff) completes, the project produces a single spec.md file plus a small bundle of supporting artifacts (entity diagrams, API contracts, the brief). The export modal is reachable from the project header.

Drop the file into Claude Code, Cursor, or any agent that reads Markdown. The format is designed so the agent can read it once and start.