diff --git a/README.md b/README.md
index a69899a..c222e0a 100644
--- a/README.md
+++ b/README.md
@@ -81,17 +81,23 @@ The scaffold's React page hits `/api/v1/health` on load and renders the version
 
 ![Hello page](docs/images/hello-page.png)
 
+### Jaeger trace (`docker compose up` + `/api/v1/health`)
+
+The full stack — backend, frontend, Jaeger collector — boots with `docker compose up`. Hitting `/api/v1/health` once produces an OpenTelemetry trace exported via OTLP/gRPC; the span hierarchy is visible at <http://localhost:16686> under the `harness-python-react` service, with `agent_span(...)` attributes attached using only the keys constant-defined at the top of [`src/observability/spans.py`](src/observability/spans.py).
+
 <!--
-TODO (#28): one capture left — Jaeger trace.
+Screenshot pending: docs/images/jaeger-trace.png
+
+Capture recipe (run once and commit the PNG to docs/images/):
+  1. docker compose up
+  2. curl http://localhost:8000/api/v1/health
+  3. open http://localhost:16686 -> select service "harness-python-react"
+  4. click the most recent trace
+  5. screenshot the span timeline, save as docs/images/jaeger-trace.png
 
-  docs/images/jaeger-trace.png
-    With the full stack running (`docker compose up`), hit /api/v1/health
-    once, then open http://localhost:16686, select service
-    `harness-python-react`, click the most recent trace, screenshot the
-    span timeline.
+When the PNG is committed, replace this whole comment with:
 
-When the PNG lands in docs/images/, replace this comment with a section
-analogous to "Hello page" above.
+    ![Jaeger trace — span timeline for GET /api/v1/health](docs/images/jaeger-trace.png)
 -->
 
 ## Why a harness
diff --git a/pyproject.toml b/pyproject.toml
index 8e2df15..3e2e858 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "harness-python-react"
-version = "0.2.16"
+version = "0.2.17"
 description = "Production-quality LLM-driven coding harness — Python (FastAPI) backend, Vite + React + TypeScript frontend."
 readme = "README.md"
 requires-python = ">=3.14"
diff --git a/uv.lock b/uv.lock
index 8e9e9f8..77c0d17 100644
--- a/uv.lock
+++ b/uv.lock
@@ -337,7 +337,7 @@ wheels = [
 
 [[package]]
 name = "harness-python-react"
-version = "0.2.16"
+version = "0.2.17"
 source = { virtual = "." }
 dependencies = [
     { name = "fastapi" },