Methodology
How Shiftwell computes scores (MVP version) and how it relates to external references.
Scores (MVP v0.1)
- Risk score (SLI proxy): weekly load or risk score derived from work and sleep schedule.
- Sleep score (proxy): combines average sleep duration and regularity proxy.
- Adaptability score (main): combines inverse risk and sleep score (proxy v0.1).
External references
Shiftwell relies on third-party scientific references and on a local working copy of the workbook. The MVP currently implements proxy logic for a fast product pilot, then will be aligned more strictly with the protocol.
The references below remain external works. Showing them here does not mean authorship or ownership by Shiftwell.
External article
External workbook (local working copy)
See provenance-aware source mapping in the repository docs.
External reference ↔ Shiftwell mapping
| External reference item | Shiftwell variable | Status |
|---|---|---|
| Hours worked | Computed from weekly work segments | Implemented |
| Long shifts | Count of long work segments (proxy threshold) | Implemented (proxy) |
| Recovery | Longest recovery window between shifts | Implemented (proxy) |
| Night shifts | Overlap with biological night window | Implemented (proxy) |
| Biological loss | Work encroachment in biological window (23:00-07:00 proxy) | Implemented (proxy) |
| Social loss | Work encroachment in social window (proxy) | Implemented (proxy) |
| SRI/TST | Regularity proxy + total sleep time | MVP proxy |
Current limitations
- Current version = proxy v0.1 (thresholds and weights still to be aligned with the final protocol).
- Self-reported input (no actigraphy).
- Adaptability score not cohort-calibrated in V1.
- No clinical recommendations in output (intentional).
Method roadmap
- Strict SLI threshold alignment with paper or protocol
- Add average reference (paper or cohort baseline)
- Calibrate adaptability score on cohort data
- Move to a true visual calendar grid (drag and drop) if needed