# HyperTwist - PRD.md

## Product definition

HyperTwist is a native cube and hypercube training environment that combines:

- physical recognition and reconstruction
- replay and explanation
- training/coaching orchestration
- hyper puzzle simulation
- publication/social training surfaces
- bounded voice/speech sidecars

## Canonical discovery surfaces

Use these before expanding or describing product truth:

- `FEATURE_REGISTRY.md` for normalized feature extraction and confidence tiers
- `ROADMAP.md` for current sequencing truth
- `C:\HyperTwist\docs\ops\HYPERTWIST_IMPLEMENTATION_PHASE_1_KICKOFF.md` for
  current landed runtime anchors
- `C:\HyperTwist\docs\ops\HYPERTWIST_MEMORY_LANE_AUTHORITY_AND_PHASE_IMPLEMENTATION_DOCTRINE_2026-05-21.md`
  for memory lane taxonomy and sequencing
- `C:\HyperTwist\docs\ops\HYPERTWIST_PROVIDER_NEUTRALITY_AND_BYOK_DOCTRINE_2026-05-21.md`
  for provider-neutral/BYOK rules
- `C:\HyperTwist\docs\ops\HYPERTWIST_SKILLIZATION_AND_COMMAND_SURFACE_DOCTRINE_2026-05-21.md`
  for skill-layer rollout

## Current product-state truth

The current product must be described carefully.

HyperTwist already has real first-party owned implementation, but later
manual/marketing work must distinguish:

- implemented now
- deep-source grounded retained capability
- shallow placeholder capability

The canonical normalized surface for that distinction is:

- `FEATURE_REGISTRY.md`

Do not infer product truth from donor presence, queue position, or prompt-pack
presence.

## Users

- beginners learning 3D solving
- intermediate and advanced cubers
- hypercubers
- educators
- content creators
- self-directed AI-assisted learners

## Core problems solved

- weak solve analysis in existing tools
- separation between physical practice and virtual analysis
- insufficient support for higher-dimensional practice
- fragmented training, timing, recognition, replay, and coaching flows

## Core feature families

- physical cube recognition and reconstruction
- replay and state explanation
- algorithm/drill training and session control
- coaching/progression
- hyper puzzle catalog/topology/runtime
- deferred immersive training environments and focus-presence shells
- publication/challenge/social training surfaces
- analytics/reporting and provenance
- bounded speech/voice sidecars

## Deferred first-party experiential lane

HyperTwist now has one explicit deferred experiential milestone:

- scenic virtual training environments and focus-presence shells

Important interpretation rule:

- this is planned HyperTwist-native product direction
- it is not current shipped capability
- it is not a generic virtual desktop/workspace shell
- it is separate from any future `VectorShell` immersive workspace lane

Canonical scoping note:

- `C:\HyperTwist\docs\HYPERTWIST_VIRTUAL_TRAINING_ENVIRONMENT_AND_SCENIC_IMMERSION_SCOPING_NOTE_2026-05-31.md`

## Product guardrails

- packet docs and live code beat summaries when conflicts exist
- provider-specific donor patterns must not define the top-level provider
  contract
- compacted or assistive-transformed outputs must remain derived, not
  authoritative
- skills must remain optional assistive layers, not mandatory product truth

## Success criteria

- users measurably improve faster
- higher-dimensional users take the platform seriously
- physical and virtual practice reinforce each other
- the product feels native, rigorous, and coherent
