claudeos-core 1.2.4 → 1.3.1

package/CHANGELOG.md

@@ -1,5 +1,81 @@
 # Changelog
 
+## [1.3.1] — 2026-04-03
+
+### Changed
+- **Context efficiency: rules paths scoping** — `40.infra/*` and `50.sync/*` rules now use scoped `paths:` frontmatter instead of `["**/*"]`; infra rules load only for config/infra files, sync rules load only for claudeos-core files (5 stacks; python-django infra keeps `["**/*"]` due to .py settings)
+- **Context efficiency: standard reference distribution** — `00.standard-reference.md` changed from "MUST Read ALL" to "Standard Documents Directory — Read ONLY relevant"; each rule file now ends with `## Reference` section linking to its corresponding standard
+- **content-validator** — Removed `50.sync` exemption from frontmatter validation; all rules now checked equally; updated comment and warning message to reflect scoped paths
+- **prompt-generator** — Removed duplicate `pass1-prompt.md` generation (backward-compat fallback no longer needed; `pass1-{type}-prompt.md` is always generated)
+- **Pass 1 templates** (all 6 stacks) — "Do not create files" → "Do not create or modify source files" (clarifies that saving analysis JSON is allowed)
+- **All 10 READMEs** — "How Claude Code Uses Your Documentation" section updated: auto-load table now shows per-category paths, standard reading explained as on-demand via `## Reference` links
+- **Pass 3 CRITICAL directive: Code Example Accuracy** (all 6 stacks) — Rules/standards code examples must use EXACT method names from pass2-merged.json; prevents hallucination of API names (e.g., `ok()` instead of `success()`)
+
+## [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

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/*/
 ```
@@ -352,16 +386,21 @@ So liest Claude Code die von ClaudeOS-Core generierte Dokumentation tatsächlich
 | Datei | Wann | Garantiert |
 |---|---|---|
 | `CLAUDE.md` | Bei jedem Gesprächsstart | Immer |
-| `.claude/rules/*.md` | Beim Bearbeiten von Dateien (via `paths: ["**/*"]`) | Immer |
-| `.claude/rules/00.core/00.standard-reference.md` | ↑ Oben enthalten | Immer |
+| `.claude/rules/00.core/*` | Beim Bearbeiten von Dateien (`paths: ["**/*"]`) | Immer |
+| `.claude/rules/10.backend/*` | Beim Bearbeiten von Dateien (`paths: ["**/*"]`) | Immer |
+| `.claude/rules/30.security-db/*` | Beim Bearbeiten von Dateien (`paths: ["**/*"]`) | Immer |
+| `.claude/rules/40.infra/*` | Nur bei Config/Infra-Dateien (eingeschränkte Paths) | Bedingt |
+| `.claude/rules/50.sync/*` | Nur bei claudeos-core-Dateien (eingeschränkte Paths) | Bedingt |
 
-### Dateien, die über die standard-reference Regel gelesen werden
+### Dateien, die on-demand über Regel-Referenzen gelesen werden
 
-Die Regel `00.standard-reference.md` weist Claude Code an, die Standard-Dokumente vor dem Schreiben von Code zu Read:
+Jede Regel-Datei verlinkt im `## Reference`-Abschnitt auf den entsprechenden Standard. Claude liest nur den für die aktuelle Aufgabe relevanten Standard:
 
 - `claudeos-core/standard/**` — Coding-Patterns, ✅/❌ Beispiele, Namenskonventionen
 - `claudeos-core/database/**` — DB-Schema (für Queries, Mapper, Migrationen)
 
+`00.standard-reference.md` dient als Verzeichnis zum Entdecken von Standards ohne entsprechende Regel.
+
 ### Dateien, die NICHT gelesen werden (Kontexteinsparung)
 
 Explizit durch den `DO NOT Read`-Abschnitt der standard-reference Regel ausgeschlossen:
@@ -421,6 +460,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/*/
 ```
@@ -352,16 +387,21 @@ Así es como Claude Code lee la documentación generada por ClaudeOS-Core:
 | Archivo | Cuándo | Garantizado |
 |---|---|---|
 | `CLAUDE.md` | Al inicio de cada conversación | Siempre |
-| `.claude/rules/*.md` | Al editar archivos (vía `paths: ["**/*"]`) | Siempre |
-| `.claude/rules/00.core/00.standard-reference.md` | ↑ Incluido arriba | Siempre |
+| `.claude/rules/00.core/*` | Al editar archivos (`paths: ["**/*"]`) | Siempre |
+| `.claude/rules/10.backend/*` | Al editar archivos (`paths: ["**/*"]`) | Siempre |
+| `.claude/rules/30.security-db/*` | Al editar archivos (`paths: ["**/*"]`) | Siempre |
+| `.claude/rules/40.infra/*` | Solo al editar archivos config/infra (paths con alcance) | Condicional |
+| `.claude/rules/50.sync/*` | Solo al editar archivos claudeos-core (paths con alcance) | Condicional |
 
