Blog Localize

Blog Localize, Cultural Deep-Adaptation

Takes a translated blog post and performs cultural adaptation so the result feels like it was written for the target market, not translated into it. This is the layer above blog-translate: it replaces examples, adjusts tone, swaps references, and localizes the entire reading experience.

Adapted from claude-blog-multilingual by Chris Mueller (Pro Hub Challenge, March 2026). Original: https://github.com/Chriss54/multilingual-int

Key References

• ../blog-translate/references/cultural-adaptation.md, the shared cultural profiles file with substitution tables for DACH, Francophone, Hispanic, Japanese, and a custom template. Do not duplicate this file.

When to Use

• Right after blog-translate produces a base translation.
• When existing translated content reads like "translated from English".
• When targeting a specific market, not just a language.
• When content needs local statistics, examples, and brand references.

Workflow

Phase 1: Locale Understanding

1. Parse the locale code with the shared multilingual locale rules used by blog-translate, blog-multilingual, and blog-locale-audit: ISO 639-1 language in lowercase, optional ISO 15924 script in title case, optional ISO 3166-1 Alpha-2 region in uppercase. Accept full codes (de-DE, fr-CA, es-MX, pt-BR, zh-Hant) and unambiguous plain language codes (de, fr). Require a region or explicit neutral mode for ambiguous language-only targets such as es, pt, and zh.
2. Load the cultural profile from ../blog-translate/references/cultural-adaptation.md.
   • If the locale has a profile, use it.
   • If not, follow the "Custom-locale template" section in that reference to build a minimal profile inline.
3. Read the translated post only after resolving it inside the project root/current working directory. Reject symlinked paths, traversal outside the root, files over 10 MB, and binary files. Then identify adaptation targets.

Phase 2: Cultural Audit

Scan for elements that signal foreign origin:

Output an audit report listing every target with severity (critical, recommended, optional).

Phase 3: Adaptation

3a. Example Substitution

Swap foreign examples for local equivalents:

• Use WebSearch to find local case studies, brands, or scenarios.
• Replace inline, preserving the same argument and structure.
• Record source URL, access date, and rationale for every non-obvious local replacement.
• If no local equivalent exists, keep the original but add local context ("In the German market, the equivalent dynamic is X").

3b. Statistics Localization

• Use primary or high-quality local sources for replacement statistics: national statistics offices, regulators, official industry bodies, academic datasets, or named research reports with methodology.
• Do not rely on generic WebSearch snippets as evidence. Fetch the cited page, verify the figure and context, and record the source URL and date.
• Fetch cited pages only after SSRF checks: allow https URLs only; reject javascript:, data:, file:, localhost, loopback, private, link-local, multicast, and reserved IPs after DNS resolution; disable redirects or validate the final URL with the same checks; cap redirects, response size, and request time; log the final URL and access date.
• If local data exists with comparable methodology, swap the source and the figure together. Keep one named source per claim.
• If local data is related but uses a different methodology or timeframe, do not silently swap it. Keep the original claim scoped, or rewrite the claim to match the local source.
• If not, keep the original stat but mark its geographic scope ("In the US, ...").
• Never strip source attribution.

3c. CTA Adaptation

Rewrite calls-to-action per the cultural profile:

• Adjust aggressiveness level (DACH and JA prefer informational, US prefers imperative).
• Use culturally appropriate action verbs.
• Adapt urgency framing.

3d. Tone Calibration

• Match formality per profile (DACH defaults to Sie for B2B, du for B2C lifestyle; FR defaults to vous; JA shifts register sharply by audience).
• Ensure consistent formal or informal address throughout the entire document.
• Match local content-style conventions.