Sync
The release-triggered update to a Specsight spec. Fires automatically every time code lands on the tracked branch, touching only the scenarios that release changed.
When a Project is connected, Specsight watches the branch you nominate (often `main` or a release branch). Every time a release lands on that branch, a Sync fires: only the changed files are sent for analysis, and only the affected scenarios are updated. Unchanged scenarios are left alone.
A Sync usually finishes in minutes, even on large codebases. It does not rebuild the whole spec — that is what a Full Analysis does. And it does not require human approval — that is the structural shift that lets the spec follow the code with no one in the loop.
Once a Scenario has been edited by a Member, future Syncs do not overwrite the manual change. If the underlying code conflicts with the manual edit, the Scenario is flagged for review instead. The team always owns the final word.
Related terms
- OPERATIONS
Full Analysis
The initial scan of an entire codebase that produces the first version of a Specsight spec. From then on, only Syncs are needed.
- CONCEPT
Product Observability
Continuous insight into how a product behaves and changes, release by release — the way infrastructure observability (Datadog, Sentry) watches your systems, pointed at the product itself.
- PROBLEM
Documentation Drift
The gradual divergence between written documentation and the product it describes — widens with every release that nobody remembers to document.