claudeos-core 1.2.4 → 1.3.1

package/README.ko.md

@@ -107,9 +107,44 @@ npx claudeos-core init
 
 # 방법 D: git clone (개발/기여용)
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+
+# 크로스 플랫폼 (PowerShell, CMD, Bash, Zsh — 모든 터미널)
+node claudeos-core-tools/bin/cli.js init
+
+# Linux/macOS 전용 (Bash만)
 bash claudeos-core-tools/bootstrap.sh
 ```
 
+### 출력 언어 (10개 언어 지원)
+
+`--lang` 없이 `init`을 실행하면 화살표 키로 언어를 선택하는 인터랙티브 화면이 나타납니다:
+
+```
+╔══════════════════════════════════════════════════╗
+║  Select generated document language (required)   ║
+╚══════════════════════════════════════════════════╝
+
+  생성되는 파일(CLAUDE.md, Standards, Rules,
+  Skills, Guides)이 한국어로 작성됩니다.
+
+     1. en     — English
+  ❯  2. ko     — 한국어 (Korean)
+     3. zh-CN  — 简体中文 (Chinese Simplified)
+     ...
+
+  ↑↓ Move  ↵ Select
+```
+
+화살표 이동 시 설명이 해당 언어로 바뀝니다. 선택 화면을 건너뛰려면 `--lang`을 직접 지정하세요:
+
+```bash
+npx claudeos-core init --lang ko    # 한국어
+npx claudeos-core init --lang en    # English
+npx claudeos-core init --lang ja    # 日本語
+```
+
+> **참고:** 이 설정은 생성되는 문서 파일의 언어만 변경합니다. 코드 분석(Pass 1–2)은 항상 영어로 실행되며, 생성 결과(Pass 3)만 선택한 언어로 작성됩니다. 코드 예시는 원래 프로그래밍 언어 구문 그대로 유지됩니다.
+
 이게 전부입니다. 5–18분 후 모든 문서가 생성되어 바로 사용 가능합니다.
 
 ### 수동 단계별 설치
@@ -171,12 +206,12 @@ cat claudeos-core/generated/domain-groups.json | node -e "
 "
 
 # Run Pass 1 for group 1:
-cat claudeos-core/generated/pass1-backend-prompt.md \
-  | sed "s/{{DOMAIN_GROUP}}/user, order, product/g" \
-  | sed "s/{{PASS_NUM}}/1/g" \
-  | claude -p --dangerously-skip-permissions
+cp claudeos-core/generated/pass1-backend-prompt.md /tmp/_pass1.md
+DOMAIN_LIST="user, order, product" PASS_NUM=1 \
+  perl -pi -e 's/\{\{DOMAIN_GROUP\}\}/$ENV{DOMAIN_LIST}/g; s/\{\{PASS_NUM\}\}/$ENV{PASS_NUM}/g' /tmp/_pass1.md
+cat /tmp/_pass1.md | claude -p --dangerously-skip-permissions
 
-# For frontend groups, use pass1-frontend-prompt.md instead
+# 프론트엔드 그룹은 pass1-frontend-prompt.md를 사용하세요
 ```
 
 **확인:** `ls claudeos-core/generated/pass1-*.json`으로 그룹당 하나의 JSON이 있는지 확인합니다.
@@ -218,7 +253,7 @@ node claudeos-core-tools/pass-json-validator/index.js   # JSON format
 #### Step 8: 결과 확인
 
 ```bash
-find .claude claudeos-core -type f | grep -v node_modules | wc -l
+find .claude claudeos-core -type f | grep -v node_modules | grep -v '/generated/' | wc -l
 head -30 CLAUDE.md
 ls .claude/rules/*/
 ```
@@ -370,16 +405,21 @@ ClaudeOS-Core가 생성한 문서를 Claude Code가 실제로 읽는 방식입
 | 파일 | 시점 | 보장 |
 |---|---|---|
 | `CLAUDE.md` | 매 대화 시작 시 | 항상 |
