Getting Started

Get up and running with Supaspec in under 5 minutes. Create a project, connect your AI tools, and start building specs.

1

Create an Account

Sign up at supaspec.dev using email magic link, Google OAuth, or GitHub OAuth. No credit card required.

2

Create a Project

From the Dashboard, click New Project. Give it a name and optional description. You'll get a unique project slug (e.g., my-app).

3

Add Sections

Create spec sections with titles like “Architecture,” “Data Model,” or “Auth.” Write content in Markdown and commit changes. Every save creates a versioned commit with full attribution.

4

Connect Your AI Tool

Supaspec connects via MCP — no local server needed. Pick your tool:

claude mcp add --transport http supaspec https://supaspec.dev/api/mcp

See MCP Setup for OAuth, troubleshooting, and advanced options.

5

Generate Your Spec

In the editor, click the sparkle icon to open the prompt library. Select the Generate tab and pick “Spec from Overview.” Copy the prompt, paste it into your AI agent, and watch your spec materialize in seconds.

See Generating Specs for multi-agent strategies and advanced workflows.

6

Install the Skill (Recommended)

Install the Supaspec Builder skill to teach your agent the spec-driven workflow:

Terminal
npx skills add super-full-stack/supaspec-builder

With this skill installed, the agent automatically reads your spec before coding, tracks section statuses, and documents changes back to Supaspec. See Skills for details.

7

Review & Build

Review each generated section. Set status to Approved when ready. Then use a Build prompt to point a coding agent at your spec. See Building from Specs for details.