Learning Guides

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.

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	link	code/generated-state-001-baseline-uncontainerized-parity	none	none	none	n/a	n/a
002-edge-proxy-uncontainerized	link	link	code/generated-state-002-edge-proxy-uncontainerized	none	none	001-baseline-uncontainerized-parity	link	n/a
003-containerized-compose-runtime	link	link	code/generated-state-003-containerized-compose-runtime	C0	none	002-edge-proxy-uncontainerized	link	n/a
004-postgres-database-replacement	link	link	code/generated-state-004-postgres-database-replacement	none	none	003-containerized-compose-runtime	link	link
005-messaging-nats-replacement	link	link	code/generated-state-005-messaging-nats-replacement	none	none	004-postgres-database-replacement	link	link
006-observability-lgtm-compose	link	link	code/generated-state-006-observability-lgtm-compose	C1	none	005-messaging-nats-replacement	link	link
007-pricing-awareness-market-data	link	link	code/generated-state-007-pricing-awareness-market-data	none	none	006-observability-lgtm-compose	link	n/a
008-order-management-matcher	link	link	code/generated-state-008-order-management-matcher	C2	none	007-pricing-awareness-market-data	link	n/a
009-kubernetes-runtime	link	link	code/generated-state-009-kubernetes-runtime	none	none	008-order-management-matcher	link	n/a
010-tilt-kubernetes-dev-loop	link	link	code/generated-state-010-tilt-kubernetes-dev-loop	none	none	009-kubernetes-runtime	link	n/a
011-platform-convergence-c3	link	link	code/generated-state-011-platform-convergence-c3	C3	008-order-management-matcher	010-tilt-kubernetes-dev-loop	link	link
012-radius-kubernetes-platform	link	link	code/generated-state-012-radius-kubernetes-platform	none	none	009-kubernetes-runtime	link	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

• 003-containerized-compose-runtime (C0): Containerized Compose Runtime (NGINX Ingress)
• 006-observability-lgtm-compose (C1): Observability with LGTM on Compose
• 008-order-management-matcher (C2): Order Management and Matcher
• 011-platform-convergence-c3 (C3): Platform Convergence C3