-| `.claude/rules/*.md` | 파일 편집 시 (`paths: ["**/*"]`) | 항상 |
-| `.claude/rules/00.core/00.standard-reference.md` | ↑ 위에 포함 | 항상 |
+| `.claude/rules/00.core/*` | 파일 편집 시 (`paths: ["**/*"]`) | 항상 |
+| `.claude/rules/10.backend/*` | 파일 편집 시 (`paths: ["**/*"]`) | 항상 |
+| `.claude/rules/30.security-db/*` | 파일 편집 시 (`paths: ["**/*"]`) | 항상 |
+| `.claude/rules/40.infra/*` | config/infra 파일 편집 시만 (스코핑된 paths) | 조건부 |
+| `.claude/rules/50.sync/*` | claudeos-core 파일 편집 시만 (스코핑된 paths) | 조건부 |
 
-### standard-reference 규칙을 통해 읽는 파일
+### rule 참조를 통해 온디맨드로 읽는 파일
 
-`00.standard-reference.md` 규칙이 Claude Code에게 코드 작성 전 아래 문서를 Read하도록 지시합니다:
+각 rule 파일 하단의 `## Reference` 섹션이 대응하는 standard를 링크합니다. Claude는 현재 작업과 관련된 standard만 읽습니다:
 
 - `claudeos-core/standard/**` — 코딩 패턴, ✅/❌ 예시, 네이밍 규칙
 - `claudeos-core/database/**` — DB 스키마 (쿼리, 매퍼, 마이그레이션용)
 
+`00.standard-reference.md`는 대응 rule이 없는 standard를 발견하기 위한 디렉토리 역할입니다.
+
 ### 읽지 않는 파일 (컨텍스트 절약)
 
 standard-reference 규칙의 `DO NOT Read` 섹션으로 명시적으로 제외됩니다:
@@ -439,6 +479,7 @@ npx claudeos-core restore
 | **프로젝트 특화 출력** | ✅ 모든 파일이 실제 패턴 반영 | ❌ 제네릭 명령어 | 부분적 | ❌ 획일적 |
 | **멀티스택** | ✅ 자동 감지 + 별도 분석 | ❌ 스택 무관 | 수동 | 다양 |
 | **Kotlin + CQRS/BFF** | ✅ 멀티모듈, Command/Query 분리 | ❌ | ❌ | ❌ |
+| **다국어 지원** | ✅ 10개 언어, 인터랙티브 선택 | ❌ | ❌ | ❌ |
 | **자체 검증** | ✅ 5개 검증 도구 | ❌ | ❌ | ❌ |
 | **백업 / 복원** | ✅ Master Plan 시스템 | ❌ | ❌ | ❌ |
 | **설정 시간** | ~5–18분 (자동화) | ~5분 (수동 설정) | 수 시간–며칠 | ~5분 |

package/README.md

