Skip to main content
Synapse sits between your engineering team and the AI tools it uses. Agents ask it about your rules and decisions before they act. Synapse also collects what those tools, your repositories and (with consent) your people’s human state say about how AI work is going, and shows it back as team views. This page explains the ideas that come up on almost every screen. Once you know them, the rest of the docs read more easily.

​
Seats and roles

You need a Synapse seat in your organization to use Synapse. The organization owner or an organization admin gives out seats. Each seat comes with one Synapse role, and the role decides what you can see and do. Your role on the Synheart platform doesn’t. The organization owner can do everything, but only with a seat, like everyone else. A few things never need a seat: the owner and organization admins can change privacy settings, any member can erase their own data, and only the owner can erase the whole organization’s data.
If a page you expect is missing from your sidebar, your role probably doesn’t include it. Ask a Synapse Admin. See Find your way around for what each role sees.

​
Departments and scope

A department is a group of members, such as Platform or Mobile. Admins create departments and add people to them under Departments. Every team view has a scope, shown as a badge at the top of the page. Members see their own department. Leads and Admins see the whole organization and can pick any department. In an organization with no departments yet, the whole organization is everyone’s team. That changes as soon as the first department exists.

​
Human state and Life

Human state is a coarse estimate of how someone is doing at work, such as focus, cognitive load and fatigue. It comes from Life by Synheart, which each person connects for themselves under You → My connections.
  • It’s opt-in. Nobody’s human state is used until they connect Life and consent to contribute. Consent is given and withdrawn in the Life app. Leads and admins can’t do it for anyone else.
  • You see your own. Your own numbers show in My Effectiveness. Your coding agent can also use your current state to change how it answers you, for example shorter, more focused replies when you’re tired. Agents only get that coarse guidance, never health data.
  • Teams see totals. Team human-state views are medians over members who consented, and only above the cohort floor. Nobody can drill down to one person.
  • It’s never used to judge people. Human state isn’t used in alerts, goals, rankings or recommendations.
An admin can turn team human-state views off for the whole organization. See Team human-state views.

​
The AI Effectiveness Index

The AI Effectiveness Index (AEI) answers “how is AI working for us?” with three separate measures, not one score. Synapse never adds them up, weights them or ranks teams by them, because a single number would hide what’s actually going on. The current version is aei-v9. Figures from aei-v8 or earlier were calculated differently, so don’t compare them. For what’s on each tab, see AI Effectiveness.

​
The cohort floor

The cohort floor is the smallest number of people a team human-state figure is shown for. Below it, the figure is withheld with a note, rather than estimated. It’s 4 by default, and an admin can raise it to as many as 50. The floor is why a small team may see “Private” or a dash where a number would be. A team below the floor can still see its own view if every member opts in to sharing. Work and delivery figures, such as merged PRs or AI adoption, describe your repositories and tools rather than people’s state, so the floor doesn’t hold them back. See The cohort floor for every rule.

​
Evidence labels

Some numbers come with a label that says how strongly you can lean on them.
  • Describe. A plain count or share of what happened, like Reach. It says nothing about why.
  • Associate. A change that happened alongside AI use, like Delivery. It’s a pattern worth looking into, not proof that AI caused it.
  • Beta. The measure is new and may change. Read it as a hint.
Synapse also never shows a missing value as zero. A dash means there’s no data. 0 means Synapse looked and found none.

​
Where the data comes from

For exactly what’s stored and for how long, see What Synapse collects.