Task 001: dockerized monorepo foundation

README.md

@@ -0,0 +1,41 @@
+# AI Content Pipeline
+
+Dockerized monorepo foundation for the AI Content Pipeline.
+
+## Local Development
+
+Start the full stack from the repository root:
+
+```sh
+make dev
+```
+
+Equivalent command:
+
+```sh
+docker compose up --build
+```
+
+The stack exposes:
+
+| Service | URL |
+| --- | --- |
+| Frontend | `http://localhost:3000` |
+| Backend | `http://localhost:8000` |
+| Runner | `http://localhost:8010` |
+| MinIO console | `http://localhost:9001` |
+
+Local-only defaults are documented in `.env.example`. Copy it to `.env` only when
+you need to override local ports or service credentials.
+
+## Health Smoke
+
+Run the public health smoke test:
+
+```sh
+make smoke
+```
+
+The smoke test starts Docker Compose, checks frontend/backend/runner health
+endpoints, and verifies that the backend can connect to Postgres, Redis, and
+S3-compatible object storage.