# Distributed TraderX · Yeshiva University

> A sell-side OMS on the LMAX architecture; Yeshiva University CS

This file contains links to documentation sections following the llmstxt.org standard.

## Table of Contents

- [FINOS | TraderX Sample Trading App](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/): ![DEV Only Warning](https://badgen.net/badge/warning/not-for-production/red) ![Local Dev Machine Supported](http://badgen.net/badge/local-dev/suppo...
- [ADR-001 Adopt GitHub Spec Kit](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/adr/001-adopt-github-speckit): TraderX is being repositioned as a spec-driven learning platform where implementation is generated from requirements instead of copied from legacy ...
- [ADR-002 Generated State Branching Strategy](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/adr/002-generated-state-branching-strategy): TraderX must support two valid consumer modes:
- [ADR-003 Intentional Legacy-Shaped Baseline](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/adr/003-baseline-intentionally-simplistic-legacy-shaped): The first TraderX learning state is the baseline from which users will evolve architecture and quality characteristics across multiple learning pat...
- [ADR-004 Lightweight Baseline Infra and Replaceability](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/adr/004-prefer-lightweight-default-infra-and-swappable-components): The baseline state must be runnable by users with minimal local setup and without requiring heavy infrastructure installation. Using production-gra...
- [ADR-005 Use NATS for State 006 Messaging Replacement](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/adr/005-state-006-use-nats-for-messaging-replacement): The baseline and early states used a Socket.IO-based messaging service (`trade-feed`) for both backend event propagation and frontend live updates....
- [ADR-006 Use PostgreSQL for State 005 Database Replacement](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/adr/006-state-005-use-postgres-for-database-replacement): State `004-containerized-compose-runtime` uses H2 as the runtime database. That choice kept local startup simple, but it limited realism for SQL be...
- [ADR-007 Adopt LGTM + OpenTelemetry Stack for State 007 Baseline](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/adr/007-state-007-adopt-lgtm-observability-stack): Before state `006`, TraderX had no consistent, end-to-end observability baseline in generated runtime states. We needed a repeatable, local-first o...
- [ADR-008 Convergence State Model (C0-C3)](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/adr/008-convergence-state-model): TraderX now contains multiple tracks (architecture, functional, and platform/devex). We need a predictable way to:
- [Project ADRs](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/adr): This is the active ADR set for TraderX SpecKit governance.
- [From London Hackathon to Open-Source Baseline](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2023-05-from-hackathon-to-open-source-baseline): How TraderX moved from early internal prototyping into an open-source baseline with runnable services and multiple UI paths.
- [Open-Source Hardening and Governance Foundations](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2023-09-open-source-hardening-and-governance): The period where TraderX established security, scanning, and governance conventions needed for sustainable open-source maintenance.
- [OSFF NYC Keynote Demo and Go-Live Momentum](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2023-11-osff-nyc-keynote-and-go-live): TraderX visibility increased with Open Source in Finance Forum exposure and project go-live preparation work.
- [Docusaurus Portal and Project Storytelling](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2024-03-docs-portal-and-project-storytelling): How TraderX moved from mostly code-first navigation to a documentation portal that improved discoverability and onboarding.
- [Platform Paths on Kubernetes and Radius](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2024-09-platform-paths-kubernetes-radius): TraderX expanded beyond local/compose workflows with Kubernetes-focused developer experience and Radius platform modeling experiments.
- [TraderX + GitHub SpecKit Migration (Technical Retrospective)](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2026-03-29-traderx-speckit-migration): A detailed write-up of the TraderX migration to GitHub SpecKit, including false starts, process corrections, branch strategy, and lessons learned.
- [State 006: Swapping Socket.IO for NATS](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2026-03-31-state-007-nats-architecture-track): TraderX state 006 moves from a brittle Socket.IO messaging layer to NATS, establishes the architecture-track messaging baseline, and shows why Spec...
- [March 31, 2026: State 005 - Replacing H2 with PostgreSQL](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2026-03-31-state-010-postgres-architecture-track): State `005-postgres-database-replacement` is the first architecture-focused database transition after `004-containerized-compose-runtime`.
- [March 31, 2026: State 008 - Pricing Awareness as a Functional Track](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2026-03-31-state-011-pricing-awareness-functional-track): State `008-pricing-awareness-market-data` extends `007-observability-lgtm-compose` and marks the first major functional expansion after the NATS me...
- [April 6, 2026: Convergence Milestone Releases (C0-C3)](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2026-04-06-convergence-milestone-releases): We introduced explicit convergence milestones so developers have clear, recommended jump-off points for new state work.
- [April 6, 2026: State 007 - Observability Baseline with LGTM](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2026-04-06-state-007-observability-baseline): State `007-observability-lgtm-compose` adds a reusable observability baseline on top of the architecture chain (`005` PostgreSQL + `006` NATS).
- [April 6, 2026: State 009 - Rudimentary Order Manager and Matcher](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2026-04-06-state-009-order-management-matcher): State `009-order-management-matcher` introduces a deliberately simple order-management model to demonstrate architecture and flow shape, not market...
- [April 10, 2026: Custom Overlay Model for Environment-Specific TraderX](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2026-04-10-custom-overlay-model-and-example): TraderX now documents a clear customization path for teams that need environment-specific runtime, package, messaging, or governance constraints wh...
- [April 10, 2026: State 003 - Agentic Harness Foundation](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2026-04-10-state-003-agentic-harness-foundation): State `003-agentic-harness-foundation` was added as an early, non-domain feature state so generated codebases are easier to work with using agentic...
- [April 18, 2026: Integrating FDC3 in TraderX (What Worked, What Was Flaky, What We Learned)](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2026-04-18-fdc3-integration-lessons): State `014-fdc3-intent-interoperability` was our first end-to-end pass at wiring FDC3 interaction patterns into a live TraderX environment.
- [April 20, 2026: Why Our TraderX + Sail Migration to @morgan-stanley/fdc3-web Failed (and What We Learned)](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2026-04-20-fdc3-web-migration-retrospective): This post documents a real migration attempt in state `014-fdc3-intent-interoperability`: replacing our working FDC3 integration path with `@morgan...
- [May 20, 2026: We’re Finally Live with TraderX Demos](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog/2026-05-20-were-finally-live-demos): After a lot of design, implementation, debugging, and deployment work, TraderX now has live FINOS-hosted demo environments:
- [Blog](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/blog): This blog captures the broader TraderX story over time: how the project started, how it was prepared for open-source growth, how platform and docum...
- [EOD integration and recovery boundaries](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/engineering/integration-and-recovery): Implemented support, an enabled profile and a validated production installation are different claims.
- [Observability and replay](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/engineering/observability-and-replay): Distributed order traces, market history and analytical playback.
- [External risk-engine integration](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/engineering/risk-engine-integration-fit): TraderX owns order, trade, position and EOD export behavior. The external engine owns financial models and supported calculations. Integration join...
- [Risk integration status](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/engineering/risk-engine-integration-status): Current integration is YU18, with behavior and limits documented in [EOD integration and recovery](integration-and-recovery.md). The closed contain...
- [Consuming an EOD risk extract](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/engineering/risk-extract-consumer-guide): The exporter freezes a portfolio at a consensus sequence and writes un-netted positions with counterparty identity. A completion receipt identifies...
- [Test coverage](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/engineering/test-coverage): What is tested, which checks run automatically, and how the counts are defined.
- [Testing strategy](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/engineering/testing-strategy): Which checks are automated, which are operator-run, and why each one sits where it does.
- [Demo console and Trader Desk](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/engineering/ui-workflows): The Demo console and Trader Desk use the same TraderX services. Available actions depend on the services and permissions configured for the workspace.
- [What's new](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/engineering/whats-new): What this build adds to upstream FINOS TraderX across YU01–YU18, plus market data, trading interfaces and recovery.
- [TraderX documentation](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/home): Yeshiva University's TraderX build extends the FINOS reference application with a sequenced matching engine, risk controls, post-trade processing a...
- [Learning Guides](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/): This section is the developer-focused learning layer for generated TraderX code states.
- [State 001: Simple App - Base Uncontainerized App](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-001-baseline-uncontainerized-parity): Upstream numbered lineage, separate from YU01–YU18.
- [State 002: Edge Proxy Uncontainerized](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-002-edge-proxy-uncontainerized): Upstream numbered lineage, separate from YU01–YU18.
- [State 003: Agentic Harness Foundation](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-003-agentic-harness-foundation): Upstream numbered lineage, separate from YU01–YU18.
- [State 004: Containerized Compose Runtime (NGINX Ingress)](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-004-containerized-compose-runtime): Upstream numbered lineage, separate from YU01–YU18.
- [State 005: PostgreSQL Database Replacement](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-005-postgres-database-replacement): Upstream numbered lineage, separate from YU01–YU18.
- [State 006: Messaging Layer Replacement with NATS](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-006-messaging-nats-replacement): Upstream numbered lineage, separate from YU01–YU18.
- [State 007: Observability with LGTM on Compose](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-007-observability-lgtm-compose): Upstream numbered lineage, separate from YU01–YU18.
- [State 008: Pricing Awareness and Market Data Streaming](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-008-pricing-awareness-market-data): Upstream numbered lineage, separate from YU01–YU18.
- [State 009: Order Management and Matcher](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-009-order-management-matcher): Upstream numbered lineage, separate from YU01–YU18.
- [State 010: Kubernetes Runtime on C2](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-010-kubernetes-runtime): Upstream numbered lineage, separate from YU01–YU18.
- [State 011: Tilt Local Dev on Kubernetes](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-011-tilt-kubernetes-dev-loop): Upstream numbered lineage, separate from YU01–YU18.
- [State 012: Platform Convergence C3](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-012-platform-convergence-c3): Upstream numbered lineage, separate from YU01–YU18.
- [State 013: Radius Platform on Kubernetes (Optional)](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-013-radius-kubernetes-platform): Upstream numbered lineage, separate from YU01–YU18.
- [State 014: FDC3 Intent Interoperability on C3](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-014-fdc3-intent-interoperability): Upstream numbered lineage, separate from YU01–YU18.
- [State YU01-lmax-sequencer: LMAX Sequencer (Trading Hot Path)](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU01-lmax-sequencer): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU02-lmax-kubernetes: LMAX Kubernetes](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU02-lmax-kubernetes): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU03-in-memory-risk-gateway: In-Memory Risk Gateway](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU03-in-memory-risk-gateway): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU04-durable-control-feeds: Durable Control Feeds](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU04-durable-control-feeds): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU05-post-trade-compliance: Post-Trade Compliance Bundle](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU05-post-trade-compliance): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU06-eod-price-production: EOD Price Production + Overnight Batch Chain](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU06-eod-price-production): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU07-historical-tick-store: Historical Tick Store](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU07-historical-tick-store): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU08-execution-algo-engine: Execution Algo Engine](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU08-execution-algo-engine): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU09-ops-hardening: Ops Hardening](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU09-ops-hardening): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU10-fix-ingress: FIX Order-Entry Ingress](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU10-fix-ingress): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU11-aeron-replication: Aeron SBE BLP Replication](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU11-aeron-replication): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU12-aeron-cluster: Aeron Cluster BLP Consensus](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU12-aeron-cluster): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU13-limit-order-book: Crossing Limit-Order Book](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU13-limit-order-book): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU14-listed-equity-options: Listed Equity Options](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU14-listed-equity-options): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU15-eod-risk-extract: EOD Risk Extract](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU15-eod-risk-extract): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU16-cdm-instruments: CDM Instruments](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU16-cdm-instruments): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU17-otc-rates: OTC Interest-Rate Swaps](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU17-otc-rates): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [State YU18-risk-integration: Risk Integration](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning/state-YU18-risk-integration): YU lineage. Current integration behavior is described in the [state overview](/docs/engineering/whats-new); historical state branches may differ.
- [Learning Paths](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/learning-paths/): This page is generated from `catalog/state-catalog.json`.
- [Overview](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/overview): State-specific architecture and flow documentation now lives under root SpecKit feature packs.
- [Project History](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/project-history): This page tracks major milestones, architectural changes, and notable releases for TraderX.
- [Build & Run Guide](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/running): There are several ways to run TraderX locally. Choose the method you're most comfortable with.
- [API Explorer](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/api-explorer): TraderX provides a standalone runtime API explorer mounted at `/api/docs`.
- [AWS EC2 Compose Host Prerequisites](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/aws-ec2-compose-prerequisites): This guide documents host-level prerequisites for running generated TraderX deploy bundles on an EC2 host with an external NGINX reverse proxy.
- [AWS EC2 Kubernetes Host Prerequisites](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/aws-ec2-kubernetes-prerequisites): This document defines the host and cluster prerequisites for a future `aws-ec2-k8s` deployment profile.
- [Baseline vs Parity](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/baseline-vs-parity): Baseline is the specification source of truth:
- [Convergence States](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/convergence-states): TraderX uses explicit convergence checkpoints to keep multi-track evolution understandable and maintainable.
- [Corporate Environments Guide](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/corporate-environments-guide): This guide defines how enterprises can extend TraderX privately without pushing corporate-specific changes upstream.
- [Custom Environments Guide](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/custom-environments-guide): This guide defines implementation norms for custom TraderX overlays that run in controlled or non-default operating environments.
- [Custom Overlay Architecture](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/custom-overlay-architecture): This document defines the upstream reference contract for implementing a custom TraderX overlay repository without modifying upstream TraderX state...
- [Customizing TraderX](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/customizing-traderx): Use this page as the single entrypoint for building and operating a private overlay on top of upstream TraderX.
- [Generated State Branches](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/generated-state-branches): TraderX keeps the canonical source of truth in `specs/**` + `.specify/**`, and publishes code-only snapshots in dedicated `code/generated-state-*` ...
- [Generated State CI Policy](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/generated-state-ci): This document defines the CI contract for generated TraderX code branches.
- [Getting Started with TraderX](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/getting-started-with-traderx): TraderX has multiple generated codebases representing different learning states, from a simple pre-container baseline to a more feature-rich platfo...
- [SpecKit Getting Started](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/): This project is built so a contributor can regenerate the baseline system from requirements and then evolve future states through SpecKit feature p...
- [Live Environments](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/live-environments): This page tracks canonical live TraderX demo environments and their mapped generated-state branches.
- [Messaging Subject Map Standard](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/messaging-subject-map-standard): States that introduce, remove, or modify message-bus subject families MUST maintain `system/messaging-subject-map.md`.
- [Patch-Set Authoring Workflow](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/patchset-authoring): Use this workflow for any new state implementation or state update.
- [Run Generated Baseline](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/run-generated-overlays): This is the canonical runbook for the base uncontainerized generated runtime.
- [Spec Kit Generation Guide](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/spec-kit-generation-guide): This guide describes how to regenerate TraderX code from specs and evolve between states.
- [SpecKit Learning Path Strategy](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/spec-kit-learning-path-strategy): TraderX uses a convergence-first state model on top of GitHub Spec Kit artifacts in `specs/` and `.specify/`.
- [Spec Kit Portal](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/spec-kit-portal): This is the single map for where Spec Kit artifacts live in TraderX and how they are used for generation.
- [GitHub Spec Kit Workflow](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/spec-kit-workflow): TraderX baseline generation now follows a root-canonical GitHub Spec Kit flow.
- [Components within a state spec pack](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/state-components): Adopted by user direction on 2026-09-23. Applies to new component work; existing states do not need a bulk migration.
- [State Docs](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/state-docs): This page is generated from `catalog/state-catalog.json` and links the most important per-state artifacts.
- [Multi-State Generation Plan](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/state-transition-generation-plan): This plan defines how TraderX evolves through numbered states with explicit convergence checkpoints.
- [TraderX v2.0 Go-Live TODO](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/v2-go-live-todo): Status: in progress.
- [Learning Paths (Moved)](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/visual-learning-graphs): The visual learning graph and state map were consolidated into a single canonical page:
- [Why TraderX Was Reworked Around SpecKit](https://yu-cs-summer-2026-distributed-traderx.github.io/traderX/docs/spec-kit/why-speckit): TraderX was reworked around SpecKit to make multi-state learning paths practical to maintain.