refactor: migrate i18n directory from messages/ to locales/

Rename the messages/ directory to locales/ to better align with
Next.js internationalization conventions and improve clarity.

- Rename messages/*.json to locales/*.json (en, de, ko, zh-Hans)
- Update i18n skill documentation to reflect new directory structure
- Update sync and translate scripts to use locales/ path
- Update i18n request configuration to import from locales/
- Update all locale file structures for consistency
- Add language names to cspell dictionary

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: ericyangpan

.claude/skills/i18n/SKILL.md

@@ -5,14 +5,14 @@ description: Internationalization management tool for syncing and translating la
 
 # I18n Management Skill
 
-Manage multilingual content in the `messages/` directory. This skill provides tools to synchronize language files with the English reference and assist with translations.
+Manage multilingual content in the `locales/` directory. This skill provides tools to synchronize language files with the English reference and assist with translations.
 
 ## Overview
 
-This project uses `next-intl` for internationalization with JSON message files stored in `messages/`:
+This project uses `next-intl` for internationalization with JSON message files stored in `locales/`:
 
-- `messages/en.json` - English (source of truth)
-- `messages/zh-Hans.json` - Simplified Chinese
+- `locales/en.json` - English (source of truth)
+- `locales/zh-Hans.json` - Simplified Chinese
 - Additional language files can be added
 
 All language files must maintain the same nested key structure as `en.json`.
@@ -25,7 +25,7 @@ Synchronize all language files with `en.json` as the source of truth.
 
 **What it does:**
 
-- Scans all `.json` files in `messages/` directory
+- Scans all `.json` files in `locales/` directory
 - Compares each file's keys with `en.json`
 - **Adds missing keys** with English text as placeholder (needs translation)
 - **Removes extra keys** not present in `en.json`
@@ -195,7 +195,7 @@ export const locales = ['en', 'zh-Hans', 'ja'] as const; // Add 'ja'
 2. Create an empty JSON file or copy `en.json`:
 
 ```bash
-cp messages/en.json messages/ja.json
+cp locales/en.json locales/ja.json
 ```
 
 3. Run sync to ensure structure matches:
@@ -224,7 +224,7 @@ Please run the i18n translate command for ja
 **Problem:** Script says "file not found"
 
 - **Solution:** Ensure you're running from project root
-- Check that `messages/` directory exists
+- Check that `locales/` directory exists
 
 **Problem:** Keys are out of sync after adding new content
 
@@ -245,7 +245,7 @@ This skill is designed to work with the project's `next-intl` setup:
 ```typescript
 // src/i18n/request.ts
 export default getRequestConfig(async ({ locale }) => ({
-  messages: (await import(`../../messages/${locale}.json`)).default,
+  messages: (await import(`../../locales/${locale}.json`)).default,
 }));
 ```
 

.claude/skills/i18n/scripts/sync.mjs

@@ -4,8 +4,8 @@
  * Sync all language files with en.json as source of truth
  *
  * This script:
- * 1. Reads messages/en.json as the reference
- * 2. Scans all other .json files in messages/
+ * 1. Reads locales/en.json as the reference
+ * 2. Scans all other .json files in locales/
  * 3. Adds missing keys (with English text as placeholder)
  * 4. Removes extra keys not present in en.json
  * 5. Preserves JSON structure and formatting
@@ -30,8 +30,8 @@ const colors = {
 
 // Get project root (4 levels up from .claude/skills/i18n/scripts/)
 const PROJECT_ROOT = path.resolve(__dirname, '../../../../')
-const MESSAGES_DIR = path.join(PROJECT_ROOT, 'messages')
-const EN_FILE = path.join(MESSAGES_DIR, 'en.json')
+const LOCALES_DIR = path.join(PROJECT_ROOT, 'locales')
+const EN_FILE = path.join(LOCALES_DIR, 'en.json')
 
 /**
  * Recursively get all keys from a nested object
@@ -103,6 +103,68 @@ function deleteValueByPath(obj, path) {
   }
 }
 
+/**
+ * Recursively rebuild object with same structure and order as reference
+ * @param {Object} reference - The reference object (en.json)
+ * @param {Object} target - The target object to sync
+ * @param {Array} added - Array to track added keys
+ * @param {Array} removed - Array to track removed keys
+ * @param {string} prefix - Current key path prefix
+ * @returns {Object} Rebuilt object with same structure as reference
+ */
+function rebuildWithSameOrder(reference, target, added, removed, prefix = '') {
+  const result = {}
+
+  // Iterate through reference keys in order
+  for (const [key, refValue] of Object.entries(reference)) {
+    const fullKey = prefix ? `${prefix}.${key}` : key
+
+    if (refValue !== null && typeof refValue === 'object' && !Array.isArray(refValue)) {
+      // It's a nested object
+      if (
+        key in target &&
+        typeof target[key] === 'object' &&
+        target[key] !== null &&
+        !Array.isArray(target[key])
+      ) {
+        // Recursively rebuild nested object
+        result[key] = rebuildWithSameOrder(refValue, target[key], added, removed, fullKey)
+      } else {
+        // Missing nested object, use reference structure
+        result[key] = rebuildWithSameOrder(refValue, {}, added, removed, fullKey)
+        // Track all leaf keys as added
+        const leafKeys = getAllKeys(refValue, fullKey)
+        added.push(...leafKeys)
+      }
+    } else {
+      // It's a leaf value
+      if (key in target) {
+        // Use target's translation
+        result[key] = target[key]
+      } else {
+        // Missing key, use English as placeholder
+        result[key] = refValue
+        added.push(fullKey)
+      }
+    }
+  }
+
+  // Track removed keys (keys in target but not in reference)
+  for (const key in target) {
+    const fullKey = prefix ? `${prefix}.${key}` : key
+    if (!(key in reference)) {
+      if (typeof target[key] === 'object' && target[key] !== null && !Array.isArray(target[key])) {
+        const leafKeys = getAllKeys(target[key], fullKey)
+        removed.push(...leafKeys)
+      } else {
+        removed.push(fullKey)
+      }
+    }
+  }
+
+  return result
+}
+
 /**
  * Sync a target language file with the English reference
  * @param {string} targetFile - Path to the target language file
@@ -111,33 +173,15 @@ function deleteValueByPath(obj, path) {
  */
 function syncLanguageFile(targetFile, enData) {
   const targetData = JSON.parse(fs.readFileSync(targetFile, 'utf-8'))
-  const enKeys = getAllKeys(enData)
-  const targetKeys = getAllKeys(targetData)
 
   const added = []
   const removed = []
 
-  // Add missing keys from en.json
-  for (const key of enKeys) {
-    if (!targetKeys.includes(key)) {
-      const enValue = getValueByPath(enData, key)
-      setValueByPath(targetData, key, enValue)
-      added.push(key)
-    }
-  }
-
-  // Remove extra keys not in en.json
-  for (const key of targetKeys) {
-    if (!enKeys.includes(key)) {
-      deleteValueByPath(targetData, key)
-      removed.push(key)
-    }
-  }
+  // Rebuild target with same structure and order as en.json
+  const syncedData = rebuildWithSameOrder(enData, targetData, added, removed)
 
-  // Write back with consistent formatting (2 spaces indentation)
-  if (added.length > 0 || removed.length > 0) {
-    fs.writeFileSync(targetFile, `${JSON.stringify(targetData, null, 2)}\n`, 'utf-8')
-  }
+  // Always write to ensure correct order
+  fs.writeFileSync(targetFile, `${JSON.stringify(syncedData, null, 2)}\n`, 'utf-8')
 
   return { added, removed }
 }
