Skip to content
Specor

Quick Start

This guide walks you through signing up, creating a workspace, building your first product nodes, and committing your work.

How Specor is structured

Before you dive in, here’s the mental model:

Your product is organised as a hierarchy — Domains (big areas like “Checkout” or “Onboarding”) contain Capabilities (bounded sub-areas like “Payment Processing”), which contain Features (specific things your product does). Features are where the detail lives: attach Rules, Metrics, Flows, and Acceptance Criteria to them.

As you work, Specor tracks every change. When you want to save a named checkpoint — like pressing “save a version” in a document — you create a commit. That seals your changes into a named snapshot you can review, share, or undo later.

That’s the core of it. The steps below build your first domain from scratch.

1. Create an account

Go to app.specor.ai and sign up with your email or Google account. No credit card required — your account starts on the Starter plan.

2. Create an organization

After signing in you’ll be prompted to create an organization. This is the container for your team’s workspaces, members, and billing. Give it your company or product name.

3. Create a workspace

Click New Workspace and give it a name that reflects the product or domain you’re modelling (e.g. “Mobile App”, “Platform”).

Each workspace has its own:

  • Graph of nodes
  • Branch history
  • Member access controls
  • AI suggestion inbox

4. Invite your team

Go to Settings → Members and invite collaborators. There are two roles:

RoleWhat they can do
EditorCreate, edit, and delete nodes; manage branches; submit commits. Counts toward your plan’s seat limit.
ViewerRead the full graph, browse history, and view AI suggestions. Always free — no seat consumed.

5. Understand the main layout

Once inside a workspace you’ll see three main areas:

  • Left sidebar — navigation between Graph, Branches, AI Suggestions, and Search
  • Main area — the active view (graph, diff, merge requests, etc.)
  • Right sidebar — the AI Chat panel (toggle with the floating button at bottom-right)

The branch selector at the top shows which branch you’re working on. Every view is scoped to that branch.

6. Build your first domain

The graph is organized as a hierarchy. You’ll always start with a Domain — a top-level grouping like “Checkout”, “User Management”, or “Notifications”.

  1. In the Overview view, click + Create Domain
  2. Enter a name and an optional description
  3. Click Save

Your domain appears in the left panel. Click it to expand.

7. Add a Capability and Feature

Inside a domain:

  1. Click + Capability — add a bounded area like “Payment Processing” or “Email Auth”
  2. Inside the capability, click + Feature — add a specific piece of functionality like “One-click Purchase” or “Magic Link Login”

Features are where most of the detail lives. From a feature’s detail panel you can add:

  • Rules — business constraints (“Order total must not exceed credit limit”)
  • Acceptance Criteria — pass/fail tests (“User completes checkout in ≤ 3 taps”)
  • Metrics — measurable outcomes (“Checkout completion rate ≥ 80%”)
  • Flows — step-by-step user journeys
  • Needs — the user or business needs this feature addresses

8. Create a commit

Changes you make are tracked as a working state — live, uncommitted work. When you’re ready to save a named checkpoint:

  1. Click the Commit button in the header
  2. Give the commit a name (e.g. “Initial checkout domain structure”)
  3. Click Create commit

The commit seals your changes into an immutable snapshot. You can always roll back to it later. See Commits for details.

9. Review AI suggestions

Within seconds of creating nodes, Specor’s AI agents analyse your product model and surface suggestions in the inbox (brain icon in the left sidebar).

A new feature with no linked metrics, a capability with no features, or a vague node title will all trigger suggestions. Each card shows:

  • What the issue is and which agent detected it
  • An AI Fix button to open the AI Chat with the context pre-filled
  • Snooze and Reject options

See AI Suggestions to learn how to work through your inbox.

Next steps

  • Node Types — learn what each type of node represents
  • Branches — work on changes in isolation
  • AI Chat — ask questions and generate nodes conversationally