@@ -105,9 +105,50 @@ npx claudeos-core init
 
 # Option D: git clone (for development/contribution)
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+
+# Cross-platform (PowerShell, CMD, Bash, Zsh — any terminal)
+node claudeos-core-tools/bin/cli.js init
+
+# Linux/macOS (Bash only)
 bash claudeos-core-tools/bootstrap.sh
 ```
 
+### Output Language (10 languages)
+
+When you run `init` without `--lang`, an interactive selector appears — use arrow keys to choose:
+
+```
+╔══════════════════════════════════════════════════╗
+║  Select generated document language (required)   ║
+╚══════════════════════════════════════════════════╝
+
+  Generated files (CLAUDE.md, Standards, Rules,
+  Skills, Guides) will be written in English.
+
+  ❯  1. en     — English
+     2. ko     — 한국어 (Korean)
+     3. zh-CN  — 简体中文 (Chinese Simplified)
+     4. ja     — 日本語 (Japanese)
+     5. es     — Español (Spanish)
+     6. vi     — Tiếng Việt (Vietnamese)
+     7. hi     — हिन्दी (Hindi)
+     8. ru     — Русский (Russian)
+     9. fr     — Français (French)
+    10. de     — Deutsch (German)
+
+  ↑↓ Move  ↵ Select
+```
+
+The description changes to the selected language as you navigate. To skip the selector, pass `--lang` directly:
+
+```bash
+npx claudeos-core init --lang ko    # Korean
+npx claudeos-core init --lang ja    # Japanese
+npx claudeos-core init --lang en    # English (default)
+```
+
+> **Note:** This sets the language for generated documentation files only. Code analysis (Pass 1–2) always runs in English; generated output (Pass 3) is written in your chosen language. Code examples inside the generated files remain in their original programming language syntax.
+
 That's it. After 5–18 minutes, all documentation is generated and ready to use.
 
 ### Manual Step-by-Step Installation
@@ -168,18 +209,18 @@ cat claudeos-core/generated/domain-groups.json | node -e "
   g.groups.forEach((g,i) => console.log('Group '+(i+1)+': ['+g.domains.join(', ')+'] ('+g.type+', ~'+g.estimatedFiles+' files)'));
 "
 
-# Run Pass 1 for each group (replace N with group number)
+# Run Pass 1 for each group (replace domains and group number)
 # For group 1:
-cat claudeos-core/generated/pass1-backend-prompt.md \
-  | sed "s/{{DOMAIN_GROUP}}/user, order, product/g" \
-  | sed "s/{{PASS_NUM}}/1/g" \
-  | claude -p --dangerously-skip-permissions
+cp claudeos-core/generated/pass1-backend-prompt.md /tmp/_pass1.md
+DOMAIN_LIST="user, order, product" PASS_NUM=1 \
+  perl -pi -e 's/\{\{DOMAIN_GROUP\}\}/$ENV{DOMAIN_LIST}/g; s/\{\{PASS_NUM\}\}/$ENV{PASS_NUM}/g' /tmp/_pass1.md
+cat /tmp/_pass1.md | claude -p --dangerously-skip-permissions
 
 # For group 2 (if exists):
-cat claudeos-core/generated/pass1-backend-prompt.md \
-  | sed "s/{{DOMAIN_GROUP}}/payment, system, delivery/g" \
-  | sed "s/{{PASS_NUM}}/2/g" \
-  | claude -p --dangerously-skip-permissions
+cp claudeos-core/generated/pass1-backend-prompt.md /tmp/_pass1.md
+DOMAIN_LIST="payment, system, delivery" PASS_NUM=2 \
+  perl -pi -e 's/\{\{DOMAIN_GROUP\}\}/$ENV{DOMAIN_LIST}/g; s/\{\{PASS_NUM\}\}/$ENV{PASS_NUM}/g' /tmp/_pass1.md
+cat /tmp/_pass1.md | claude -p --dangerously-skip-permissions
 
 # For frontend groups, use pass1-frontend-prompt.md instead
 ```
@@ -224,7 +265,7 @@ node claudeos-core-tools/pass-json-validator/index.js   # Pass JSON format check
 
 ```bash
 # Count generated files
-find .claude claudeos-core -type f | grep -v node_modules | wc -l
+find .claude claudeos-core -type f | grep -v node_modules | grep -v '/generated/' | wc -l
 
 # Check CLAUDE.md
 head -30 CLAUDE.md
@@ -383,16 +424,21 @@ ClaudeOS-Core generates documentation that Claude Code actually reads — here's
 | File | When | Guaranteed |
 |---|---|---|
 | `CLAUDE.md` | Every conversation start | Always |
-| `.claude/rules/*.md` | When any file is edited (via `paths: ["**/*"]`) | Always |
-| `.claude/rules/00.core/00.standard-reference.md` | ↑ Included above | Always |
+| `.claude/rules/00.core/*` | When any file is edited (`paths: ["**/*"]`) | Always |
+| `.claude/rules/10.backend/*` | When any file is edited (`paths: ["**/*"]`) | Always |
+| `.claude/rules/30.security-db/*` | When any file is edited (`paths: ["**/*"]`) | Always |
+| `.claude/rules/40.infra/*` | Only when editing config/infra files (scoped paths) | Conditional |
+| `.claude/rules/50.sync/*` | Only when editing claudeos-core files (scoped paths) | Conditional |
 
-### What Claude Code reads via standard-reference rule
+### What Claude Code reads on-demand via rule references
 
