Sign in
Documentation

Get started with Symbolic

Symbolic helps you direct coding agents with clear requirements and design instructions, then review the evidence behind their work.

New to Symbolic? Follow the project setup guide.

Set up the project, then choose the next tool

  1. Sign in and open Projects. Connect the GitHub repository you want to work on.
  2. Define one behavior and the acceptance criteria that would show it works.
  3. Pin the brief and design instructions, then gather relevant test evidence as the work progresses.
  4. Review the phase criteria and resolve missing evidence before advancing.
Read the getting started guide

Choose a tool

Flow

Organize a GitHub project into phases with explicit acceptance criteria. Review the evidence behind each gate and see what needs attention before the next phase.

Requirements

Turn product decisions into acceptance criteria, then compare the supplied implementation references with those decisions.

Instructions

Resolve repository rules, scope, and precedence into a focused instruction pack with its sources attached.

Rules

Compare proposed actions with an explicit authority contract covering paths, commands, hosts, and budget.

Models

Bring candidate run evidence and compare accepted outcomes, cost, and task constraints using the same evaluation criteria.

Access

Compare expected access with observations across roles, tenants, and actions to identify permission mismatches.

Blockers

Map dependencies, owners, and work status to see what can proceed and what must be resolved first.

Handoffs

Package the objective, repository state, decisions, evidence, and blockers so another agent can see where to continue.

Coverage

Define roles, devices, data states, and constraints, then compare supplied observations with the resulting state map.

Migrations

Evaluate migration scenarios, constraints, observations, and recovery evidence before deciding whether a change is ready.

Checks

Compare software claims with observed checks and review what is verified, blocked, failed, or still untested.

API and agents

Use the versioned API to submit structured inputs. Existing service IDs and MCP tool identifiers remain stable.

POST /api/v1/services/{service}/runs
Authorization: Bearer $SYMBOLIC_API_KEY
X-Symbolic-Organization: org_123
Connect an agent