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

• 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