-The `00.standard-reference.md` rule instructs Claude Code to Read the standard documents before writing code:
+Each rule file links to its corresponding standard via a `## Reference` section. Claude reads only the relevant standard for the current task:
 
 - `claudeos-core/standard/**` — coding patterns, ✅/❌ examples, naming conventions
 - `claudeos-core/database/**` — DB schema (for queries, mappers, migrations)
 
+The `00.standard-reference.md` serves as a directory of all standard files for discovering standards that have no corresponding rule.
+
 ### What Claude Code does NOT read (saves context)
 
 These folders are explicitly excluded via the `DO NOT Read` section in the standard-reference rule:
@@ -452,6 +498,7 @@ npx claudeos-core restore
 | **Project-specific output** | ✅ Every file reflects your patterns | ❌ Generic commands | Partially | ❌ One-size-fits-all |
 | **Multi-stack** | ✅ Auto-detected + separate analysis | ❌ Stack-agnostic | Manual | Varies |
 | **Kotlin + CQRS/BFF** | ✅ Multi-module, Command/Query split | ❌ | ❌ | ❌ |
+| **Multi-language** | ✅ 10 languages, interactive selector | ❌ | ❌ | ❌ |
 | **Self-verifying** | ✅ 5 validation tools | ❌ | ❌ | ❌ |
 | **Backup / Restore** | ✅ Master Plan system | ❌ | ❌ | ❌ |
 | **Setup time** | ~5–18min (automated) | ~5min (manual config) | Hours–Days | ~5min |
@@ -560,7 +607,7 @@ Contributions are welcome! Areas where help is most needed:
 
 - **New stack templates** — Ruby/Rails, Go/Gin, PHP/Laravel, Rust/Axum
 - **Monorepo deep support** — Separate sub-project roots, workspace detection
-- **Test coverage** — Unit tests for all verification tools
+- **Test coverage** — Expanding test suite (currently 57 tests covering stack detection, domain grouping, plan validation, and structure scanning)
 
 ---
 

package/README.ru.md

@@ -107,9 +107,44 @@ npx claudeos-core init
 
 # Вариант D: git clone (для разработки/контрибуции)
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+
+# Кроссплатформенный (PowerShell, CMD, Bash, Zsh — любой терминал)
+node claudeos-core-tools/bin/cli.js init
+
+# Только Linux/macOS (только Bash)
 bash claudeos-core-tools/bootstrap.sh
 ```
 
+### Язык вывода (10 языков)
+
+При запуске `init` без `--lang` появляется интерактивный селектор со стрелками:
+
+```
+╔══════════════════════════════════════════════════╗
+║  Select generated document language (required)   ║
+╚══════════════════════════════════════════════════╝
+
+  Сгенерированные файлы (CLAUDE.md, Standards, Rules,
+  Skills, Guides) будут написаны на русском языке.
+
+     1. en     — English
+     ...
+  ❯  8. ru     — Русский (Russian)
+     ...
+
+  ↑↓ Move  ↵ Select
+```
+
+При навигации описание переключается на соответствующий язык. Чтобы пропустить селектор:
+
+```bash
+npx claudeos-core init --lang ru    # Русский
+npx claudeos-core init --lang en    # English
+npx claudeos-core init --lang ko    # 한국어
+```
+
+> **Примечание:** Эта настройка изменяет только язык генерируемых файлов документации. Анализ кода (Pass 1–2) всегда выполняется на английском; только результат генерации (Pass 3) пишется на выбранном языке.
+
 Это всё. Через 5–18 минут вся документация сгенерирована и готова к использованию.
 
 ### Ручная пошаговая установка
@@ -171,12 +206,12 @@ cat claudeos-core/generated/domain-groups.json | node -e "
 "
 
 # Run Pass 1 for group 1:
-cat claudeos-core/generated/pass1-backend-prompt.md \
-  | sed "s/{{DOMAIN_GROUP}}/user, order, product/g" \
-  | sed "s/{{PASS_NUM}}/1/g" \
-  | claude -p --dangerously-skip-permissions
+cp claudeos-core/generated/pass1-backend-prompt.md /tmp/_pass1.md
+DOMAIN_LIST="user, order, product" PASS_NUM=1 \
+  perl -pi -e 's/\{\{DOMAIN_GROUP\}\}/$ENV{DOMAIN_LIST}/g; s/\{\{PASS_NUM\}\}/$ENV{PASS_NUM}/g' /tmp/_pass1.md
+cat /tmp/_pass1.md | claude -p --dangerously-skip-permissions
 
-# For frontend groups, use pass1-frontend-prompt.md instead
+# Для фронтенд-групп используйте pass1-frontend-prompt.md
 ```
 
 **Проверка:** `ls claudeos-core/generated/pass1-*.json` должен показать по одному JSON на группу.
