claudeos-core 1.2.3 → 1.3.0

package/CHANGELOG.md

@@ -1,6 +1,71 @@
 # Changelog
 
-## [1.2.3] — 2026-04-03
+## [1.3.0] — 2026-04-03
+
+### Added
+- **`lib/safe-fs.js`** — Shared safe filesystem utilities (readFileSafe, readJsonSafe, existsSafe, ensureDir, writeFileSafe, statSafe)
+- **plan-installer modularization** — Split into 4 sub-modules: stack-detector, structure-scanner, domain-grouper, prompt-generator
+- **57 unit tests** across 4 test files: stack-detector (16), domain-grouper (12), plan-validator (11), structure-scanner (4)
+- **Pass 3 CRITICAL directives** (all 6 stacks) — Package Manager/Build Tool Consistency, Cross-file Consistency (rules vs standards), CLAUDE.md Reference Table Completeness
+- **Pass 1/2 EXACT capture** (all 6 stacks) — Exact import paths, component entry file patterns, styling utility imports, UI library package names, custom response wrapper method signatures
+- **bootstrap.sh prerequisite checks** — Node.js v18+, Claude CLI, perl existence validation before execution
+- **bootstrap.sh EXIT trap** — Automatic temp file cleanup on Ctrl+C, errors, or normal exit
+- **plan-validator mode validation** — Rejects unknown modes (only --check/--refresh/--execute)
+- **plan-validator stale-report.json integration** — Results now included in consolidated health report
+- **sync-checker mappings guard** — Validates `sm.mappings` array exists before processing
+
+### Changed
+- **`plan-validator` extractCodeBlocks** — Rewritten from regex to indexOf-based parser with nested code fence depth tracking (fixes false drift reports on files containing ``` blocks)
+- **`plan-validator` replaceCodeBlock** — Rewritten fence detection: `[a-zA-Z]` language tag check instead of heuristic `trim().length > 0`; fixed off-by-one in searchPos that missed consecutive fences
+- **`plan-validator` module.exports** — Now exports functions for testing; uses `require.main === module` guard
+- **`plan-validator` content comparison** — `trimEnd()` → `replace(/\n+$/, "")` (normalize trailing newlines only, preserve trailing spaces)
+- **Path traversal checks** — `startsWith(ROOT)` → `startsWith(ROOT + path.sep)` in plan-validator and sync-checker (prevents sibling directory bypass)
+- **`stack-detector` h2 detection** — `includes("h2")` → `/\bh2\b/` word boundary in Gradle, Maven, and YAML (prevents oauth2/http2/cache2k false positives)
+- **`stack-detector` regex fix** — `[^'")\\s]` → `[^'")\s]` in spring-boot-dependencies version pattern
+- **`stack-detector` version extraction** — TypeScript and engines.node now use `match(/(\d+(?:\.\d+)*)/)` instead of `replace(/[^0-9.]/g, "")` (correctly handles range specifiers like `>=5.0 <6`)
+- **`stack-detector` application*.yml ignore** — Added `**/build/**`, `**/target/**`, `**/.gradle/**` to prevent scanning build output
+- **`stack-detector` vite.config fallback** — Removed redundant inner `!stack.frontend` check
+- **`structure-scanner` [param] filter** — Next.js dynamic route directories (`[id]`, `[slug]`, `[...catchAll]`) excluded from frontend domains
+- **`structure-scanner` lib prefix fix** — `startsWith(libName)` → `startsWith(libName + "/")` (prevents prefix overlap between shared-lib and shared-lib-utils)
+- **`structure-scanner` -lib no-op removed** — `.replace(/-lib$/, "-lib")` (did nothing) removed
+- **`structure-scanner` FastAPI fallback** — `app/*/` → `{app,src/app}/*/` for broader project structure support
+- **`structure-scanner` Windows glob fix** — Added trailing slash normalization and backslash-to-forward-slash conversion for glob patterns from Windows glob results
+- **`domain-grouper` pre-check** — Flush current group *before* adding domain if it would exceed MAX_FILES_PER_GROUP (prevents group overshoot)
+- **`domain-grouper` isBackend** — Simplified from `!!stack.framework && !["nextjs","react","vue"].includes(stack.framework)` to `!!stack.framework` (frontend values are in `stack.frontend`, not `stack.framework`)
+- **`prompt-generator` type detection** — Index-based type assignment prevents misclassification when backend and frontend use same template
+- **`prompt-generator` data.fetch regex** — `data.fetch` → `data[.\-]fetch` (escaped regex dot)
+- **`prompt-generator` m flag** — Removed unnecessary `m` flag from footer-stripping regex
+- **`content-validator` table detection** — `!c.includes("|")` → `/\|.+\|.+\|/` markdown table pattern (previous check was always passing)
+- **`content-validator` section keywords** — `includes()` → regex with word boundary `(^|#|\\s)` (prevents "running" matching "Run")
+- **`health-checker` summary key** — `summary.status` → `summary.healthStatus` (avoids overwriting sync-checker's `status` key)
+- **`manifest-generator` stale-report** — Merge-based init instead of overwrite; `totalIssues`/`status` reset to 0/"initial" each run
+- **`cli.js` totalGroups validation** — Validates type, range, and existence before entering Pass 1 loop
+- **`cli.js` pass1 JSON integrity** — Checks `analysisPerDomain` key exists before skipping; re-runs malformed files
+- **`cli.js` pass2/pass3 prompt guard** — Validates prompt file exists with friendly error before reading
+- **`cli.js` Windows path normalization** — `injectProjectRoot` converts backslashes to forward slashes for Claude prompts
+- **`cli.js` symlink loop protection** — `countFiles` uses `visited` Set + `realpathSync` to prevent infinite recursion
+- **`cli.js` dead code removal** — Removed unreachable `-h`/`-v` comparisons (already mapped by parseArgs)
+- **`cli.js` bare catch** — `catch {}` → `catch (e)` for debuggability
+- **`bootstrap.sh` stdin prompt delivery** — `claude -p "$PROMPT"` → `cat file | claude -p` (avoids ARG_MAX on large prompts)
+- **`bootstrap.sh` dead code removal** — Removed unused `inject_project_root` function
+- **`bootstrap.sh` --lang guard** — Validates `$2` exists before `shift 2`
+- **`bootstrap.sh` read -rp** — Added `-r` flag to prevent backslash escape interpretation
+- **`bootstrap.sh` dynamic language count** — Hardcoded `10` → `${#SUPPORTED_LANGS[@]}`
+- **`bootstrap.sh` Node version check** — Added numeric validation before `-lt` comparison
+- **`bootstrap.sh` file count** — Added `/generated/` and anchored `/node_modules/` exclusion (matches cli.js)
+- **`bootstrap.sh` env cleanup** — `unset _DOMAIN_LIST _PASS_NUM _PROJECT_ROOT` after use
+- **`pass-json-validator`** — Removed redundant `.filter(.endsWith(".json"))` after glob
+- **`safe-fs.js` statSafe** — Read-first order (readFileSync before statSync) to reduce TOCTOU window
+- **Box drawing alignment** — All 7 tool headers: border `╔═...═╗` width matched to `║...║` content width
+- **All 10 READMEs** — `sed` → `perl` in manual steps, `find` command with `/generated/` exclusion, localized frontend comments, updated Contributing test count
+
+### Fixed
+- **`plan-validator`**: `extractCodeBlocks` regex `[\s\S]*?` truncated at inner code fences → indexOf-based parser
+- **`plan-validator`**: `replaceCodeBlock` misidentified closing fences with trailing text as opening fences
+- **`plan-validator`**: off-by-one in `searchPos` (used `nextNewline + 1` instead of `nextNewline`) caused consecutive fences to be missed
+- **`bootstrap.sh`**: Pass 1 failure left temp file behind (now cleaned on both success and failure paths)
+
+## [1.2.4] — 2026-04-03
 
 ### Changed
 - **50.sync/ rules role clarified** — no longer described as "hooks fallback"; now the primary sync reminder mechanism (`npx claudeos-core refresh`)

package/README.de.md

@@ -107,9 +107,43 @@ npx claudeos-core init
 
 # Option D: git clone (für Entwicklung/Beiträge)
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+
+# Plattformübergreifend (PowerShell, CMD, Bash, Zsh — jedes Terminal)
+node claudeos-core-tools/bin/cli.js init
+
+# Nur Linux/macOS (nur Bash)
 bash claudeos-core-tools/bootstrap.sh
 ```
 
+### Ausgabesprache (10 Sprachen)
+
+Wenn Sie `init` ohne `--lang` ausführen, erscheint ein interaktiver Selektor mit Pfeiltasten:
+
+```
+╔══════════════════════════════════════════════════╗
+║  Select generated document language (required)   ║
+╚══════════════════════════════════════════════════╝
+
+  Die generierten Dateien (CLAUDE.md, Standards, Rules,
+  Skills, Guides) werden auf Deutsch verfasst.
+
+     1. en     — English
+     ...
+  ❯ 10. de     — Deutsch (German)
+
+  ↑↓ Move  ↵ Select
+```
+
+Die Beschreibung wechselt beim Navigieren in die entsprechende Sprache. Um den Selektor zu überspringen:
+
+```bash
+npx claudeos-core init --lang de    # Deutsch
+npx claudeos-core init --lang en    # English
+npx claudeos-core init --lang ko    # 한국어
+```
+
+> **Hinweis:** Dies ändert nur die Sprache der generierten Dokumentationsdateien. Die Codeanalyse (Pass 1–2) läuft immer auf Englisch; nur das generierte Ergebnis (Pass 3) wird in der gewählten Sprache geschrieben.
+
 Das war's. Nach 5–18 Minuten ist die gesamte Dokumentation generiert und einsatzbereit.
 
 ### Manuelle Schritt-für-Schritt-Installation
@@ -171,12 +205,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
+# Für Frontend-Gruppen verwenden Sie pass1-frontend-prompt.md
 ```
 
 **Prüfen:** `ls claudeos-core/generated/pass1-*.json` sollte pro Gruppe eine JSON zeigen.
@@ -218,7 +252,7 @@ node claudeos-core-tools/pass-json-validator/index.js   # JSON format
 #### Step 8: Ergebnisse überprüfen
 
 ```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/*/
 ```
@@ -421,6 +455,7 @@ npx claudeos-core restore
 | **Projektspezifische Ausgabe** | ✅ Jede Datei spiegelt Ihre Muster wider | ❌ Generische Befehle | Teilweise | ❌ Einheitsgröße |
 | **Multi-Stack** | ✅ Auto-Erkennung + separate Analyse | ❌ Stack-agnostisch | Manuell | Variiert |
 | **Kotlin + CQRS/BFF** | ✅ Multi-Modul, Command/Query-Trennung | ❌ | ❌ | ❌ |
+| **Mehrsprachig** | ✅ 10 Sprachen, interaktiver Selektor | ❌ | ❌ | ❌ |
 | **Selbstverifizierung** | ✅ 5 Validierungstools | ❌ | ❌ | ❌ |
 | **Backup / Wiederherstellung** | ✅ Master Plan System | ❌ | ❌ | ❌ |
 | **Einrichtungszeit** | ~5–18 Min (automatisch) | ~5 Min (manuelle Konfig) | Stunden–Tage | ~5 Min |

package/README.es.md

@@ -107,9 +107,44 @@ npx claudeos-core init
 
 # Opción D: git clone (para desarrollo/contribución)
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+
+# Multiplataforma (PowerShell, CMD, Bash, Zsh — cualquier terminal)
+node claudeos-core-tools/bin/cli.js init
+
+# Solo Linux/macOS (solo Bash)
 bash claudeos-core-tools/bootstrap.sh
 ```
 
+### Idioma de salida (10 idiomas)
+
+Al ejecutar `init` sin `--lang`, aparece un selector interactivo con teclas de flecha:
+
+```
+╔══════════════════════════════════════════════════╗
+║  Select generated document language (required)   ║
+╚══════════════════════════════════════════════════╝
+
+  Los archivos generados (CLAUDE.md, Standards, Rules,
+  Skills, Guides) se escribirán en español.
+
+     1. en     — English
+     ...
+  ❯  5. es     — Español (Spanish)
+     ...
+
+  ↑↓ Move  ↵ Select
+```
+
+La descripción cambia al idioma seleccionado al navegar. Para saltar el selector:
+
+```bash
+npx claudeos-core init --lang es    # Español
+npx claudeos-core init --lang en    # English
+npx claudeos-core init --lang ko    # 한국어
+```
+
+> **Nota:** Solo cambia el idioma de los archivos de documentación generados. El análisis de código (Pass 1–2) siempre se ejecuta en inglés; solo la salida generada (Pass 3) se escribe en el idioma elegido.
+
 Eso es todo. Después de 5–18 minutos, toda la documentación estará generada y lista para usar.
 
 ### Instalación Manual Paso a Paso
@@ -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
+# Para grupos frontend, use pass1-frontend-prompt.md
 ```
 
 **Verificar:** `ls claudeos-core/generated/pass1-*.json` debe mostrar un JSON por grupo.
@@ -218,7 +253,7 @@ node claudeos-core-tools/pass-json-validator/index.js   # JSON format
 #### Step 8: Verificar los resultados
 
 ```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/*/
 ```
@@ -421,6 +456,7 @@ npx claudeos-core restore
 | **Salida específica del proyecto** | ✅ Cada archivo refleja tus patrones | ❌ Comandos genéricos | Parcial | ❌ Talla única |
 | **Multi-stack** | ✅ Auto-detección + análisis separado | ❌ Agnóstico al stack | Manual | Variable |
 | **Kotlin + CQRS/BFF** | ✅ Multi-module, Command/Query split | ❌ | ❌ | ❌ |
+| **Multi-idioma** | ✅ 10 idiomas, selector interactivo | ❌ | ❌ | ❌ |
 | **Auto-verificación** | ✅ 5 herramientas de validación | ❌ | ❌ | ❌ |
 | **Backup / Restauración** | ✅ Sistema Master Plan | ❌ | ❌ | ❌ |
 | **Tiempo de configuración** | ~5–18min (automático) | ~5min (config manual) | Horas–Días | ~5min |

package/README.fr.md

@@ -107,9 +107,44 @@ npx claudeos-core init
 
 # Option D : git clone (pour développement/contribution)
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+
+# Multiplateforme (PowerShell, CMD, Bash, Zsh — tout terminal)
+node claudeos-core-tools/bin/cli.js init
+
+# Linux/macOS uniquement (Bash uniquement)
 bash claudeos-core-tools/bootstrap.sh
 ```
 
+### Langue de sortie (10 langues)
+
+En exécutant `init` sans `--lang`, un sélecteur interactif avec les touches fléchées apparaît :
+
+```
+╔══════════════════════════════════════════════════╗
+║  Select generated document language (required)   ║
+╚══════════════════════════════════════════════════╝
+
+  Les fichiers générés (CLAUDE.md, Standards, Rules,
+  Skills, Guides) seront rédigés en français.
+
+     1. en     — English
+     ...
+  ❯  9. fr     — Français (French)
+     ...
+
+  ↑↓ Move  ↵ Select
+```
+
+La description change dans la langue correspondante lors de la navigation. Pour passer le sélecteur :
+
+```bash
+npx claudeos-core init --lang fr    # Français
+npx claudeos-core init --lang en    # English
+npx claudeos-core init --lang ko    # 한국어
+```
+
+> **Note :** Ceci ne change que la langue des fichiers de documentation générés. L'analyse du code (Pass 1–2) s'exécute toujours en anglais ; seul le résultat généré (Pass 3) est écrit dans la langue choisie.
+
 C'est tout. Après 5–18 minutes, toute la documentation est générée et prête à l'emploi.
 
 ### Installation Manuelle Étape par Étape
@@ -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
+# Pour les groupes frontend, utilisez pass1-frontend-prompt.md
 ```
 
 **Vérifier :** `ls claudeos-core/generated/pass1-*.json` doit afficher un JSON par groupe.
@@ -218,7 +253,7 @@ node claudeos-core-tools/pass-json-validator/index.js   # JSON format
 #### Step 8 : Vérifier les résultats
 
 ```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/*/
 ```
@@ -421,6 +456,7 @@ npx claudeos-core restore
 | **Sortie spécifique au projet** | ✅ Chaque fichier reflète vos patterns | ❌ Commandes génériques | Partiel | ❌ Taille unique |
 | **Multi-stack** | ✅ Auto-détection + analyse séparée | ❌ Agnostique au stack | Manuel | Variable |
 | **Kotlin + CQRS/BFF** | ✅ Multi-module, Command/Query split | ❌ | ❌ | ❌ |
+| **Multilingue** | ✅ 10 langues, sélecteur interactif | ❌ | ❌ | ❌ |
 | **Auto-vérification** | ✅ 5 outils de validation | ❌ | ❌ | ❌ |
 | **Sauvegarde / Restauration** | ✅ Système Master Plan | ❌ | ❌ | ❌ |
 | **Temps de configuration** | ~5–18 min (automatique) | ~5 min (config manuelle) | Heures–Jours | ~5 min |

package/README.hi.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
+     ...
+  ❯  7. hi     — हिन्दी (Hindi)
+     ...
+
+  ↑↓ Move  ↵ Select
+```
+
+एरो से मूव करने पर विवरण उस भाषा में बदलता है। सेलेक्टर स्किप करने के लिए:
+
+```bash
+npx claudeos-core init --lang hi    # हिन्दी
+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/*/
 ```
@@ -421,6 +456,7 @@ npx claudeos-core restore
 | **प्रोजेक्ट-स्पेसिफिक आउटपुट** | ✅ हर फाइल आपके पैटर्न रिफ्लेक्ट करती है | ❌ जेनेरिक कमांड | आंशिक | ❌ वन-साइज़-फिट्स-ऑल |
 | **मल्टी-स्टैक** | ✅ ऑटो-डिटेक्ट + अलग विश्लेषण | ❌ स्टैक-एग्नॉस्टिक | मैन्युअल | अनिश्चित |
 | **Kotlin + CQRS/BFF** | ✅ मल्टी-मॉड्यूल, Command/Query विभाजन | ❌ | ❌ | ❌ |
+| **बहुभाषी** | ✅ 10 भाषाएँ, इंटरैक्टिव सेलेक्टर | ❌ | ❌ | ❌ |
 | **सेल्फ-वेरिफाइंग** | ✅ 5 वैलिडेशन टूल्स | ❌ | ❌ | ❌ |
 | **बैकअप / रीस्टोर** | ✅ Master Plan सिस्टम | ❌ | ❌ | ❌ |
 | **सेटअप समय** | ~5–18 मिनट (ऑटोमेटेड) | ~5 मिनट (मैन्युअल कॉन्फ़िग) | घंटे–दिन | ~5 मिनट |

package/README.ja.md

@@ -107,9 +107,45 @@ 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)
+  ❯  4. ja     — 日本語 (Japanese)
+     ...
+
+  ↑↓ Move  ↵ Select
+```
+
+矢印キーで移動すると、説明が該当言語に切り替わります。セレクターをスキップするには `--lang` を直接指定してください：
+
+```bash
+npx claudeos-core init --lang ja    # 日本語
+npx claudeos-core init --lang en    # English
+npx claudeos-core init --lang ko    # 한국어
+```
+
+> **注意：** この設定は生成されるドキュメントファイルの言語のみを変更します。コード分析（Pass 1–2）は常に英語で実行され、生成結果（Pass 3）のみ選択した言語で作成されます。コード例は元のプログラミング言語構文のまま維持されます。
+
 これだけです。5–18 分後、すべてのドキュメントが生成され、すぐに使えます。
 
 ### 手動ステップバイステップインストール
@@ -171,12 +207,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` でグループごとに1つの JSON があることを確認。
@@ -218,7 +254,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/*/
 ```
@@ -421,6 +457,7 @@ npx claudeos-core restore
 | **プロジェクト固有の出力** | ✅ すべてのファイルがあなたのパターンを反映 | ❌ 汎用コマンド | 部分的 | ❌ 画一的 |
 | **マルチスタック** | ✅ 自動検出 + 個別分析 | ❌ スタック非依存 | 手動 | 不定 |
 | **Kotlin + CQRS/BFF** | ✅ マルチモジュール、Command/Query分離 | ❌ | ❌ | ❌ |
+| **多言語対応** | ✅ 10 言語、インタラクティブ選択 | ❌ | ❌ | ❌ |
 | **自己検証** | ✅ 5 つの検証ツール | ❌ | ❌ | ❌ |
 | **バックアップ / リストア** | ✅ Master Plan システム | ❌ | ❌ | ❌ |
 | **セットアップ時間** | ~5–18分（自動） | ~5分（手動設定） | 数時間–数日 | ~5分 |

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/*/
 ```
@@ -439,6 +474,7 @@ npx claudeos-core restore
 | **프로젝트 특화 출력** | ✅ 모든 파일이 실제 패턴 반영 | ❌ 제네릭 명령어 | 부분적 | ❌ 획일적 |
 | **멀티스택** | ✅ 자동 감지 + 별도 분석 | ❌ 스택 무관 | 수동 | 다양 |
 | **Kotlin + CQRS/BFF** | ✅ 멀티모듈, Command/Query 분리 | ❌ | ❌ | ❌ |
+| **다국어 지원** | ✅ 10개 언어, 인터랙티브 선택 | ❌ | ❌ | ❌ |
 | **자체 검증** | ✅ 5개 검증 도구 | ❌ | ❌ | ❌ |
 | **백업 / 복원** | ✅ Master Plan 시스템 | ❌ | ❌ | ❌ |
 | **설정 시간** | ~5–18분 (자동화) | ~5분 (수동 설정) | 수 시간–며칠 | ~5분 |