-### Archivos leídos vía regla standard-reference
+### Archivos leídos bajo demanda vía referencias en reglas
 
-La regla `00.standard-reference.md` instruye a Claude Code a Read los documentos estándar antes de escribir código:
+Cada archivo de regla enlaza a su standard correspondiente en la sección `## Reference`. Claude solo lee el standard relevante para la tarea actual:
 
 - `claudeos-core/standard/**` — Patrones de código, ejemplos ✅/❌, convenciones de nombres
 - `claudeos-core/database/**` — Schema DB (para queries, mappers, migraciones)
 
+`00.standard-reference.md` sirve como directorio para descubrir standards sin regla correspondiente.
+
 ### Archivos que NO se leen (ahorro de contexto)
 
 Excluidos explícitamente por la sección `DO NOT Read` de la regla standard-reference:
@@ -421,6 +461,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/*/
 ```
@@ -352,16 +387,21 @@ Voici comment Claude Code lit effectivement la documentation générée par Clau
 | Fichier | Quand | Garanti |
 |---|---|---|
 | `CLAUDE.md` | Au début de chaque conversation | Toujours |
-| `.claude/rules/*.md` | Lors de l'édition de fichiers (via `paths: ["**/*"]`) | Toujours |
-| `.claude/rules/00.core/00.standard-reference.md` | ↑ Inclus ci-dessus | Toujours |
+| `.claude/rules/00.core/*` | Lors de l'édition de fichiers (`paths: ["**/*"]`) | Toujours |
+| `.claude/rules/10.backend/*` | Lors de l'édition de fichiers (`paths: ["**/*"]`) | Toujours |
+| `.claude/rules/30.security-db/*` | Lors de l'édition de fichiers (`paths: ["**/*"]`) | Toujours |
+| `.claude/rules/40.infra/*` | Uniquement pour les fichiers config/infra (paths scopés) | Conditionnel |
+| `.claude/rules/50.sync/*` | Uniquement pour les fichiers claudeos-core (paths scopés) | Conditionnel |
 
-### Fichiers lus via la règle standard-reference
+### Fichiers lus à la demande via les références des règles
 
-La règle `00.standard-reference.md` indique à Claude Code de Read les documents standards avant d'écrire du code :
+Chaque fichier de règle lie son standard correspondant dans la section `## Reference`. Claude ne lit que le standard pertinent pour la tâche en cours :
 
 - `claudeos-core/standard/**` — Patterns de code, exemples ✅/❌, conventions de nommage
 - `claudeos-core/database/**` — Schéma DB (pour requêtes, mappers, migrations)
 
+`00.standard-reference.md` sert de répertoire pour découvrir les standards sans règle correspondante.
+
 ### Fichiers NON lus (économie de contexte)
 
 Explicitement exclus par la section `DO NOT Read` de la règle standard-reference :
@@ -421,6 +461,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/*/
 ```
@@ -352,16 +387,21 @@ ClaudeOS-Core द्वारा जेनरेट किए गए डॉक
 | फाइल | कब | गारंटी |
 |---|---|---|
 | `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/**` — DB स्कीमा (क्वेरी, मैपर, माइग्रेशन के लिए)
 
+`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 मिनट |

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/*/
 ```
@@ -352,16 +388,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` ルールが、コード作成前に以下のドキュメントを Read するよう指示します：
+各ルールファイル末尾の `## Reference` セクションが対応するstandardをリンクします。Claudeは現在のタスクに関連するstandardのみ読み取ります：
 
 - `claudeos-core/standard/**` — コーディングパターン、✅/❌ 例、命名規則
 - `claudeos-core/database/**` — DB スキーマ（クエリ、マッパー、マイグレーション用）
 
+`00.standard-reference.md` は対応ルールのないstandardを発見するためのディレクトリです。
+
 ### 読み取らないファイル（コンテキスト節約）
 
 standard-reference ルールの `DO NOT Read` セクションで明示的に除外されます：
@@ -421,6 +462,7 @@ npx claudeos-core restore
 | **プロジェクト固有の出力** | ✅ すべてのファイルがあなたのパターンを反映 | ❌ 汎用コマンド | 部分的 | ❌ 画一的 |
 | **マルチスタック** | ✅ 自動検出 + 個別分析 | ❌ スタック非依存 | 手動 | 不定 |
 | **Kotlin + CQRS/BFF** | ✅ マルチモジュール、Command/Query分離 | ❌ | ❌ | ❌ |
+| **多言語対応** | ✅ 10 言語、インタラクティブ選択 | ❌ | ❌ | ❌ |
 | **自己検証** | ✅ 5 つの検証ツール | ❌ | ❌ | ❌ |
 | **バックアップ / リストア** | ✅ Master Plan システム | ❌ | ❌ | ❌ |
 | **セットアップ時間** | ~5–18分（自動） | ~5分（手動設定） | 数時間–数日 | ~5分 |