@@ -218,7 +253,7 @@ node claudeos-core-tools/pass-json-validator/index.js   # JSON format
 #### Step 8: Проверка результатов
 
 ```bash
-find .claude claudeos-core -type f | grep -v node_modules | wc -l
+find .claude claudeos-core -type f | grep -v node_modules | grep -v '/generated/' | wc -l
 head -30 CLAUDE.md
 ls .claude/rules/*/
 ```
@@ -352,16 +387,21 @@ npx claudeos-core restore      # Восстановление Plan → Диск
 | Файл | Когда | Гарантия |
 |---|---|---|
 | `CLAUDE.md` | При начале каждого разговора | Всегда |
-| `.claude/rules/*.md` | При редактировании файлов (через `paths: ["**/*"]`) | Всегда |
-| `.claude/rules/00.core/00.standard-reference.md` | ↑ Включено выше | Всегда |
+| `.claude/rules/00.core/*` | При редактировании файлов (`paths: ["**/*"]`) | Всегда |
+| `.claude/rules/10.backend/*` | При редактировании файлов (`paths: ["**/*"]`) | Всегда |
+| `.claude/rules/30.security-db/*` | При редактировании файлов (`paths: ["**/*"]`) | Всегда |
+| `.claude/rules/40.infra/*` | Только при редактировании config/infra файлов (ограниченные paths) | Условно |
+| `.claude/rules/50.sync/*` | Только при редактировании claudeos-core файлов (ограниченные paths) | Условно |
 
-### Файлы, читаемые через правило standard-reference
+### Файлы, читаемые по запросу через ссылки в правилах
 
-Правило `00.standard-reference.md` указывает Claude Code Read стандартные документы перед написанием кода:
+Каждый файл правил ссылается на соответствующий standard в секции `## Reference`. Claude читает только standard, релевантный текущей задаче:
 
 - `claudeos-core/standard/**` — Паттерны кодирования, примеры ✅/❌, соглашения об именах
 - `claudeos-core/database/**` — Схема БД (для запросов, мапперов, миграций)
 
+`00.standard-reference.md` служит каталогом для обнаружения standards без соответствующего правила.
+
 ### Файлы, которые НЕ читаются (экономия контекста)
 
 Явно исключены через секцию `DO NOT Read` правила standard-reference:
@@ -421,6 +461,7 @@ npx claudeos-core restore
 | **Вывод под проект** | ✅ Каждый файл отражает ваши паттерны | ❌ Универсальные команды | Частично | ❌ Один размер для всех |
 | **Мульти-стек** | ✅ Автоопределение + раздельный анализ | ❌ Стек-агностик | Вручную | Неопределённо |
 | **Kotlin + CQRS/BFF** | ✅ Мультимодульный, разделение Command/Query | ❌ | ❌ | ❌ |
+| **Многоязычность** | ✅ 10 языков, интерактивный выбор | ❌ | ❌ | ❌ |
 | **Самопроверка** | ✅ 5 инструментов валидации | ❌ | ❌ | ❌ |
 | **Бэкап / Восстановление** | ✅ Система Master Plan | ❌ | ❌ | ❌ |
 | **Время настройки** | ~5–18 мин (автоматически) | ~5 мин (ручная настройка) | Часы–Дни | ~5 мин |

package/README.vi.md