@@ -148,9 +192,9 @@ function syncLanguageFile(targetFile, enData) {
 function main() {
   console.log(`${colors.cyan}🔄 Syncing language files with en.json...${colors.reset}\n`)
 
-  // Check if messages directory exists
-  if (!fs.existsSync(MESSAGES_DIR)) {
-    console.error(`${colors.red}✗ Messages directory not found: ${MESSAGES_DIR}${colors.reset}`)
+  // Check if locales directory exists
+  if (!fs.existsSync(LOCALES_DIR)) {
+    console.error(`${colors.red}✗ Locales directory not found: ${LOCALES_DIR}${colors.reset}`)
     process.exit(1)
   }
 
@@ -164,9 +208,9 @@ function main() {
 
   // Get all language files except en.json
   const files = fs
-    .readdirSync(MESSAGES_DIR)
+    .readdirSync(LOCALES_DIR)
     .filter(file => file.endsWith('.json') && file !== 'en.json')
-    .map(file => path.join(MESSAGES_DIR, file))
+    .map(file => path.join(LOCALES_DIR, file))
 
   if (files.length === 0) {
     console.log(`${colors.yellow}⚠ No other language files found to sync${colors.reset}`)

.claude/skills/i18n/scripts/translate.mjs

@@ -4,7 +4,7 @@
  * Translate language file with Claude Code assistance
  *
  * This script:
- * 1. Reads messages/en.json and messages/<locale>.json
+ * 1. Reads locales/en.json and locales/<locale>.json
  * 2. Identifies keys that need translation (currently in English)
  * 3. Outputs translation tasks for Claude Code to perform
  * 4. Reads translated content from stdin
@@ -31,8 +31,8 @@ const colors = {
 
 // Get project root (4 levels up from .claude/skills/i18n/scripts/)
 const PROJECT_ROOT = path.resolve(__dirname, '../../../../')
-const MESSAGES_DIR = path.join(PROJECT_ROOT, 'messages')
-const EN_FILE = path.join(MESSAGES_DIR, 'en.json')
+const LOCALES_DIR = path.join(PROJECT_ROOT, 'locales')
+const EN_FILE = path.join(LOCALES_DIR, 'en.json')
 
 // Locale display names
 const LOCALE_NAMES = {
@@ -228,7 +228,7 @@ function main() {
     process.exit(1)
   }
 
-  const targetFile = path.join(MESSAGES_DIR, `${locale}.json`)
+  const targetFile = path.join(LOCALES_DIR, `${locale}.json`)
 
   console.log(`${colors.cyan}🌐 Translation Assistant for ${locale}${colors.reset}\n`)
 

cspell.json

@@ -20,18 +20,22 @@
     "CLIs",
     "cmdk",
     "Entwicklungsworkflows",
+    "Español",
+    "Français",
     "hrefs",
     "Integrationen",
     "Junie",
     "Kimi",
     "Kiro",
     "Kode",
     "Neovate",
+    "Português",
     "Qoder",
     "QoderCLI",
     "Qwen",
     "RLHF",
     "Roo",
+    "Русский",
     "shareAI",
     "TRAE"
   ],

messages/de.json locales/de.jsonmessages/de.json renamed to locales/de.json

@@ -1,13 +1,14 @@
 {
+  "common": {
+    "comparison": "Comparison"
+  },
   "stacks": {
-    "aiCodingStack": "AI Coding Stack",
     "ides": "IDEs",
     "clis": "CLIs",
     "extensions": "Erweiterungen",
     "models": "Modelle",
     "modelProviders": "Modellanbieter",
-    "vendors": "Anbieter",
-    "comparison": "Vergleich"
+    "vendors": "Anbieter"
   },
   "community": {
     "github": "GitHub",
@@ -21,19 +22,13 @@
     "openrouter": "OpenRouter"
   },
   "header": {
-    "docs": "Dokumentation",
-    "articles": "Artikel",
-    "curatedCollections": "Kuratierte Sammlungen",
-    "comparison": "Vergleich",
-    "features": "Funktionen",
-    "manifesto": "Manifest",
     "aiCodingStack": "AI Coding Stack",
-    "collections": "Sammlungen",
+    "manifesto": "Manifest",
     "landscape": "Landschaft",
-    "aiCodingLandscape": "KI-Coding-Landschaft",
-    "aiCodingLandscapeDesc": "Visualisieren Sie das gesamte KI-Coding-Ökosystem",
+    "ranking": "Ranking",
     "openSourceRank": "Open Source Ranking",
     "openSourceRankDesc": "Erkunden Sie Open-Source-KI-Coding-Projekte nach GitHub-Sternen",
+    "collections": "Sammlungen",
     "developmentTools": "Entwicklungstools",
     "intelligence": "Intelligenz",
     "toggleMenu": "Menü umschalten",
@@ -42,6 +37,22 @@
     "search": "Suchen",
     "searchPlaceholder": "Suchen..."
   },
+  "footer": {
+    "tagline": "Ihr KI-Coding-Ökosystem-Hub.",
+    "openSource": "Open-Source-KI-Coding-Metadaten-Repository.",
+    "resources": "Ressourcen",
+    "documentation": "Dokumentation",
+    "docs": "Docs",
+    "articles": "Articles",
+    "curatedCollections": "Curated Collections",
+    "faq": "FAQ",
+    "community": "Community",
+    "copyright": "© 2025 AI Coding Stack • Mit ❤︎ erstellt • Open Source",
+    "darkMode": "Dunkelmodus",
+    "lightMode": "Hellmodus",
+    "selectLanguage": "Sprache auswählen",
+    "toggleTheme": "Thema umschalten"
+  },
   "search": {
     "title": "Suchergebnisse",
     "placeholder": "KI-Coding-Tools durchsuchen...",
@@ -61,20 +72,6 @@
       "vendors": "Anbieter"
     }
   },
-  "footer": {
-    "aicodingstack": "AI Coding Stack",
-    "tagline": "Ihr KI-Coding-Ökosystem-Hub.",
-    "openSource": "Open-Source-KI-Coding-Metadaten-Repository.",
-    "resources": "Ressourcen",
-    "documentation": "Dokumentation",
-    "community": "Community",
-    "copyright": "© 2025 AI Coding Stack • Mit ❤︎ erstellt • Open Source",
-    "darkMode": "Dunkelmodus",
-    "lightMode": "Hellmodus",
-    "faq": "FAQ",
-    "selectLanguage": "Sprache auswählen",
-    "toggleTheme": "Thema umschalten"
-  },
   "pages": {
     "home": {
       "meta": {
@@ -410,11 +407,6 @@
       "articles": "Featured Artikel",
       "tools": "Ökosystem-Tools"
     },
-    "stackSidebar": {
-      "title": "STACKS",
-      "label": "AI Coding Stack",
-      "overview": "Übersicht"
-    },
     "filterSortBar": {
       "search": "Nach Namen suchen...",
       "sort": "Sortieren:",