# TraderX

> TraderX

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

## Table of Contents

- [FINOS | TraderX Sample Trading App](https://traderx.finos.org/../docs/README.md): ![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://traderx.finos.org/docs/adr/001-adopt-github-speckit.md): 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://traderx.finos.org/docs/adr/002-generated-state-branching-strategy.md): TraderX must support two valid consumer modes:
- [ADR-003 Intentional Legacy-Shaped Baseline](https://traderx.finos.org/docs/adr/003-baseline-intentionally-simplistic-legacy-shaped.md): 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://traderx.finos.org/docs/adr/004-prefer-lightweight-default-infra-and-swappable-components.md): 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://traderx.finos.org/docs/adr/005-state-006-use-nats-for-messaging-replacement.md): 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://traderx.finos.org/docs/adr/006-state-005-use-postgres-for-database-replacement.md): 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://traderx.finos.org/docs/adr/007-state-007-adopt-lgtm-observability-stack.md): 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://traderx.finos.org/docs/adr/008-convergence-state-model.md): TraderX now contains multiple tracks (architecture, functional, and platform/devex). We need a predictable way to:
- [Project ADRs](https://traderx.finos.org/docs/adr.md): This is the active ADR set for TraderX SpecKit governance.
- [From London Hackathon to Open-Source Baseline](https://traderx.finos.org/docs/blog/2023-05-from-hackathon-to-open-source-baseline.md): 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://traderx.finos.org/docs/blog/2023-09-open-source-hardening-and-governance.md): 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://traderx.finos.org/docs/blog/2023-11-osff-nyc-keynote-and-go-live.md): TraderX visibility increased with Open Source in Finance Forum exposure and project go-live preparation work.
- [Docusaurus Portal and Project Storytelling](https://traderx.finos.org/docs/blog/2024-03-docs-portal-and-project-storytelling.md): How TraderX moved from mostly code-first navigation to a documentation portal that improved discoverability and onboarding.
- [Platform Paths on Kubernetes and Radius](https://traderx.finos.org/docs/blog/2024-09-platform-paths-kubernetes-radius.md): TraderX expanded beyond local/compose workflows with Kubernetes-focused developer experience and Radius platform modeling experiments.
- [TraderX + GitHub SpecKit Migration (Technical Retrospective)](https://traderx.finos.org/docs/blog/2026-03-29-traderx-speckit-migration.md): 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://traderx.finos.org/docs/blog/2026-03-31-state-007-nats-architecture-track.md): 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://traderx.finos.org/docs/blog/2026-03-31-state-010-postgres-architecture-track.md): 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://traderx.finos.org/docs/blog/2026-03-31-state-011-pricing-awareness-functional-track.md): 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://traderx.finos.org/docs/blog/2026-04-06-convergence-milestone-releases.md): 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://traderx.finos.org/docs/blog/2026-04-06-state-007-observability-baseline.md): 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://traderx.finos.org/docs/blog/2026-04-06-state-009-order-management-matcher.md): 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://traderx.finos.org/docs/blog/2026-04-10-custom-overlay-model-and-example.md): 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://traderx.finos.org/docs/blog/2026-04-10-state-003-agentic-harness-foundation.md): 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://traderx.finos.org/docs/blog/2026-04-18-fdc3-integration-lessons.md): 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://traderx.finos.org/docs/blog/2026-04-20-fdc3-web-migration-retrospective.md): 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://traderx.finos.org/docs/blog/2026-05-20-were-finally-live-demos.md): After a lot of design, implementation, debugging, and deployment work, TraderX now has live FINOS-hosted demo environments:
- [Blog](https://traderx.finos.org/blog.md): 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...
- [TraderX Portal](https://traderx.finos.org/docs/home.md): TraderX is a SpecKit-first reference trading system.
- [Learning Guides](https://traderx.finos.org/docs/learning.md): This section is the developer-focused learning layer for generated TraderX code states.
- [State 001: Simple App - Base Uncontainerized App](https://traderx.finos.org/docs/learning/state-001-baseline-uncontainerized-parity.md): - Previous state(s): none
- [State 002: Edge Proxy Uncontainerized](https://traderx.finos.org/docs/learning/state-002-edge-proxy-uncontainerized.md): - Previous state(s): [001-baseline-uncontainerized-parity](/docs/learning/state-001-baseline-uncontainerized-parity)
- [State 003: Agentic Harness Foundation](https://traderx.finos.org/docs/learning/state-003-agentic-harness-foundation.md): - Previous state(s): [002-edge-proxy-uncontainerized](/docs/learning/state-002-edge-proxy-uncontainerized)
- [State 004: Containerized Compose Runtime (NGINX Ingress)](https://traderx.finos.org/docs/learning/state-004-containerized-compose-runtime.md): - Previous state(s): [003-agentic-harness-foundation](/docs/learning/state-003-agentic-harness-foundation)
- [State 005: PostgreSQL Database Replacement](https://traderx.finos.org/docs/learning/state-005-postgres-database-replacement.md): - Previous state(s): [004-containerized-compose-runtime](/docs/learning/state-004-containerized-compose-runtime)
- [State 006: Messaging Layer Replacement with NATS](https://traderx.finos.org/docs/learning/state-006-messaging-nats-replacement.md): - Previous state(s): [005-postgres-database-replacement](/docs/learning/state-005-postgres-database-replacement)
- [State 007: Observability with LGTM on Compose](https://traderx.finos.org/docs/learning/state-007-observability-lgtm-compose.md): - Previous state(s): [006-messaging-nats-replacement](/docs/learning/state-006-messaging-nats-replacement)
- [State 008: Pricing Awareness and Market Data Streaming](https://traderx.finos.org/docs/learning/state-008-pricing-awareness-market-data.md): - Previous state(s): [007-observability-lgtm-compose](/docs/learning/state-007-observability-lgtm-compose)
- [State 009: Order Management and Matcher](https://traderx.finos.org/docs/learning/state-009-order-management-matcher.md): - Previous state(s): [008-pricing-awareness-market-data](/docs/learning/state-008-pricing-awareness-market-data)
- [State 010: Kubernetes Runtime on C2](https://traderx.finos.org/docs/learning/state-010-kubernetes-runtime.md): - Previous state(s): [009-order-management-matcher](/docs/learning/state-009-order-management-matcher)
- [State 011: Tilt Local Dev on Kubernetes](https://traderx.finos.org/docs/learning/state-011-tilt-kubernetes-dev-loop.md): - Previous state(s): [010-kubernetes-runtime](/docs/learning/state-010-kubernetes-runtime)
- [State 012: Platform Convergence C3](https://traderx.finos.org/docs/learning/state-012-platform-convergence-c3.md): - Previous state(s): [011-tilt-kubernetes-dev-loop](/docs/learning/state-011-tilt-kubernetes-dev-loop)
- [State 013: Radius Platform on Kubernetes (Optional)](https://traderx.finos.org/docs/learning/state-013-radius-kubernetes-platform.md): - Previous state(s): [012-platform-convergence-c3](/docs/learning/state-012-platform-convergence-c3)
- [State 014: FDC3 Intent Interoperability on C3](https://traderx.finos.org/docs/learning/state-014-fdc3-intent-interoperability.md): - Previous state(s): [012-platform-convergence-c3](/docs/learning/state-012-platform-convergence-c3)
- [Learning Paths](https://traderx.finos.org/docs/learning-paths.md): This page is generated from `catalog/state-catalog.json`.
- [Overview](https://traderx.finos.org/docs/overview.md): State-specific architecture and flow documentation now lives under root SpecKit feature packs.
- [Project History](https://traderx.finos.org/docs/project-history.md): This page tracks major milestones, architectural changes, and notable releases for TraderX.
- [Build & Run Guide](https://traderx.finos.org/docs/running.md): There are several ways to run TraderX locally. Choose the method you're most comfortable with.
- [API Explorer](https://traderx.finos.org/docs/spec-kit/api-explorer.md): TraderX provides a standalone runtime API explorer mounted at `/api/docs`.
- [AWS EC2 Compose Host Prerequisites](https://traderx.finos.org/docs/spec-kit/aws-ec2-compose-prerequisites.md): 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://traderx.finos.org/docs/spec-kit/aws-ec2-kubernetes-prerequisites.md): This document defines the host and cluster prerequisites for a future `aws-ec2-k8s` deployment profile.
- [Baseline vs Parity](https://traderx.finos.org/docs/spec-kit/baseline-vs-parity.md): Baseline is the specification source of truth:
- [Convergence States](https://traderx.finos.org/docs/spec-kit/convergence-states.md): TraderX uses explicit convergence checkpoints to keep multi-track evolution understandable and maintainable.
- [Corporate Environments Guide](https://traderx.finos.org/docs/spec-kit/corporate-environments-guide.md): This guide defines how enterprises can extend TraderX privately without pushing corporate-specific changes upstream.
- [Custom Environments Guide](https://traderx.finos.org/docs/spec-kit/custom-environments-guide.md): This guide defines implementation norms for custom TraderX overlays that run in controlled or non-default operating environments.
- [Custom Overlay Architecture](https://traderx.finos.org/docs/spec-kit/custom-overlay-architecture.md): This document defines the upstream reference contract for implementing a custom TraderX overlay repository without modifying upstream TraderX state...
- [Customizing TraderX](https://traderx.finos.org/docs/spec-kit/customizing-traderx.md): Use this page as the single entrypoint for building and operating a private overlay on top of upstream TraderX.
- [Generated State Branches](https://traderx.finos.org/docs/spec-kit/generated-state-branches.md): 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://traderx.finos.org/docs/spec-kit/generated-state-ci.md): This document defines the CI contract for generated TraderX code branches.
- [Getting Started with TraderX](https://traderx.finos.org/docs/spec-kit/getting-started-with-traderx.md): 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://traderx.finos.org/docs/spec-kit.md): 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://traderx.finos.org/docs/spec-kit/live-environments.md): This page tracks canonical live TraderX demo environments and their mapped generated-state branches.
- [Messaging Subject Map Standard](https://traderx.finos.org/docs/spec-kit/messaging-subject-map-standard.md): States that introduce, remove, or modify message-bus subject families MUST maintain `system/messaging-subject-map.md`.
- [Patch-Set Authoring Workflow](https://traderx.finos.org/docs/spec-kit/patchset-authoring.md): Use this workflow for any new state implementation or state update.
- [Run Generated Baseline](https://traderx.finos.org/docs/spec-kit/run-generated-overlays.md): This is the canonical runbook for the base uncontainerized generated runtime.
- [Spec Kit Generation Guide](https://traderx.finos.org/docs/spec-kit/spec-kit-generation-guide.md): This guide describes how to regenerate TraderX code from specs and evolve between states.
- [SpecKit Learning Path Strategy](https://traderx.finos.org/docs/spec-kit/spec-kit-learning-path-strategy.md): TraderX uses a convergence-first state model on top of GitHub Spec Kit artifacts in `specs/` and `.specify/`.
- [Spec Kit Portal](https://traderx.finos.org/docs/spec-kit/spec-kit-portal.md): 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://traderx.finos.org/docs/spec-kit/spec-kit-workflow.md): TraderX baseline generation now follows a root-canonical GitHub Spec Kit flow.
- [State Docs](https://traderx.finos.org/docs/spec-kit/state-docs.md): This page is generated from `catalog/state-catalog.json` and links the most important per-state artifacts.
- [Multi-State Generation Plan](https://traderx.finos.org/docs/spec-kit/state-transition-generation-plan.md): This plan defines how TraderX evolves through numbered states with explicit convergence checkpoints.
- [TraderX v2.0 Go-Live TODO](https://traderx.finos.org/docs/spec-kit/v2-go-live-todo.md): Status: in progress.
- [Learning Paths (Moved)](https://traderx.finos.org/docs/spec-kit/visual-learning-graphs.md): The visual learning graph and state map were consolidated into a single canonical page:
- [Why TraderX Was Reworked Around SpecKit](https://traderx.finos.org/docs/spec-kit/why-speckit.md): TraderX was reworked around SpecKit to make multi-state learning paths practical to maintain.