@@ -107,9 +107,44 @@ npx claudeos-core init
 
 # Cách D: git clone (cho phát triển/đóng góp)
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+
+# Đa nền tảng (PowerShell, CMD, Bash, Zsh — mọi terminal)
+node claudeos-core-tools/bin/cli.js init
+
+# Chỉ Linux/macOS (chỉ Bash)
 bash claudeos-core-tools/bootstrap.sh
 ```
 
+### Ngôn ngữ đầu ra (10 ngôn ngữ)
+
+Khi chạy `init` không có `--lang`, bộ chọn tương tác bằng phím mũi tên sẽ xuất hiện:
+
+```
+╔══════════════════════════════════════════════════╗
+║  Select generated document language (required)   ║
+╚══════════════════════════════════════════════════╝
+
+  Các file được tạo (CLAUDE.md, Standards, Rules,
+  Skills, Guides) sẽ được viết bằng tiếng Việt.
+
+     1. en     — English
+     ...
+  ❯  6. vi     — Tiếng Việt (Vietnamese)
+     ...
+
+  ↑↓ Move  ↵ Select
+```
+
+Mô tả thay đổi sang ngôn ngữ tương ứng khi di chuyển. Bỏ qua bộ chọn:
+
+```bash
+npx claudeos-core init --lang vi    # Tiếng Việt
+npx claudeos-core init --lang en    # English
+npx claudeos-core init --lang ko    # 한국어
+```
+
+> **Lưu ý:** Chỉ thay đổi ngôn ngữ của file tài liệu được tạo. Phân tích mã (Pass 1–2) luôn chạy bằng tiếng Anh; chỉ kết quả tạo (Pass 3) được viết bằng ngôn ngữ đã chọn.
+
 Chỉ vậy thôi. Sau 5–18 phút, tất cả tài liệu được tạo và sẵn sàng sử dụng.
 
 ### Cài Đặt Thủ Công Từng Bước
@@ -171,12 +206,12 @@ cat claudeos-core/generated/domain-groups.json | node -e "
 "
 
 # Run Pass 1 for group 1:
-cat claudeos-core/generated/pass1-backend-prompt.md \
-  | sed "s/{{DOMAIN_GROUP}}/user, order, product/g" \
-  | sed "s/{{PASS_NUM}}/1/g" \
-  | claude -p --dangerously-skip-permissions
+cp claudeos-core/generated/pass1-backend-prompt.md /tmp/_pass1.md
+DOMAIN_LIST="user, order, product" PASS_NUM=1 \
+  perl -pi -e 's/\{\{DOMAIN_GROUP\}\}/$ENV{DOMAIN_LIST}/g; s/\{\{PASS_NUM\}\}/$ENV{PASS_NUM}/g' /tmp/_pass1.md
+cat /tmp/_pass1.md | claude -p --dangerously-skip-permissions
 
-# For frontend groups, use pass1-frontend-prompt.md instead
+# Đối với nhóm frontend, sử dụng pass1-frontend-prompt.md
 ```
 
 **Xác minh:** `ls claudeos-core/generated/pass1-*.json` phải hiển thị một JSON cho mỗi nhóm.
@@ -218,7 +253,7 @@ node claudeos-core-tools/pass-json-validator/index.js   # JSON format
 #### Step 8: Xác minh kết quả
 
 ```bash
-find .claude claudeos-core -type f | grep -v node_modules | wc -l
+find .claude claudeos-core -type f | grep -v node_modules | grep -v '/generated/' | wc -l
 head -30 CLAUDE.md
 ls .claude/rules/*/
 ```
@@ -352,16 +387,21 @@ npx claudeos-core restore      # Khôi phục Plan → Đĩa
 | File | Thời điểm | Đảm bảo |
 |---|---|---|
 | `CLAUDE.md` | Mỗi lần bắt đầu cuộc trò chuyện | Luôn luôn |
-| `.claude/rules/*.md` | Khi chỉnh sửa file (qua `paths: ["**/*"]`) | Luôn luôn |
-| `.claude/rules/00.core/00.standard-reference.md` | ↑ Bao gồm ở trên | Luôn luôn |
+| `.claude/rules/00.core/*` | Khi chỉnh sửa file (`paths: ["**/*"]`) | Luôn luôn |
+| `.claude/rules/10.backend/*` | Khi chỉnh sửa file (`paths: ["**/*"]`) | Luôn luôn |
+| `.claude/rules/30.security-db/*` | Khi chỉnh sửa file (`paths: ["**/*"]`) | Luôn luôn |
+| `.claude/rules/40.infra/*` | Chỉ khi chỉnh sửa file config/infra (paths giới hạn) | Có điều kiện |
+| `.claude/rules/50.sync/*` | Chỉ khi chỉnh sửa file claudeos-core (paths giới hạn) | Có điều kiện |
 
