This is a live demo — explore a slice of Specsight's own product spec, generated from its codebase. The full spec is much larger.
This is a live demo — explore a slice of Specsight's own product spec, generated from its codebase. The full spec is much larger.
| Context | Action | Outcome |
|---|---|---|
HP-35 code merged to the monitored branch of a connected project Action Specsight detects the change and starts a sync Outcome project status changes to syncing, spec stays visible to members | Specsight detects the change and starts a sync | project status changes to syncing, spec stays visible to members |
HP-36 Specsight analysing a code change that introduces new behaviour Action adds a new scenario to the relevant feature Outcome scenario appears with a Created badge and a changelog entry is recorded |
This early exit was the biggest efficiency gain in the sync pipeline. Roughly 60-70% of merges contain no product behaviour changes — style fixes, docs, config. Catching those early avoids running a full analysis unnecessarily.
adds a new scenario to the relevant feature |
scenario appears with a Created badge and a changelog entry is recorded |
HP-37 Specsight analysing a code change that modifies existing behaviour Action updates the matching scenario Outcome scenario updated, changelog records the before and after values | updates the matching scenario | scenario updated, changelog records the before and after values |
HP-38 Specsight analysing a code change that removes a behaviour Action marks the scenario as deleted Outcome scenario soft-deleted, recorded in the changelog as Deleted | marks the scenario as deleted | scenario soft-deleted, recorded in the changelog as Deleted |
HP-39 sync completes with scenario changes Action Specsight sends notifications to enrolled members Outcome email summarises created, updated, and deleted scenarios | Specsight sends notifications to enrolled members | email summarises created, updated, and deleted scenarios |
EC-23 code change contains only style fixes, documentation, or config updates Action Specsight evaluates the change before running a full analysis Outcome sync short-circuited, no scenarios updated | Specsight evaluates the change before running a full analysis | sync short-circuited, no scenarios updated |
EC-24 manually added scenario in a feature affected by a code change Action Specsight processes the feature during sync Outcome manual scenario preserved unchanged, retains its Manually Added label | Specsight processes the feature during sync | manual scenario preserved unchanged, retains its Manually Added label |
ER-18 sync encounters an unrecoverable error Action background task fails Outcome sync marked as failed, project returns to its previous state | background task fails | sync marked as failed, project returns to its previous state |