# Learning Guides

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

This section is the developer-focused learning layer for generated TraderX code states.

Canonical requirements, contracts, and architecture remain in `specs/**`.  
These guides explain how to read each generated code snapshot, compare it to previous states, and understand the code delta in plain English.

For the visual progression map, see [Visual Learning Paths](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning-paths.md).

## State Guide Catalog

| State | Learning Guide | Spec Pack | Generated Code Branch | Convergence | Dotted Parents | Previous State(s) | Compare To Previous | ADR |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `001-baseline-uncontainerized-parity` | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-001-baseline-uncontainerized-parity.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/baseline-uncontainerized-parity.md) | [code/generated-state-001-baseline-uncontainerized-parity](https://github.com/finos/traderX/tree/code/generated-state-001-baseline-uncontainerized-parity) | `none` | `none` | `none` | `n/a` | `n/a` |
| `002-edge-proxy-uncontainerized` | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-002-edge-proxy-uncontainerized.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/edge-proxy-uncontainerized.md) | [code/generated-state-002-edge-proxy-uncontainerized](https://github.com/finos/traderX/tree/code/generated-state-002-edge-proxy-uncontainerized) | `none` | `none` | [001-baseline-uncontainerized-parity](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-001-baseline-uncontainerized-parity.md) | [link](https://github.com/finos/traderX/compare/code%2Fgenerated-state-001-baseline-uncontainerized-parity...code%2Fgenerated-state-002-edge-proxy-uncontainerized) | `n/a` |
| `003-agentic-harness-foundation` | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-003-agentic-harness-foundation.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/agentic-harness-foundation.md) | [code/generated-state-003-agentic-harness-foundation](https://github.com/finos/traderX/tree/code/generated-state-003-agentic-harness-foundation) | `none` | `none` | [002-edge-proxy-uncontainerized](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-002-edge-proxy-uncontainerized.md) | [link](https://github.com/finos/traderX/compare/code%2Fgenerated-state-002-edge-proxy-uncontainerized...code%2Fgenerated-state-003-agentic-harness-foundation) | `n/a` |
| `004-containerized-compose-runtime` | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-004-containerized-compose-runtime.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/containerized-compose-runtime.md) | [code/generated-state-004-containerized-compose-runtime](https://github.com/finos/traderX/tree/code/generated-state-004-containerized-compose-runtime) | `C0` | `none` | [003-agentic-harness-foundation](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-003-agentic-harness-foundation.md) | [link](https://github.com/finos/traderX/compare/code%2Fgenerated-state-003-agentic-harness-foundation...code%2Fgenerated-state-004-containerized-compose-runtime) | `n/a` |
| `005-postgres-database-replacement` | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-005-postgres-database-replacement.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/postgres-database-replacement.md) | [code/generated-state-005-postgres-database-replacement](https://github.com/finos/traderX/tree/code/generated-state-005-postgres-database-replacement) | `none` | `none` | [004-containerized-compose-runtime](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-004-containerized-compose-runtime.md) | [link](https://github.com/finos/traderX/compare/code%2Fgenerated-state-004-containerized-compose-runtime...code%2Fgenerated-state-005-postgres-database-replacement) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/adr/006-state-005-use-postgres-for-database-replacement.md) |
| `006-messaging-nats-replacement` | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-006-messaging-nats-replacement.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/messaging-nats-replacement.md) | [code/generated-state-006-messaging-nats-replacement](https://github.com/finos/traderX/tree/code/generated-state-006-messaging-nats-replacement) | `none` | `none` | [005-postgres-database-replacement](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-005-postgres-database-replacement.md) | [link](https://github.com/finos/traderX/compare/code%2Fgenerated-state-005-postgres-database-replacement...code%2Fgenerated-state-006-messaging-nats-replacement) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/adr/005-state-006-use-nats-for-messaging-replacement.md) |
| `007-observability-lgtm-compose` | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-007-observability-lgtm-compose.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/observability-lgtm-compose.md) | [code/generated-state-007-observability-lgtm-compose](https://github.com/finos/traderX/tree/code/generated-state-007-observability-lgtm-compose) | `C1` | `none` | [006-messaging-nats-replacement](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-006-messaging-nats-replacement.md) | [link](https://github.com/finos/traderX/compare/code%2Fgenerated-state-006-messaging-nats-replacement...code%2Fgenerated-state-007-observability-lgtm-compose) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/adr/007-state-007-adopt-lgtm-observability-stack.md) |
| `008-pricing-awareness-market-data` | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-008-pricing-awareness-market-data.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/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) | `none` | `none` | [007-observability-lgtm-compose](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-007-observability-lgtm-compose.md) | [link](https://github.com/finos/traderX/compare/code%2Fgenerated-state-007-observability-lgtm-compose...code%2Fgenerated-state-008-pricing-awareness-market-data) | `n/a` |
| `009-order-management-matcher` | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-009-order-management-matcher.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/order-management-matcher.md) | [code/generated-state-009-order-management-matcher](https://github.com/finos/traderX/tree/code/generated-state-009-order-management-matcher) | `C2` | `none` | [008-pricing-awareness-market-data](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-008-pricing-awareness-market-data.md) | [link](https://github.com/finos/traderX/compare/code%2Fgenerated-state-008-pricing-awareness-market-data...code%2Fgenerated-state-009-order-management-matcher) | `n/a` |
| `010-kubernetes-runtime` | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-010-kubernetes-runtime.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/kubernetes-runtime.md) | [code/generated-state-010-kubernetes-runtime](https://github.com/finos/traderX/tree/code/generated-state-010-kubernetes-runtime) | `none` | `none` | [009-order-management-matcher](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-009-order-management-matcher.md) | [link](https://github.com/finos/traderX/compare/code%2Fgenerated-state-009-order-management-matcher...code%2Fgenerated-state-010-kubernetes-runtime) | `n/a` |
| `011-tilt-kubernetes-dev-loop` | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-011-tilt-kubernetes-dev-loop.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/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) | `none` | `none` | [010-kubernetes-runtime](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-010-kubernetes-runtime.md) | [link](https://github.com/finos/traderX/compare/code%2Fgenerated-state-010-kubernetes-runtime...code%2Fgenerated-state-011-tilt-kubernetes-dev-loop) | `n/a` |
| `012-platform-convergence-c3` | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-012-platform-convergence-c3.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/platform-convergence-c3.md) | [code/generated-state-012-platform-convergence-c3](https://github.com/finos/traderX/tree/code/generated-state-012-platform-convergence-c3) | `C3` | [009-order-management-matcher](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-009-order-management-matcher.md) | [011-tilt-kubernetes-dev-loop](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-011-tilt-kubernetes-dev-loop.md) | [link](https://github.com/finos/traderX/compare/code%2Fgenerated-state-011-tilt-kubernetes-dev-loop...code%2Fgenerated-state-012-platform-convergence-c3) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/adr/008-convergence-state-model.md) |
| `013-radius-kubernetes-platform` | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-013-radius-kubernetes-platform.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/radius-kubernetes-platform.md) | [code/generated-state-013-radius-kubernetes-platform](https://github.com/finos/traderX/tree/code/generated-state-013-radius-kubernetes-platform) | `none` | `none` | [012-platform-convergence-c3](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-012-platform-convergence-c3.md) | [link](https://github.com/finos/traderX/compare/code%2Fgenerated-state-012-platform-convergence-c3...code%2Fgenerated-state-013-radius-kubernetes-platform) | `n/a` |
| `014-fdc3-intent-interoperability` | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-014-fdc3-intent-interoperability.md) | [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/fdc3-intent-interoperability.md) | [code/generated-state-014-fdc3-intent-interoperability](https://github.com/finos/traderX/tree/code/generated-state-014-fdc3-intent-interoperability) | `none` | `none` | [012-platform-convergence-c3](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-012-platform-convergence-c3.md) | [link](https://github.com/finos/traderX/compare/code%2Fgenerated-state-012-platform-convergence-c3...code%2Fgenerated-state-014-fdc3-intent-interoperability) | `n/a` |

## How To Use This Section

1.  Open a state guide from this catalog.
2.  Use the GitHub compare link to inspect exact code changes against previous state(s).
3.  Read the plain-English delta for rationale and intent.
4.  Follow links back to spec architecture/flows/contracts when you need system context.

## Recommended Starting Points For New State Design

*   `004-containerized-compose-runtime` (C0): Containerized Compose Runtime (NGINX Ingress)
*   `007-observability-lgtm-compose` (C1): Observability with LGTM on Compose
*   `009-order-management-matcher` (C2): Order Management and Matcher
*   `012-platform-convergence-c3` (C3): Platform Convergence C3