-### File được đọc qua quy tắc standard-reference
+### File được đọc theo yêu cầu qua tham chiếu trong quy tắc
 
-Quy tắc `00.standard-reference.md` hướng dẫn Claude Code Read tài liệu standard trước khi viết code:
+Mỗi file quy tắc liên kết đến standard tương ứng trong phần `## Reference`. Claude chỉ đọc standard liên quan đến tác vụ hiện tại:
 
 - `claudeos-core/standard/**` — Pattern coding, ví dụ ✅/❌, quy tắc đặt tên
 - `claudeos-core/database/**` — DB schema (cho query, mapper, migration)
 
+`00.standard-reference.md` đóng vai trò thư mục để khám phá các standard không có quy tắc tương ứng.
+
 ### File KHÔNG đọc (tiết kiệm context)
 
 Được loại trừ rõ ràng qua phần `DO NOT Read` của quy tắc standard-reference:
@@ -421,6 +461,7 @@ npx claudeos-core restore
 | **Đầu ra riêng dự án** | ✅ Mọi file phản ánh pattern của bạn | ❌ Lệnh chung | Một phần | ❌ Một cỡ cho tất cả |
 | **Multi-stack** | ✅ Tự phát hiện + phân tích riêng | ❌ Không phân biệt stack | Thủ công | Không chắc |
 | **Kotlin + CQRS/BFF** | ✅ Multi-module, Command/Query split | ❌ | ❌ | ❌ |
+| **Đa ngôn ngữ** | ✅ 10 ngôn ngữ, bộ chọn tương tác | ❌ | ❌ | ❌ |
 | **Tự xác thực** | ✅ 5 công cụ validation | ❌ | ❌ | ❌ |
 | **Backup / Khôi phục** | ✅ Hệ thống Master Plan | ❌ | ❌ | ❌ |
 | **Thời gian cài đặt** | ~5–18 phút (tự động) | ~5 phút (cấu hình thủ công) | Hàng giờ–ngày | ~5 phút |

package/README.zh-CN.md

@@ -107,9 +107,44 @@ npx claudeos-core init
 
 # 方式 D：git clone（用于开发/贡献）
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+
+# 跨平台（PowerShell、CMD、Bash、Zsh — 任何终端）
+node claudeos-core-tools/bin/cli.js init
+
+# 仅 Linux/macOS（仅 Bash）
 bash claudeos-core-tools/bootstrap.sh
 ```
 
+### 输出语言（支持 10 种语言）
+
+不带 `--lang` 运行 `init` 时，会显示箭头键交互选择器：
+
+```
+╔══════════════════════════════════════════════════╗
+║  Select generated document language (required)   ║
+╚══════════════════════════════════════════════════╝
+
+  生成的文件（CLAUDE.md、Standards、Rules、
+  Skills、Guides）将以简体中文编写。
+
+     1. en     — English
+     2. ko     — 한국어 (Korean)
+  ❯  3. zh-CN  — 简体中文 (Chinese Simplified)
+     ...
+
+  ↑↓ Move  ↵ Select
+```
+
+移动箭头时说明会切换为对应语言。跳过选择器直接指定：
+
+```bash
+npx claudeos-core init --lang zh-CN  # 简体中文
+npx claudeos-core init --lang en     # English
+npx claudeos-core init --lang ko     # 한국어
+```
+
+> **注意：** 此设置仅更改生成文档的语言。代码分析（Pass 1–2）始终以英文运行，仅生成结果（Pass 3）以所选语言编写。代码示例保持原始编程语言语法。
+
 就这样。5–18 分钟后，所有文档生成完毕，即可使用。
 
 ### 手动逐步安装
@@ -171,12 +206,12 @@ cat claudeos-core/generated/domain-groups.json | node -e "
 "
 
 # Run Pass 1 for group 1:
-cat claudeos-core/generated/pass1-backend-prompt.md \
-  | sed "s/{{DOMAIN_GROUP}}/user, order, product/g" \
-  | sed "s/{{PASS_NUM}}/1/g" \
-  | claude -p --dangerously-skip-permissions
+cp claudeos-core/generated/pass1-backend-prompt.md /tmp/_pass1.md
+DOMAIN_LIST="user, order, product" PASS_NUM=1 \
+  perl -pi -e 's/\{\{DOMAIN_GROUP\}\}/$ENV{DOMAIN_LIST}/g; s/\{\{PASS_NUM\}\}/$ENV{PASS_NUM}/g' /tmp/_pass1.md
+cat /tmp/_pass1.md | claude -p --dangerously-skip-permissions
 
-# For frontend groups, use pass1-frontend-prompt.md instead
+# 前端分组请使用 pass1-frontend-prompt.md
 ```
 
 **验证：** `ls claudeos-core/generated/pass1-*.json` 应显示每组一个 JSON。
