# State Docs

> 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` and links the most important per-state artifacts.

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

## State Catalog

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

## API Explorer by State

*   Runtime API explorer route: `/api/docs`
*   Current scope: `001-baseline-uncontainerized-parity`
*   Source contracts: `specs/001-baseline-uncontainerized-parity/contracts/**/openapi.yaml`
*   Runtime metadata source: `catalog/state-catalog.json` → `apiCatalog`

## How This Page Is Maintained

*   Source catalog: `catalog/state-catalog.json`
*   Regenerate docs pages:

```bash
bash pipeline/refresh-state-docs.sh
```

*   State architecture docs are generated from:
    *   `specs/<state>/system/architecture.model.json`
*   Generate state architecture docs:

```bash
bash pipeline/generate-state-architecture-doc.sh <state-id>
```

*   Generate all state architecture docs:

```bash
bash pipeline/generate-all-architecture-docs.sh
```
