diff --git a/design_handoff_payment_intelligence_brand/README.md b/design_handoff_payment_intelligence_brand/README.md
new file mode 100644
index 0000000..968e1ce
--- /dev/null
+++ b/design_handoff_payment_intelligence_brand/README.md
@@ -0,0 +1,276 @@
+# Handoff: Payment Intelligence Modules — Brand Restyle (raafetchoukri.com)
+
+## Overview
+
+This is a full visual + UX restyle of the **Payment Intelligence Modules** suite
+(`Raafet57/payment-intelligence-modules`, branch `main`). It rebrands the entire
+browser-only suite to the **raafetchoukri.com** design language, adds a working
+**light/dark theme**, adds a **mobile navigation menu**, removes all **em dashes**
+from copy, and unifies the **sample data** so every tool reflects one coherent
+synthetic payment.
+
+The task for Claude Code is to **port these design changes into the existing
+React/TypeScript app** (Vite + React + TS, pages under `src/pages/`, layout under
+`src/components/layout/`) — using the repo's established patterns — then commit and
+push. Do **not** add the HTML files to the repo as production code.
+
+## About the Design Files
+
+The files in `design/` are **design references created as standalone HTML**
+("Design Components", `*.dc.html`). They are prototypes that show the intended
+look, layout, copy, and behavior. They are **not** to be shipped as-is. Recreate
+them in the repo's existing React/TSX environment and styling system (the repo
+already has `src/index.css` and component/page structure — follow it).
+
+Each `.dc.html` is self-contained: an inline `
+
+
+
+
+
+
+
+
+
+ P1 · Local operational
+
+
+ Session Analytics
+
+
+ Counts, pass-rates, and reason codes across this session. Runs entirely in your
+ browser. Nothing is uploaded.
+
+
+
Back to workbench
+
+
+
+
+
+ Findings by severity
+
+
+
+
+ {{ s.label }}
+
+ {{ s.value }}
+
+
+
+
+ Pass rate: 78% across 28 findings
+ in 5 analyses.
+
+
+
+
+
+ By module
+
+
+
+
+ {{ m.module }}
+ {{ m.detail }}
+
+
+
+
+ Top reason codes
+
+
+
+
+ {{ r.code }}
+ {{ r.count }}
+
+
+
+
+
+
+
+
+
+
+ Local analytics only
+
+
+
+ -
+ Computed from this session or synthetic scenarios only.
+
+ -
+ No telemetry, no remote analytics, nothing is uploaded.
+
+ -
+ Not a fleet metric; there is no shared backend.
+
+
+
+
+
+
+
+
+
+