Sphoton/Docs/Onboarding

Onboarding guide

How your team goes from the first call to using Sphoton every day, and what we need from you at each step.

Copies the whole page as Markdown.
Updated
October 2026
Sections
—
Reading time
—

The short version

  • Onboarding takes about six weeks, in seven steps, starting with a 45-minute call.
  • You name one champion who decides on your side. We name one onboarding lead.
  • We start with a pilot: one repository and the modules your team asks about most.
  • Going live is a joint decision, made on agreed criteria.
  • For two weeks after go-live, every bug or request gets a response within 24 hours.

1. The steps

StepWhat happensFinishes whenLength
00 Discovery callWe learn your system and agree a pilot area.Beta agreed, kickoff booked45 min
01 Kickoff and setupScope, success criteria and owners agreed. Workspace, seats and keys set up.Pilot team signed inDays 1–5
02 DeliveryPilot modules mapped and certified. Commander connected.Pilot ready to testWeeks 1–3
03 Testing and trainingYour team tests agreed scenarios. Every seat is trained.Acceptance signed offWeek 3–4
04 Go / no-go callWe check the criteria together.A written decision60 min
05 HypercareCloser support, 24-hour responses.Exit criteria met2 weeks
06 OnboardedStandard support and regular reviews.Value confirmedOngoing

Lengths are typical for a team of up to 15 with one repository. Larger teams agree their own timeline at kickoff.

2. Who is involved

RoleSideDoes
ChampionYouDecides on your side and keeps the team moving.
AdminYouSeats, model keys, environments and access.
Certifying engineerYouReviews and certifies the pilot modules.
Pilot usersYouTest Sphoton and use it in daily work.
Onboarding leadSphotonYour main contact: plan, status, go / no-go, reviews.
Delivery engineerSphotonSetup, mapping support, Commander, training, hypercare.

3. Discovery call

Book it from Join the beta with your name, work email, company and team size, then pick a time. In 45 minutes we cover your system, where knowledge lives today, a short demo, and whether there is a good pilot. Within 24 hours you get a written summary, the beta terms and a kickoff date.

4. Kickoff and setup

A 60-minute kickoff agrees the pilot scope, measurable success criteria, owners on both sides, a weekly 30-minute check-in, and the dates for testing, the go / no-go call and hypercare.

4.1 What we need from you

  • Your champion, admin and certifying engineer, by name.
  • Seats for the pilot team.
  • Your model keys, added by your admin.
  • A place on your infrastructure for Commander.
  • Each member's recovery key, stored safely.

5. Delivery

We map the pilot modules with you: purpose, data, behaviour, boundaries and impact. Your certifying engineer certifies each one at a revision. Commander is deployed on your infrastructure and reads the map. You get a short written status after every weekly check-in.

6. Testing and training

Your pilot users test Sphoton against scenarios agreed in advance. You decide whether each one passes.

ScenarioPasses when
Impact of a changeAn engineer finds every module a real past change touched.
A question for your expertRecent questions are answered from the map.
Staying currentA merge marks the module for review; re-certifying clears it.
Agent sessionA new agent session starts with the certified conditions.
AccessEach seat sees and does only what its role allows.

Each seat gets a short training session (30 to 45 minutes), recorded for later.

7. Go / no-go call

We go live when testing is signed off with no blocking issues, the pilot modules are certified at a current revision, Commander answers from the map, every pilot user can sign in, and recovery keys are stored.

DecisionThen
GoLive the same day; hypercare starts.
Go with conditionsLive, with open minor items tracked to a date.
No-goWe agree the fixes and a new date, usually within two weeks.

8. Hypercare

Two weeks of closer support straight after go-live, extended if needed. Every bug or request gets a response within 24 hours. A response means a person has read it, set its severity and told you what happens next.

SeverityMeaningTarget
S1Blocked, or data at risk.Workaround within 1 business day.
S2A main task fails, no workaround.Fixed within 3 business days.
S3Minor fault, workaround available.Next scheduled release.
RequestA change or new feature.Triaged; we tell you where it landed.

To report: who you are, your seat, what you did, what you expected, what happened, and a screenshot if you can. Hypercare ends after five business days without a blocking issue, once your success criteria are met.

9. After onboarding

Standard support starts, with a response within one business day. We meet at 30, 60 and 90 days to review use, widen the rollout and collect your beta feedback.

10. Beta terms

Order of joiningDiscount, first 3 months
1st firm50%
2nd firm40%
3rd firm30%
4th firm20%
5th firm10%

Your slot is held from the day the beta is agreed in writing. In return you join the weekly check-ins, testing and the reviews. Questions: [email protected].