القائمة
Verify translation dictionaries are in parity across all locales for a package, and flag hardcoded locale strings in code that matches against translated text. Enforces the CLAUDE.md rule "never add a key to one dictionary without adding it to all others".
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Audit changed TherrMobile files for the React Native failure classes that crash at runtime rather than at build time — native modules touched at import time, missing effect cleanup, unguarded navigation params and API responses, and system-bar/safe-area regressions. Fixes the safe ones, reports the rest, then verifies with the mobile tsc baseline and Jest.
Verify the full wiring matrix when a TherrMobile dependency is added, upgraded, or removed — which package.json owns it, Metro resolution and singleton blocking, Babel and tsconfig aliases, Jest mocks and transform patterns, patch-package version drift, and whether a native rebuild or pod install is required. Catches the module-resolution failures that only surface at runtime on device.
Go/no-go gate before cutting an Android or iOS build of a Therr mobile app. Verifies brand and branch agree, versionCode/versionName were bumped, patch-package patches match installed versions, no deprecated Android 15 APIs are referenced, locales are in parity, and the tsc baseline, lint, and Jest suites are green — then checks Play release notes and records post-release follow-ups.
Peer review the diff between general and stage branches. Implements low-risk improvements, fixes bugs, adds regression tests for bugfixes where valuable, resolves quality issues, and notes deployment steps. Runs local integration tests when the diff touches backend services (requires Docker Compose infrastructure for that case only).
Generate Knex migration files in the correct service and schema per docs/NICHE_APP_DATABASE_GUIDELINES.md. Enforces schema isolation (main.* core, habits.* / <niche>.* for niche features), correct naming convention, and up/down symmetry. Prevents the highest-cost mistake class in the backend — putting niche-specific tables on the main schema.
Check whether recent commits have made the root CLAUDE.md, docs/README.md, or key docs stale — new packages not listed, changed build commands, dependency version drift, new brand variants, or product changes that invalidate documented strategy. Run deliberately after a batch of work or before a release, not on every session.
| name | i18n-sync |
| description | Verify translation dictionaries are in parity across all locales for a package, and flag hardcoded locale strings in code that matches against translated text. Enforces the CLAUDE.md rule "never add a key to one dictionary without adding it to all others". |
Enforce translation dictionary parity across locales. The codebase supports 3 locales (en-us, es, fr-ca) in every i18n-capable package. CLAUDE.md mandates: "never add a key to one dictionary without adding it to all others in that package." This skill catches divergence and optionally scaffolds missing keys.
| Package | Dictionary paths |
|---|---|
therr-client-web (frontend) | therr-client-web/src/locales/{en-us,es,fr-ca}/dictionary.json |
TherrMobile (frontend) | TherrMobile/main/locales/{en-us,es,fr-ca}/dictionary.json |
therr-services/users-service (backend — in-app notifications) | therr-services/users-service/src/locales/{en-us,es,fr-ca}/dictionary.json |
therr-services/push-notifications-service (backend — push) | therr-services/push-notifications-service/src/locales/{en-us,es,fr-ca}/dictionary.json |
Note: push-notifications-service may only ship en-us and fr-ca today — check before reporting es as missing.
| Argument | Mode |
|---|---|
check or (no argument) | Compare dictionaries, report missing/extra keys per package |
scaffold | Insert stub entries (copied from en-us, prefixed with [ES] / [FR]) for missing keys |
--package <name> | Limit to a single package (see map above) |
--changed-only | Only check packages whose dictionary.json files appear in git diff HEAD |
--fix-stubs | With check: also audit translated values that still contain the [ES]/[FR] stub prefix |
--package <name> → just that package.--changed-only → git diff --name-only HEAD and any git status --short paths, filter to paths containing /locales/ and dictionary.json; derive packages.Use jq to extract keys (including nested) from each locale's dictionary.json:
jq -r 'paths(scalars) | map(tostring) | join(".")' <file> | sort
Use en-us as the source of truth. For each other locale in the package:
en-us but absent in the other locale.en-us (may indicate a renamed key or a stale entry).Check TherrMobile/main/routes/Notifications/Notification.tsx — specifically getHighlightValues() — for string literals that look like English notification text. If a new key was added to therr-services/users-service/src/locales/en-us/dictionary.json that maps to a notification the client highlights, the matcher needs all three locale variants of the substring, not just English.
Grep pattern to find candidate sites:
grep -n "'you'\|'your '\|'invited'\|'accepted'" TherrMobile/main/routes/Notifications/Notification.tsx
Flag every hardcoded English phrase and remind the developer to mirror it in es and fr-ca using the translated values from the backend locale dictionaries.
If all packages are in parity:
✓ i18n sync passed — 4 package(s), 12 dictionaries, all in parity
If divergence is detected:
⚠ i18n drift detected
therr-client-web
Missing in es/dictionary.json (2):
onboarding.welcome.title
onboarding.welcome.body
Missing in fr-ca/dictionary.json (1):
onboarding.welcome.body
Extra in es/dictionary.json (1):
onboarding.old_title ← possible stale key or rename
TherrMobile
✓ in parity
therr-services/users-service
Missing in fr-ca/dictionary.json (3):
notifications.pactInvite.title
notifications.pactInvite.body
notifications.pactInvite.cta
Hardcoded English matches in TherrMobile/main/routes/Notifications/Notification.tsx:
Line 142: "'invited you'" — needs es ("te invitó") and fr-ca ("t'a invité") variants
See therr-services/users-service/src/locales/<locale>/dictionary.json for translated values.
Fix: run `/i18n-sync scaffold` to stub missing keys, then replace stubs with real translations.
Use after check reports missing keys. For each missing key in a locale:
en-us/dictionary.json."[ES] <english value>" or "[FR] <english value>".Use Edit with replace_all: false to add each key in context, or rewrite the file with Write if multiple keys need insertion in structured locations. Do NOT insert into push-notifications-service es/ if it doesn't exist — report that as a structural decision needing human input.
After scaffolding, print:
Scaffolded 5 stub translations. Replace [ES] / [FR] prefixes with real translations before merging.
Stubs written:
therr-client-web/src/locales/es/dictionary.json: 2 keys
therr-client-web/src/locales/fr-ca/dictionary.json: 1 key
therr-services/users-service/src/locales/fr-ca/dictionary.json: 3 keys - 1 existing = 2 keys
When run with --fix-stubs, additionally scan for values that still start with [ES] or [FR] — these are untranslated stubs from a previous scaffold. Report them so they can be translated before release.
en-us as canonical. If keys are only in es or fr-ca, surface them as drift — do not add them to en-us automatically.index.ts exports unless the dictionary format requires it.scaffold mode) writes dictionary JSON. It does not commit.