2 KiB
2 KiB
HyperTwist — AGENTS.md
What HyperTwist is
HyperTwist is the portfolio’s cube and hypercube training environment. It must preserve two identities at once:
- a practical physical-cube recognition, replay, and coaching platform
- a serious higher-dimensional simulation and hypercubing environment
It is not enough for HyperTwist to be good at only one of those.
Authority order
repo_portfolio_unified_v6_3.*- This
AGENTS.md - The rest of the HyperTwist v6.5 manual set
- CubeForge initial research as inspiration only, not as code to directly integrate
Core directives
Dual-pillar preservation
Never collapse:
- physical cube pipeline
- hypercube simulation pipeline
They are parallel pillars that reinforce each other.
Unreal-first posture
HyperTwist is native-first. The main runtime should be Unreal Engine 5.4+ with:
- C++ core systems
- Blueprints for UX and training orchestration
- optional OpenXR/VR/MR modes where they materially strengthen higher-dimensional learning
Backbone language bias
Prefer:
- C++
- Rust
- bounded C#
Minimize:
- TypeScript
- Node.js
- Python
But do not remove them where they are still the best practical host for:
- CV/model inference
- certain training or ingestion helpers
- thin companion UIs
Repo classification lens
HyperTwist repos should be judged in these families:
- hypercube simulation foundations
- 3D twisty-puzzle foundations
- physical-cube recognition
- replay and solve analytics
- training and curriculum
- coaching and personalization
- immersive rendering / XR
- export and progression
Coding-model duties
For any HyperTwist repo, the coding model must determine:
- what is truly implemented
- whether it strengthens the physical pipeline, the hyper pipeline, or both
- whether it belongs natively in the runtime, in a sidecar, or only as donor logic
- whether it should be treated as foundation, strategic donor, reserve, or comparator
- whether additional org/index harvesting is still worthwhile