# Learning Paths

> For the complete documentation index, see [llms.txt](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/llms.txt).

This page is generated from `catalog/state-catalog.json`. Green nodes represent convergence checkpoints (C-level milestones such as `[C0]`, `[C1]`, `[C2]`, `[C3]`).

## Convergence-Level Graph

This high-level view shows only the canonical convergence progression from `C0` to `C3`.

Diagram source

```mermaid
flowchart LR
  S004_containerized_compose_runtime["004: Containerized Compose Runtime (NGINX Ingress) [C0]"]
  S007_observability_lgtm_compose["007: Observability with LGTM on Compose [C1]"]
  S009_order_management_matcher["009: Order Management and Matcher [C2]"]
  S012_platform_convergence_c3["012: Platform Convergence C3 [C3]"]
  S004_containerized_compose_runtime --> S007_observability_lgtm_compose
  S007_observability_lgtm_compose --> S009_order_management_matcher
  S009_order_management_matcher --> S012_platform_convergence_c3
  click S004_containerized_compose_runtime href "/specs/containerized-compose-runtime" "Open 004-containerized-compose-runtime"
  click S007_observability_lgtm_compose href "/specs/observability-lgtm-compose" "Open 007-observability-lgtm-compose"
  click S009_order_management_matcher href "/specs/order-management-matcher" "Open 009-order-management-matcher"
  click S012_platform_convergence_c3 href "/specs/platform-convergence-c3" "Open 012-platform-convergence-c3"
  classDef convergence fill:#d7f5dd,stroke:#2e7d32,stroke-width:2px
  class S004_containerized_compose_runtime convergence
  class S007_observability_lgtm_compose convergence
  class S009_order_management_matcher convergence
  class S012_platform_convergence_c3 convergence
```

## Official Current Graph

Diagram source

