diff --git a/images/code/Containerfile b/images/code/Containerfile
index 891c8a5..9706c28 100644
--- a/images/code/Containerfile
+++ b/images/code/Containerfile
@@ -4,6 +4,7 @@
 # rhdh-plugins monorepo:
 #   - corepack enabled with yarn pre-activated (avoids 10-15 min
 #     bootstrap inside read-only /usr sandbox)
+#   - pwtrace for Playwright trace analysis during E2E failure debugging
 #   - Node.js is already in the base image (installed by Claude Code)
 #
 # Yarn is available on PATH immediately — no runtime corepack setup needed.
@@ -43,6 +44,14 @@ RUN mkdir -p "$COREPACK_HOME" \
     && yarn --version \
     && chmod -R 777 "$COREPACK_HOME"
 
+# ---------------------------------------------------------------------------
+# pwtrace — Playwright trace analysis CLI for E2E failure debugging.
+# Agents use this to inspect browser actions, DOM state, console errors,
+# network requests, and screenshots from failed Playwright test traces.
+# Pinned for reproducible builds; bump manually when a new release is needed.
+RUN npm install -g pwtrace@0.3.0 \
+    && pwtrace --version
+
 # ---------------------------------------------------------------------------
 # openspec CLI — spec-driven development tooling.
 # Used by agents working on repos with openspec/ directories.