@@ -218,7 +253,7 @@ node claudeos-core-tools/pass-json-validator/index.js   # JSON format
 #### Step 8：验证结果
 
 ```bash
-find .claude claudeos-core -type f | grep -v node_modules | wc -l
+find .claude claudeos-core -type f | grep -v node_modules | grep -v '/generated/' | wc -l
 head -30 CLAUDE.md
 ls .claude/rules/*/
 ```
@@ -352,16 +387,21 @@ ClaudeOS-Core 生成的文档，Claude Code 实际读取方式如下：
 | 文件 | 时机 | 保证 |
 |---|---|---|
 | `CLAUDE.md` | 每次对话开始 | 始终 |
-| `.claude/rules/*.md` | 编辑文件时（通过 `paths: ["**/*"]`） | 始终 |
-| `.claude/rules/00.core/00.standard-reference.md` | ↑ 包含在上面 | 始终 |
+| `.claude/rules/00.core/*` | 编辑文件时（`paths: ["**/*"]`） | 始终 |
+| `.claude/rules/10.backend/*` | 编辑文件时（`paths: ["**/*"]`） | 始终 |
+| `.claude/rules/30.security-db/*` | 编辑文件时（`paths: ["**/*"]`） | 始终 |
+| `.claude/rules/40.infra/*` | 仅编辑 config/infra 文件时（范围限定 paths） | 有条件 |
+| `.claude/rules/50.sync/*` | 仅编辑 claudeos-core 文件时（范围限定 paths） | 有条件 |
 
-### 通过 standard-reference 规则读取的文件
+### 通过规则引用按需读取的文件
 
-`00.standard-reference.md` 规则指示 Claude Code 在编写代码前 Read 以下文档：
+每个规则文件底部的 `## Reference` 部分链接到对应的 standard。Claude 仅读取与当前任务相关的 standard：
 
 - `claudeos-core/standard/**` — 编码模式、✅/❌ 示例、命名规范
 - `claudeos-core/database/**` — 数据库 schema（查询、mapper、迁移用）
 
+`00.standard-reference.md` 作为目录，用于发现没有对应规则的 standard 文件。
+
 ### 不读取的文件（节省上下文）
 
 通过 standard-reference 规则的 `DO NOT Read` 部分明确排除：
@@ -421,6 +461,7 @@ npx claudeos-core restore
 | **项目定制输出** | ✅ 每个文件反映你的模式 | ❌ 通用命令 | 部分 | ❌ 一刀切 |
 | **多栈支持** | ✅ 自动检测 + 分别分析 | ❌ 栈无关 | 手动 | 不一定 |
 | **Kotlin + CQRS/BFF** | ✅ 多模块, Command/Query 分离 | ❌ | ❌ | ❌ |
+| **多语言** | ✅ 10 种语言，交互式选择 | ❌ | ❌ | ❌ |
 | **自验证** | ✅ 5 个验证工具 | ❌ | ❌ | ❌ |
 | **备份 / 恢复** | ✅ Master Plan 系统 | ❌ | ❌ | ❌ |
 | **配置时间** | ~5–18分钟（自动） | ~5分钟（手动配置） | 数小时–数天 | ~5分钟 |