```mermaid
flowchart TB
  S001_baseline_uncontainerized_parity["001: Simple App - Base Uncontainerized App"]
  S002_edge_proxy_uncontainerized["002: Edge Proxy Uncontainerized"]
  S003_agentic_harness_foundation["003: Agentic Harness Foundation"]
  S004_containerized_compose_runtime["004: Containerized Compose Runtime (NGINX Ingress) [C0]"]
  S005_postgres_database_replacement["005: PostgreSQL Database Replacement"]
  S006_messaging_nats_replacement["006: Messaging Layer Replacement with NATS"]
  S007_observability_lgtm_compose["007: Observability with LGTM on Compose [C1]"]
  S008_pricing_awareness_market_data["008: Pricing Awareness and Market Data Streaming"]
  S009_order_management_matcher["009: Order Management and Matcher [C2]"]
  S010_kubernetes_runtime["010: Kubernetes Runtime on C2"]
  S011_tilt_kubernetes_dev_loop["011: Tilt Local Dev on Kubernetes"]
  S012_platform_convergence_c3["012: Platform Convergence C3 [C3]"]
  S013_radius_kubernetes_platform["013: Radius Platform on Kubernetes (Optional)"]
  S014_fdc3_intent_interoperability["014: FDC3 Intent Interoperability on C3"]
  S001_baseline_uncontainerized_parity --> S002_edge_proxy_uncontainerized
  S002_edge_proxy_uncontainerized --> S003_agentic_harness_foundation
  S003_agentic_harness_foundation --> S004_containerized_compose_runtime
  S004_containerized_compose_runtime --> S005_postgres_database_replacement
  S005_postgres_database_replacement --> S006_messaging_nats_replacement
  S006_messaging_nats_replacement --> S007_observability_lgtm_compose
  S007_observability_lgtm_compose --> S008_pricing_awareness_market_data
  S008_pricing_awareness_market_data --> S009_order_management_matcher
  S009_order_management_matcher --> S010_kubernetes_runtime
  S010_kubernetes_runtime --> S011_tilt_kubernetes_dev_loop
  S011_tilt_kubernetes_dev_loop --> S012_platform_convergence_c3
  S012_platform_convergence_c3 --> S013_radius_kubernetes_platform
  S012_platform_convergence_c3 --> S014_fdc3_intent_interoperability
  S009_order_management_matcher -.-> S012_platform_convergence_c3
  click S001_baseline_uncontainerized_parity href "/specs/baseline-uncontainerized-parity" "Open State 001 Spec Pack"
  click S002_edge_proxy_uncontainerized href "/specs/edge-proxy-uncontainerized" "Open State 002 Spec Pack"
  click S003_agentic_harness_foundation href "/specs/agentic-harness-foundation" "Open State 003 Spec Pack"
  click S004_containerized_compose_runtime href "/specs/containerized-compose-runtime" "Open State 004 Spec Pack"
  click S005_postgres_database_replacement href "/specs/postgres-database-replacement" "Open State 005 Spec Pack"
  click S006_messaging_nats_replacement href "/specs/messaging-nats-replacement" "Open State 006 Spec Pack"
  click S007_observability_lgtm_compose href "/specs/observability-lgtm-compose" "Open State 007 Spec Pack"
  click S008_pricing_awareness_market_data href "/specs/pricing-awareness-market-data" "Open State 008 Spec Pack"
  click S009_order_management_matcher href "/specs/order-management-matcher" "Open State 009 Spec Pack"
  click S010_kubernetes_runtime href "/specs/kubernetes-runtime" "Open State 010 Spec Pack"
  click S011_tilt_kubernetes_dev_loop href "/specs/tilt-kubernetes-dev-loop" "Open State 011 Spec Pack"
  click S012_platform_convergence_c3 href "/specs/platform-convergence-c3" "Open State 012 Spec Pack"
  click S013_radius_kubernetes_platform href "/specs/radius-kubernetes-platform" "Open State 013 Spec Pack"
  click S014_fdc3_intent_interoperability href "/specs/fdc3-intent-interoperability" "Open State 014 Spec Pack"
  classDef convergence fill:#d7f5dd,stroke:#2e7d32,stroke-width:2px
  class S004_containerized_compose_runtime convergence
  class S007_observability_lgtm_compose convergence
  class S009_order_management_matcher convergence
  class S012_platform_convergence_c3 convergence
```

## State To Artifact Mapping

