Version roadmap
V1 documentation and V2 3D share one curriculum dataset, and map to the PRD's five product releases.
Two editions
| Version | Format | Status |
|---|---|---|
| V1 documentation edition | This site: 36 Foundation chapters, six Advanced domains, eight tracks, and full specifications for strategy research, the risk engine, journals, and AI | All 36 Foundation chapters, Advanced, and experiments available; real AI service not connected |
| V2 3D edition | This site's /world: 3D trading hall, six rooms, and ten simulations | Prototype: order-book simulation is operable |
These are not two sets of content. They share three repository packages:
| Package | Contents | Consumers |
|---|---|---|
@trader-os/curriculum | Metadata for all 36 chapters, 36 knowledge nodes, six Advanced domains, eight tracks, reading modes, paths, 3D rooms, and simulations | Documentation site and 3D edition |
@trader-os/sim | Models for order books and market orders, leverage and liquidation prices, and liquidation cascades. Pure TypeScript with numbers locked by tests | Documentation interactive components and 3D edition |
@trader-os/world | 3D engine, trading hall, and simulation scenes | Loaded on demand only by /world |
The order-book exercise in Chapter 13 and the 3D hall therefore produce the same numbers.
Mapping to PRD product releases
The PRD plans five releases:
| PRD version | Topic | Includes |
|---|---|---|
| V1 | Foundation + Crypto | 36 Foundation chaptersAdvanced CoreCrypto Market PackAI TutorStrategy LabJournalRisk System |
| V2 | Research & Portfolio | Systematic / QuantPortfolioAdvanced ResearchStrategy LifecyclePnL Attribution |
| V3 | 3D Simulation | 3D SimulationCrisis EngineMarket Maker SimulationPortfolio Simulator |
| V4 | Multi-asset | Tokenized EquitiesUS EquitiesOilGoldIndex Futures |
| V5 | Agentic Trader Lab | Research AgentData AgentRisk AgentExecution AgentPortfolio Agent |
The repository's two editions are grouped by delivery format:
- V1 documentation delivers PRD V1 and V2 curriculum: Foundation, Advanced, the Crypto pack, and specifications for research, risk, journals, strategy lifecycles, and attribution. AI Tutor integration follows the documentation edition.
- V2 3D delivers PRD V3: 3D simulations, a crisis engine, market-making simulation, and a portfolio simulator.
- PRD V4 multi-asset packs and V5 Agentic Trader Lab extend both editions.
Release sequence
The PRD's strategy is text and basic labs first, then Advanced modules and data/strategy labs, and finally core 3D simulations. Do not build the complete 3D world on day one.
The repository follows that sequence:
- Now: all 36 Foundation chapters, six Advanced domains, eight strategy cards, workbook, and capstones are available. Probability, risk, backtest, portfolio, execution, and journal experiments work. The 3D technology validation and order-book prototype remain.
- Local learning tools: reading, self-tests, consequence choices, lab/research snapshots can be explicitly saved. Mastery is learner self-report only. The question workbench prepares materials; real AI answers are not connected.
- Progress integration pending: documentation records do not yet automatically unlock 3D. Remaining simulations and crises follow the 3D plan.
- Release pending: deployment and domain configuration remain unfinished. Local validation does not establish an online release.
Shared learning progress
The goal is continuous learning across documentation and 3D on the same node: order-book reading unlocks its simulation, then Advanced impact adds large-order impact. Reading and learning records currently save locally; automatic 3D unlocking and deeper-scene integration remain unfinished. Reading records do not automatically establish concept mastery.