docs: update project configuration and documentation

- CLAUDE.md: Update project guidelines and i18n instructions
- cspell.json: Add new terms to spelling dictionary
- data/github-stars.json: Update GitHub stats data
- docs/MANIFEST_I18N.md: Update manifest i18n documentation

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

Author: ericyangpan

CLAUDE.md

@@ -28,6 +28,35 @@ When creating or modifying any page, module, or data:
 - **DRY principle for translations:** Before creating new translation keys, search existing translation modules thoroughly to reuse existing terms and phrases
 - **Consistency:** Use the same translation keys across similar contexts
 
+### Translation File Organization
+
+Follow the detailed architecture rules in [docs/I18N-ARCHITECTURE-RULES.md](docs/I18N-ARCHITECTURE-RULES.md) for organizing translation resources.
+
+**Core Principles:**
+1. **Page translations**: Each page or page group should have its own JSON file (e.g., `ides.json`, `ide-detail.json`)
+2. **Component translations**: Organize by component directory:
+   - `components/common.json` - Root-level components (Header, Footer, etc.)
+   - `components/navigation.json` - All navigation/* components
+   - `components/controls.json` - All controls/* components
+   - `components/sidebar.json` - All sidebar/* components
+   - `components/product.json` - All product/* components
+3. **Minimize `@:` references**: Use `tPage + tShared` or `tComponent + tShared` patterns in code instead of cross-namespace references in JSON
+4. **Metadata placement**: Co-locate page metadata (title, description, etc.) with page translations under a `meta` object
+5. **Multi-language workflow**: New translation keys should initially use English placeholders across all locales, with proper translation in a separate batch step
+
+**Usage Pattern:**
+```tsx
+// Pages
+const tPage = useTranslations('pages.modelDetail')
+const tShared = useTranslations('shared')
+
+// Components (root-level)
+const tComponent = useTranslations('components.common.header')
+
+// Components (subdirectories)
+const tComponent = useTranslations('components.navigation.breadcrumb')
+```
+
 ## Design System
 
 **Global Design Principles:**

cspell.json

@@ -98,6 +98,7 @@
     "Kiro",
     "Kode",
     "komutlari",
+    "kullaniminda",
     "Kuik",
     "MMMU",
     "Maks",

data/github-stars.json

@@ -55,6 +55,7 @@
   },
   "models": {
     "composer": null,
+    "deepseek-3-2": null,
     "glm-4-6v": null
   }
 }

docs/MANIFEST_I18N.md

@@ -66,8 +66,8 @@ translations/
 import { useTranslations } from 'next-intl'
 
 export default function MyComponent() {
-  const t = useTranslations('shared')
-  return <h1>{t('welcome')}</h1>
+  const tComponent = useTranslations('shared')
+  return <h1>{tComponent('welcome')}</h1>
 }
 ```
 
@@ -305,8 +305,8 @@ import Link from 'next/link'
 
 ```typescript
 // ✅ Correct
-const t = useTranslations('shared')
-return <button>{t('submit')}</button>
+const tShared = useTranslations('shared')
+return <button>{tShared('submit')}</button>
 
 // ❌ Incorrect
 return <button>Submit</button>