| State | Spec Pack | Architecture | Flows / Runtime Topology | Learning Guide | Generated Code Branch |
| --- | --- | --- | --- | --- | --- |
| [`001-baseline-uncontainerized-parity`](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/baseline-uncontainerized-parity.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/baseline-uncontainerized-parity.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/baseline-uncontainerized-parity/system/architecture.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/baseline-uncontainerized-parity/system/end-to-end-flows.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-001-baseline-uncontainerized-parity.md) | [code/generated-state-001-baseline-uncontainerized-parity](https://github.com/finos/traderX/tree/code/generated-state-001-baseline-uncontainerized-parity) |
| [`002-edge-proxy-uncontainerized`](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/edge-proxy-uncontainerized.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/edge-proxy-uncontainerized.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/edge-proxy-uncontainerized/system/architecture.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/edge-proxy-uncontainerized/system/runtime-topology.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-002-edge-proxy-uncontainerized.md) | [code/generated-state-002-edge-proxy-uncontainerized](https://github.com/finos/traderX/tree/code/generated-state-002-edge-proxy-uncontainerized) |
| [`003-agentic-harness-foundation`](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/agentic-harness-foundation.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/agentic-harness-foundation.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/agentic-harness-foundation/system/architecture.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/agentic-harness-foundation/system/runtime-topology.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-003-agentic-harness-foundation.md) | [code/generated-state-003-agentic-harness-foundation](https://github.com/finos/traderX/tree/code/generated-state-003-agentic-harness-foundation) |
| **[`004-containerized-compose-runtime`](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/containerized-compose-runtime.md)** [(C0)](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/spec-kit/convergence-states.md#c0) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/containerized-compose-runtime.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/containerized-compose-runtime/system/architecture.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/containerized-compose-runtime/system/runtime-topology.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-004-containerized-compose-runtime.md) | [code/generated-state-004-containerized-compose-runtime](https://github.com/finos/traderX/tree/code/generated-state-004-containerized-compose-runtime) |
| [`005-postgres-database-replacement`](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/postgres-database-replacement.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/postgres-database-replacement.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/postgres-database-replacement/system/architecture.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/postgres-database-replacement/system/runtime-topology.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-005-postgres-database-replacement.md) | [code/generated-state-005-postgres-database-replacement](https://github.com/finos/traderX/tree/code/generated-state-005-postgres-database-replacement) |
| [`006-messaging-nats-replacement`](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/messaging-nats-replacement.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/messaging-nats-replacement.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/messaging-nats-replacement/system/architecture.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/messaging-nats-replacement/system/runtime-topology.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-006-messaging-nats-replacement.md) | [code/generated-state-006-messaging-nats-replacement](https://github.com/finos/traderX/tree/code/generated-state-006-messaging-nats-replacement) |
| **[`007-observability-lgtm-compose`](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/observability-lgtm-compose.md)** [(C1)](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/spec-kit/convergence-states.md#c1) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/observability-lgtm-compose.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/observability-lgtm-compose/system/architecture.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/observability-lgtm-compose/system/runtime-topology.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-007-observability-lgtm-compose.md) | [code/generated-state-007-observability-lgtm-compose](https://github.com/finos/traderX/tree/code/generated-state-007-observability-lgtm-compose) |
| [`008-pricing-awareness-market-data`](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/pricing-awareness-market-data.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/pricing-awareness-market-data.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/pricing-awareness-market-data/system/architecture.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/pricing-awareness-market-data/system/runtime-topology.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-008-pricing-awareness-market-data.md) | [code/generated-state-008-pricing-awareness-market-data](https://github.com/finos/traderX/tree/code/generated-state-008-pricing-awareness-market-data) |
| **[`009-order-management-matcher`](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/order-management-matcher.md)** [(C2)](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/spec-kit/convergence-states.md#c2) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/order-management-matcher.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/order-management-matcher/system/architecture.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/order-management-matcher/system/runtime-topology.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-009-order-management-matcher.md) | [code/generated-state-009-order-management-matcher](https://github.com/finos/traderX/tree/code/generated-state-009-order-management-matcher) |
| [`010-kubernetes-runtime`](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/kubernetes-runtime.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/kubernetes-runtime.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/kubernetes-runtime/system/architecture.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/kubernetes-runtime/system/runtime-topology.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-010-kubernetes-runtime.md) | [code/generated-state-010-kubernetes-runtime](https://github.com/finos/traderX/tree/code/generated-state-010-kubernetes-runtime) |
| [`011-tilt-kubernetes-dev-loop`](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/tilt-kubernetes-dev-loop.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/tilt-kubernetes-dev-loop.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/tilt-kubernetes-dev-loop/system/architecture.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/tilt-kubernetes-dev-loop/system/runtime-topology.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-011-tilt-kubernetes-dev-loop.md) | [code/generated-state-011-tilt-kubernetes-dev-loop](https://github.com/finos/traderX/tree/code/generated-state-011-tilt-kubernetes-dev-loop) |
| **[`012-platform-convergence-c3`](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/platform-convergence-c3.md)** [(C3)](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/spec-kit/convergence-states.md#c3) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/platform-convergence-c3.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/platform-convergence-c3/system/architecture.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/platform-convergence-c3/system/runtime-topology.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-012-platform-convergence-c3.md) | [code/generated-state-012-platform-convergence-c3](https://github.com/finos/traderX/tree/code/generated-state-012-platform-convergence-c3) |
| [`013-radius-kubernetes-platform`](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/radius-kubernetes-platform.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/radius-kubernetes-platform.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/radius-kubernetes-platform/system/architecture.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/radius-kubernetes-platform/system/runtime-topology.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-013-radius-kubernetes-platform.md) | [code/generated-state-013-radius-kubernetes-platform](https://github.com/finos/traderX/tree/code/generated-state-013-radius-kubernetes-platform) |
| [`014-fdc3-intent-interoperability`](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/fdc3-intent-interoperability.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/fdc3-intent-interoperability.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/fdc3-intent-interoperability/system/architecture.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/fdc3-intent-interoperability/system/runtime-topology.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-014-fdc3-intent-interoperability.md) | [code/generated-state-014-fdc3-intent-interoperability](https://github.com/finos/traderX/tree/code/generated-state-014-fdc3-intent-interoperability) |

## Swimlane View

Diagram source

```mermaid
flowchart TB
  subgraph PRELUDE["Prelude Track"]
    S001_baseline_uncontainerized_parity["001: Simple App - Base Uncontainerized App"]
    S002_edge_proxy_uncontainerized["002: Edge Proxy Uncontainerized"]
    S003_agentic_harness_foundation["003: Agentic Harness Foundation"]
  end
  subgraph BASELINE["Baseline Track"]
    S004_containerized_compose_runtime["004: Containerized Compose Runtime (NGINX Ingress) [C0]"]
  end
  subgraph ARCHITECTURE["Architecture Track"]
    S005_postgres_database_replacement["005: PostgreSQL Database Replacement"]
    S006_messaging_nats_replacement["006: Messaging Layer Replacement with NATS"]
  end
  subgraph NONFUNCTIONAL["Nonfunctional Track"]
    S007_observability_lgtm_compose["007: Observability with LGTM on Compose [C1]"]
  end
  subgraph FUNCTIONAL["Functional Track"]
    S008_pricing_awareness_market_data["008: Pricing Awareness and Market Data Streaming"]
    S009_order_management_matcher["009: Order Management and Matcher [C2]"]
    S014_fdc3_intent_interoperability["014: FDC3 Intent Interoperability on C3"]
  end
  subgraph DEVEX["Devex Track"]
    S010_kubernetes_runtime["010: Kubernetes Runtime on C2"]
    S011_tilt_kubernetes_dev_loop["011: Tilt Local Dev on Kubernetes"]
    S012_platform_convergence_c3["012: Platform Convergence C3 [C3]"]
    S013_radius_kubernetes_platform["013: Radius Platform on Kubernetes (Optional)"]
  end
  S001_baseline_uncontainerized_parity --> S002_edge_proxy_uncontainerized
  S002_edge_proxy_uncontainerized --> S003_agentic_harness_foundation
  S003_agentic_harness_foundation --> S004_containerized_compose_runtime
  S004_containerized_compose_runtime --> S005_postgres_database_replacement
  S005_postgres_database_replacement --> S006_messaging_nats_replacement
  S006_messaging_nats_replacement --> S007_observability_lgtm_compose
  S007_observability_lgtm_compose --> S008_pricing_awareness_market_data
  S008_pricing_awareness_market_data --> S009_order_management_matcher
  S009_order_management_matcher --> S010_kubernetes_runtime
  S010_kubernetes_runtime --> S011_tilt_kubernetes_dev_loop
  S011_tilt_kubernetes_dev_loop --> S012_platform_convergence_c3
  S012_platform_convergence_c3 --> S013_radius_kubernetes_platform
  S012_platform_convergence_c3 --> S014_fdc3_intent_interoperability
  S009_order_management_matcher -.-> S012_platform_convergence_c3
  classDef convergence fill:#d7f5dd,stroke:#2e7d32,stroke-width:2px
```

Use `catalog/state-catalog.json` as the canonical state lineage record.