diff --git a/AGENTS.md b/AGENTS.md
index 9c650a1f7f1..c7841243aca 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -153,6 +153,39 @@ yarn dev:all                   # Include all optional services
 - Single source: `ghost/i18n/locales/{locale}/{namespace}.json`
 - Namespaces: `ghost`, `portal`, `signup-form`, `comments`, `search`
 - 60+ supported locales
+- Context descriptions: `ghost/i18n/locales/context.json` — every key must have a non-empty description
+
+**Translation Workflow:**
+```bash
+yarn workspace @tryghost/i18n translate   # Extract keys from source, update all locale files + context.json
+yarn workspace @tryghost/i18n lint:translations  # Validate interpolation variables across locales
+```
+
+`yarn translate` is run as part of `yarn workspace @tryghost/i18n test`. In CI, it fails if translation keys or `context.json` are out of date (`failOnUpdate: process.env.CI`). Always run `yarn translate` after adding or changing `t()` calls.
+
+**Rules for Translation Keys:**
+1. **Never split sentences across multiple `t()` calls.** Translators cannot reorder words across separate keys. Instead, use `@doist/react-interpolate` to embed React elements (links, bold, etc.) within a single translatable string.
+2. **Always provide context descriptions.** When adding a new key, add a description in `context.json` explaining where the string appears and what it does. CI will reject empty descriptions.
+3. **Use interpolation for dynamic values.** Ghost uses `{variable}` syntax: `t('Welcome back, {name}!', {name: firstname})`
+4. **Use `<tag>` syntax for inline elements.** Combined with `@doist/react-interpolate`: `t('Click <a>here</a> to retry')` with `mapping={{ a: <a href="..." /> }}`
+
+**Correct pattern (using Interpolate):**
+```jsx
+import Interpolate from '@doist/react-interpolate';
+
+<Interpolate
+    mapping={{ a: <a href={link} /> }}
+    string={t('Could not sign in. <a>Click here to retry</a>')}
+/>
+```
+
+**Incorrect pattern (split sentences):**
+```jsx
+// BAD: translators cannot reorder "Click here to retry" relative to the first sentence
+{t('Could not sign in.')} <a href={link}>{t('Click here to retry')}</a>
+```
+
+See `apps/portal/src/components/pages/email-receiving-faq.js` for a canonical example of correct `Interpolate` usage.
 
 ### Build Dependencies (Nx)