# MERXI AI Agent Toolkit

Version 1.0 · Brand site 2.2.0 · Updated 2026-09-04

This is the portable instruction contract for design, image, localization,
chart, and QA agents working on MERXI. The living copy-and-use version is
available at `https://brand.merxi.com/ai`.

## Non-negotiables

- Use the official Azure Wave-M or horizontal Azure lockup SVG. Never redraw,
  recolor, distort, or ask an image model to invent the logo. For campaign use,
  the user-approved direction 04 blue gold orange SVG masters are available
  at `/brand/logo/v1.2/svg/`; use them unchanged. Solid Azure remains the primary.
- Light Mode first: Cloud `#FCFAF4`, Azure `#145BFF`, Cobalt `#0A3FB8`, Gold
  `#D79B18`, Orange `#FF6A1A`, and Aqua `#11BED0` only for verified Live.
- Use Geist for Latin UI and editorial copy, MiSans for Simplified Chinese,
  MiSans TC for Traditional Chinese, Pretendard for Korean, and IBM Plex Sans
  Condensed for changing data.
- Use the 4 px base grid, 8 px rhythm, 20 px mobile gutter, and 44 px minimum
  hit area. Keep one primary action per viewport.
- Keep copy in sentence case. Use tabular lining figures for odds, probability,
  scores, time, balances, payout, and P&L.

## Chinese heading and line-breaking contract

- Set `lang="zh-CN"` and `line-break: strict` at the content boundary.
- Store Chinese copy naturally; do not insert a hard-coded `<br>` in headings.
- Default to one line whenever the measured container fits. Allow a balanced
  two-line heading only when the content no longer fits, normally at 320–430 px
  mobile widths or when a heading exceeds its defined measure.
- Keep punctuation out of the start of a line: `，。！？；：、` and closing
  brackets must remain with the preceding phrase.
- Keep product names, numbers, asset codes and units together. Chinese never
  inherits Latin uppercase treatment or expanded tracking.
- Validate at 320, 360, 390, 430, 768, and 1440 CSS px plus 200% zoom.

## Data language

- Decimal odds: `1.86` (always two decimals).
- Probability: `64.0%` (one decimal).
- Movement: `+3.2 pp` and show both endpoints when useful.
- Score: `2–1` with competition and game-state context.
- Asset-coded amount: `100.00 USDT`.
- Time: `14:32 UTC` when ambiguity is possible.

## Prompt templates

Use the copyable prompts at `https://brand.merxi.com/ai`. Replace bracketed
inputs, then return the requested information architecture, copy, data
semantics, responsive behavior, states, accessibility notes, and editable
production layers. ImageGen is allowed to create atmosphere and background
direction only; the approved SVG and all text/data are composited separately.

### UI / Web / App

> Design a bright, production-ready MERXI interface for `[surface]`. Use the
> official Azure Wave-M SVG, Cloud canvas, Azure structure, Cobalt depth, Gold
> value, Orange event energy, Aqua verified Live only, Geist / MiSans /
> MiSans TC / Pretendard by locale, and IBM Plex Sans Condensed for data. Use
> the 4 px grid, 8 px rhythm, 20 px mobile gutter, 44 px hit area, sentence
> case, tabular figures, explicit source/update time and semantic loading,
> empty, error and suspended states. Return editable layers and an exact data
> table beside decision-critical charts. Do not add generated logos, dark
> casino clichés, ornamental rings, glow, blur, or fake claims.

### Social / Main KV

> Create a Light Mode MERXI Main KV for `[objective]` in `[format]`. Generate
> atmosphere only, reserve a logo and copy safe area, and overlay the official
> Azure Wave-M / MERXI SVG exactly. Use one message, one proof point, one
> action; show verified context, update time, and required responsible-play
> copy. Avoid burgundy, black-heavy environments, neon, chandeliers, roulette,
> ornamental circles, glow, blur, rainbow gradients, distorted marks, and
> watermarks. Return crop-safe zones for 16:9 / 1:1 / 4:5 / 9:16, copy slots,
> data slots, disclosure placement, and alt text.

### Charts

> Specify a MERXI chart for `[customer / Admin / marketing]` and question
> `[question]`. Choose probability 0–100% for prediction markets, discrete
> decimal odds for Sportsbook, operational risk/revenue/settlement grammar for
> Admin, or one sourced proof point for marketing. Include units, source,
> timezone, freshness, loading, empty, error and suspended states; use Azure,
> Cobalt, Gold, Orange and verified Live Aqua by role; pair color with labels,
> arrows or icons; and return an accessible exact-value table.

### Simplified Chinese localization

> Localize `[surface]` into professional Simplified Chinese using MiSans
> 400/500/600 for narrative and interface text and IBM Plex Sans Condensed for
> data. Noto Sans is not the primary Chinese family. Set `lang="zh-CN"`; use
> strict line breaking; never hard-code heading breaks; default to one line;
> allow a balanced two-line fallback only when the measured container cannot
> fit; keep punctuation, names, numbers, and asset codes intact. Return copy,
> character counts, recommended wraps at 320/360/390/430 px, numeric format,
> and translator notes.

### Audit / QA

> Audit `[URL / screen / component]` against MERXI. Report evidence for exact
> SVG logo use, Light Mode hierarchy, role-based fonts, MiSans Chinese
> authority, content-driven wrapping, odds/probability/score/asset formats,
> 4 px / 8 px spacing, responsive widths, 200% zoom, keyboard/focus/contrast,
> reduced motion, copyable source, and editable layers. Return severity,
> location, before/after recommendation, and ship/fix verdict. Do not invent
> issues without evidence.

## Rejection criteria

Reject or regenerate when the output contains an alternate or malformed logo,
black-heavy or burgundy casino styling, unsupported claims, unreadable small
copy, a Chinese punctuation orphan, Noto Sans as the primary Simplified Chinese
family, unlabelled financial data, missing source/update time, or non-editable
production text/data.