Using the App

This guide walks through the core screens of the Specor app and what you can do in each.

The workspace switcher

When you sign in, you land on the workspace switcher. Each card represents a workspace — a self-contained product model. Click a workspace to open it, or create a new one with New Workspace.

If you belong to multiple organizations, a selector at the top lets you switch between them.

The main layout

Inside a workspace, the screen is divided into three areas:

• Left sidebar — navigation between Graph, Branches, AI Suggestions, and Search
• Main area — the active view
• Right sidebar — the AI Chat panel (toggle with the wand icon)

A branch selector at the top of the left sidebar shows the active branch. All graph views are scoped to whichever branch is selected.

The graph view

The graph view is where you build and explore your product model.

Navigating the graph

• The left panel lists your Domains. Click one to expand its Capabilities.
• Click a Capability to expand its Features.
• Click a Feature to open the detail panel on the right, which shows its linked Rules, Metrics, Acceptance Criteria, Flows, and Needs.
• Use Search (left sidebar) to find any node by title across the whole graph.

Creating nodes

• Click + Domain to create a new top-level domain.
• Inside a domain, use + Capability to add a capability.
• Inside a capability, use + Feature.
• From a feature’s detail panel, use the add buttons to attach Rules, Metrics, Acceptance Criteria, and Flows.

Changes appear in the graph straight away, and AI agents start analysing in the background within seconds.

Editing nodes

Click the edit icon (pencil) on any node to open the edit form. Save to apply the change. Specor keeps the full history of every change — nothing is permanently lost.

Deleting nodes

Click the delete icon on any node. You will be asked whether to also remove all its child nodes or leave them in place.

Branches

The Branches view (left sidebar) lists all branches in the workspace.

Creating a branch

Click New Branch, give it a name and optional description. The new branch starts as a copy of the current state of main.

Switching branches

Select a branch from the branch selector at the top of the sidebar. All graph, suggestions, and search views immediately reflect the selected branch.

Archiving a branch

From the branch list, click the three-dot menu on any branch and choose Archive. Archived branches can be restored.

AI Suggestions

The AI Suggestions view (Brain icon in the left sidebar) is the inbox for proactive agent suggestions.

Inbox

The Inbox shows all pending suggestions for the active branch. Suggestions are coloured by severity — red for errors, amber for warnings, blue for informational.

Each card shows:

• The agent type that raised it (Coverage, Naming, Conflict, etc.)
• A confidence score — how certain the agent is
• A short title and expandable body explaining the issue

Acting on suggestions

For each pending suggestion you have three options:

Action	What it does
AI Fix	Opens the AI Chat panel pre-filled with the suggestion context, ready to apply a fix
Snooze	Hides the suggestion until tomorrow, 1 week, 2 weeks, or 1 month
Reject	Dismisses the suggestion; optionally add a note and tick Don’t suggest again to suppress the category for that node permanently

You can select multiple suggestions with the checkboxes and bulk-snooze or bulk-reject them.

Suppressions

The Suppressions tab lists categories that have been permanently silenced for specific nodes. Delete a suppression to re-enable that check.

Runs

The Runs tab shows a log of every agent run — which agent ran, how many suggestions were created, and when. Useful for understanding why a suggestion was or wasn’t raised after a recent change.

AI Chat

Click the wand icon (top-right) to open the AI Chat panel. The assistant has read access to your full product graph and can:

• Answer questions about your model (“What features are linked to the Checkout domain?”)
• Draft new nodes and apply them (“Add an Acceptance Criteria to One-click Purchase”)
• Fix suggestions you send to it via AI Fix

The chat is branch-aware — it reads from and writes to the currently active branch.

Organization settings

Click your organization name (top-right) → Settings to reach the settings area.

• Members — invite users, change roles (viewer / editor / admin), and remove members
• Billing — view your current plan, upgrade, and open the billing portal to manage payment details