Design the creator timeline
Emit fewer, better semantic moments that explain progress, stakes, setbacks, breakthroughs, and outcomes.
A creator timeline is not a firehose of inputs. It is an ordered set of verified moments that help a viewer or editor understand the story.
Three layers of fact
| Layer | Example | Typical consumer |
|---|---|---|
| Activity event | target 20 hit on dart 3 | replay/debug, detailed overlay |
| Story Event | Around the Clock completed | viewer overlay, editor timeline |
| Derived story judgment | first clean finish after three setbacks | Content Studio reasoning from several facts |
Packages should emit domain truth, not editorial speculation. The Studio can combine committed facts, Sprint context, and research into a narrative later.
Useful story vocabulary
- beginning: baseline established, goal activated, route chosen;
- progress: milestone cleared, consistency improved, rank gained;
- tension: near miss, regression, lead change, failed finish;
- breakthrough: personal best, first completion, record pace;
- outcome: Sprint finish line reached, match won, attempt abandoned;
- integrity: evidence gap, correction, event retraction, manual fallback.
Payload design
Include bounded facts that explain why the event matters: current/previous value, threshold, target, actor, round, route position, or rank. Avoid formatted sentences as the only source of meaning.
{
eventType: "rank_gained",
facts: {
modeId: "around-the-clock",
previousRank: "silver",
currentRank: "gold",
qualifyingResult: 38
}
}Density discipline
If every throw or keypress becomes a high-value Story Event, the timeline is unusable. Preserve granular activity evidence separately and emit story events at meaningful semantic boundaries. Use priorities only to distinguish value, not to make every event urgent.
Correction
When corrected evidence changes the story, emit a retraction for invalidated events and replacement events from exact replay. Preserve the audit trail so an editor never cuts a moment the current result disproves.
OBS and capture synchronization
Connect Station to a recording clock, verify presentation, and map committed facts to exact media windows without blocking practice.
Production evidence and Studio intake
Seal source provenance, activity truth, Story Events, media anchors, and gaps into an immutable editorial starting point.