# Feature Pack 004: Containerized Compose Runtime

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

![linux/mac support](https://badgen.net/badge/linux%2Fmac/supported/green?icon=linux) ![windows support](https://badgen.net/badge/windows/not%20supported/red?icon=windows)

Status: Implemented (pending release validation/tag)

This pack defines the next state after `003-agentic-harness-foundation`.

Primary intent:

*   move from process-based local runtime to Docker/Docker Compose orchestration,
*   use NGINX as the containerized ingress layer for browser/API/WebSocket entry,
*   preserve approved functional behavior,
*   document runtime NFR changes explicitly in spec artifacts.

Implemented architecture artifacts:

*   `system/architecture.model.json` + generated `system/architecture.md`
*   `system/runtime-topology.md`
*   `system/docker-compose.spec.yaml`
*   `scripts/start-state-004-containerized-generated.sh`
*   `scripts/test-state-004-containerized.sh`
*   `tests/smoke/README.md`

Runtime lifecycle:

*   default build + start: `./scripts/start-state-004-containerized-generated.sh`
*   restart without image rebuild: `./scripts/start-state-004-containerized-generated.sh --skip-build`
*   PowerShell equivalent is planned for Phase 2: `./scripts/start-state-004-containerized-generated.ps1`