claudeos-core 1.3.0 → 1.4.0

package/README.md

@@ -1,6 +1,6 @@
 # ClaudeOS-Core
 
-**One command. Your entire Claude Code documentation — auto-generated from your actual source code.**
+**The only tool that reads your source code first, confirms your stack and patterns with deterministic analysis, then generates Claude Code rules tailored to your exact project.**
 
 ```bash
 npx claudeos-core init
@@ -12,20 +12,60 @@ ClaudeOS-Core reads your codebase, extracts every pattern it finds, and generate
 
 ---
 
-## The Problem
+## Why ClaudeOS-Core?
 
-Claude Code is powerful, but it doesn't know _your_ project's conventions. Manually writing a `CLAUDE.md`, dozens of rules, and scaffolding skills takes hours — and they go stale the moment your codebase evolves.
+Every other Claude Code tool works like this:
 
-## The Solution
+> **Human describes the project → LLM generates documentation**
 
-ClaudeOS-Core automates the entire process:
+ClaudeOS-Core works like this:
 
-1. **Scans** your project — detects stack, domains, ORM, DB, package manager automatically
-2. **Analyzes** your source code in depth — controller patterns, service layers, naming conventions, error handling, security, testing, and 50+ categories
-3. **Generates** a complete documentation ecosystem — `CLAUDE.md`, Standards (15–19 files), Rules, Skills, Guides (9 files), Master Plans, DB docs, and MCP guide
-4. **Validates** everything — 5 built-in verification tools ensure consistency
+> **Code analyzes your source → Code builds a tailored prompt → LLM generates documentation → Code verifies the output**
 
-Total time: **5–18 minutes**, depending on project size. Zero manual configuration.
+This is not a small difference. Here's why it matters:
+
+### The core problem: LLMs guess. Code doesn't.
+
+When you ask Claude to "analyze this project," it **guesses** your stack, your ORM, your domain structure.
+It might see `spring-boot` in your `build.gradle` but miss that you use MyBatis (not JPA).
+It might detect a `user/` directory but not realize your project uses layer-first packaging (Pattern A), not domain-first (Pattern B).
+
+**ClaudeOS-Core doesn't guess.** Before Claude ever sees your project, Node.js code has already:
+
+- Parsed `build.gradle` / `package.json` / `pyproject.toml` and **confirmed** your stack, ORM, DB, and package manager
+- Scanned your directory structure and **confirmed** your domain list with file counts
+- Classified your project structure into one of 5 Java patterns, Kotlin CQRS/BFF, or Next.js App Router/FSD
+- Split domains into optimally-sized groups that fit Claude's context window
+- Assembled a stack-specific prompt with all confirmed facts injected
+
+By the time Claude receives the prompt, there's nothing left to guess. The stack is confirmed. The domains are confirmed. The structure pattern is confirmed. Claude's only job is to generate documentation that matches these **confirmed facts**.
+
+### The result
+
+Other tools produce "generally good" documentation.
+ClaudeOS-Core produces documentation that knows your project uses `ApiResponse.ok()` (not `ResponseEntity.success()`), that your MyBatis XML mappers live in `src/main/resources/mapper/{domain}/`, and that your package structure is `com.company.module.{domain}.controller` — because it read your actual code.
+
+### Before & After
+
+**Without ClaudeOS-Core** — you ask Claude Code to create an Order CRUD:
+```
+❌ Uses JPA-style repository (your project uses MyBatis)
+❌ Creates ResponseEntity.success() (your wrapper is ApiResponse.ok())
+❌ Places files in order/controller/ (your project uses controller/order/)
+❌ Generates English comments (your team writes Korean comments)
+→ You spend 20 minutes fixing every generated file
+```
+
+**With ClaudeOS-Core** — `.claude/rules/` already contains your confirmed patterns:
+```
+✅ Generates MyBatis mapper + XML (detected from build.gradle)
+✅ Uses ApiResponse.ok() (extracted from your actual source)
+✅ Places files in controller/order/ (Pattern A confirmed by structure scan)
+✅ Korean comments (--lang ko applied)
+→ Generated code matches your project conventions immediately
+```
+
+This difference compounds. 10 tasks/day × 20 minutes saved = **3+ hours/day**.
 
 ---
 
@@ -77,6 +117,7 @@ Supported module types: `command`, `query`, `bff`, `integration`, `standalone`,
 - **FSD (Feature-Sliced Design)**: `features/*/`, `widgets/*/`, `entities/*/`
 - **RSC/Client split**: Detects `client.tsx` pattern, tracks Server/Client component separation
 - **Config fallback**: Detects Next.js/Vite/Nuxt from config files when not in `package.json` (monorepo support)
+- **Deep directory fallback**: For React/CRA/Vite/Vue/RN projects, scans `**/components/*/`, `**/views/*/`, `**/screens/*/`, `**/containers/*/`, `**/pages/*/`, `**/routes/*/`, `**/modules/*/`, `**/domains/*/` at any depth
 
 ---
 
@@ -115,7 +156,7 @@ 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:
+When you run `init` without `--lang`, an interactive selector appears — use arrow keys or number keys to choose:
 
 ```
 ╔══════════════════════════════════════════════════╗
@@ -136,7 +177,7 @@ When you run `init` without `--lang`, an interactive selector appears — use ar
      9. fr     — Français (French)
     10. de     — Deutsch (German)
 
-  ↑↓ Move  ↵ Select
+  ↑↓ Move  1-0 Jump  Enter Select  ESC Cancel
 ```
 
 The description changes to the selected language as you navigate. To skip the selector, pass `--lang` directly:
@@ -424,16 +465,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:
@@ -487,16 +533,37 @@ npx claudeos-core restore
 
 ## How Is This Different?
 
-| | ClaudeOS-Core | SuperClaude | Manual CLAUDE.md | Generic Skills |
-|---|---|---|---|---|
-| **Reads your code** | ✅ Deep analysis (55–95 categories) | ❌ Behavioral injection | ❌ Manual writing | ❌ Pre-built templates |
-| **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 |
+### vs Other Claude Code Tools
+
+| | ClaudeOS-Core | Everything Claude Code (50K+ ⭐) | Harness | specs-generator | Claude `/init` |
+|---|---|---|---|---|---|
+| **Approach** | Code analyzes first, then LLM generates | Pre-built config presets | LLM designs agent teams | LLM generates spec docs | LLM writes CLAUDE.md |
+| **Reads your source code** | ✅ Deterministic static analysis | ❌ | ❌ | ❌ (LLM reads) | ❌ (LLM reads) |
+| **Stack detection** | Code confirms (ORM, DB, build tool, pkg manager) | N/A (stack-agnostic) | LLM guesses | LLM guesses | LLM guesses |
+| **Domain detection** | Code confirms (Java 5 patterns, Kotlin CQRS, Next.js FSD) | N/A | LLM guesses | N/A | N/A |
+| **Same project → Same result** | ✅ Deterministic analysis | ✅ (static files) | ❌ (LLM varies) | ❌ (LLM varies) | ❌ (LLM varies) |
+| **Large project handling** | Domain group splitting (4 domains / 40 files per group) | N/A | No splitting | No splitting | Context window limit |
+| **Output** | CLAUDE.md + Rules + Standards + Skills + Guides + Plans (40-50+ files) | Agents + Skills + Commands + Hooks | Agents + Skills | 6 spec documents | CLAUDE.md (1 file) |
+| **Output location** | `.claude/rules/` (auto-loaded by Claude Code) | `.claude/` various | `.claude/agents/` + `.claude/skills/` | `.claude/steering/` + `specs/` | `CLAUDE.md` |
+| **Post-generation verification** | ✅ 5 automated validators | ❌ | ❌ | ❌ | ❌ |
+| **Multi-language output** | ✅ 10 languages | ❌ | ❌ | ❌ | ❌ |
+| **Multi-stack** | ✅ Backend + Frontend simultaneous | ❌ Stack-agnostic | ❌ | ❌ | Partial |
+| **Agent orchestration** | ❌ | ✅ 28 agents | ✅ 6 patterns | ❌ | ❌ |
+
+### The key difference in one sentence
+
+**Other tools give Claude "generally good instructions." ClaudeOS-Core gives Claude "instructions extracted from your actual code."**
+
+That's why Claude Code stops generating JPA code in your MyBatis project,
+stops using `success()` when your codebase uses `ok()`,
+and stops creating `user/controller/` directories when your project uses `controller/user/`.
+
+### Complementary, not competing
+
+ClaudeOS-Core focuses on **project-specific rules and standards**.
+Other tools focus on **agent orchestration and workflows**.
+
+You can use ClaudeOS-Core to generate your project's rules, then use ECC or Harness on top for agent teams and workflow automation. They solve different problems.
 
 ---
 

package/README.ru.md

@@ -1,6 +1,6 @@
 # ClaudeOS-Core
 
-**Одна команда. Вся документация Claude Code — автоматически сгенерирована из вашего исходного кода.**
+**Единственный инструмент, который сначала читает ваш исходный код, подтверждает стек и паттерны детерминированным анализом, а затем генерирует правила Claude Code, точно адаптированные к вашему проекту.**
 
 ```bash
 npx claudeos-core init
@@ -12,20 +12,50 @@ ClaudeOS-Core читает вашу кодовую базу, извлекает
 
 ---
 
-## Проблема
+## Почему ClaudeOS-Core?
 
-Claude Code мощный, но он не знает конвенций _вашего_ проекта. Ручное написание `CLAUDE.md`, десятков правил и skills для скаффолдинга занимает часы — и они устаревают, как только кодовая база меняется.
+> Человек описывает проект → LLM генерирует документацию
 
-## Решение
+ClaudeOS-Core:
 
-ClaudeOS-Core автоматизирует весь процесс:
+> Код анализирует исходники → Код строит кастомный промпт → LLM генерирует документацию → Код верифицирует вывод
 
-1. **Сканирует** ваш проект — автоматически определяет стек, домены, ORM, базу данных, пакетный менеджер
-2. **Глубоко анализирует** исходный код — паттерны контроллеров, сервисные слои, соглашения об именовании, обработка ошибок, безопасность, тестирование и 50+ категорий
-3. **Генерирует** полную экосистему документации — `CLAUDE.md`, Standards (15–19 файлов), Rules, Skills, Guides (9 файлов), Master Plans, документацию БД и руководство MCP
-4. **Валидирует** всё — 5 встроенных инструментов проверки гарантируют консистентность
+### Ключевая проблема: LLM угадывает. Код подтверждает.
 
-Общее время: **5–18 минут**, в зависимости от размера проекта. Нулевая ручная настройка.
+Когда вы просите Claude «проанализировать проект», он **угадывает** стек, ORM, структуру доменов.
+
+**ClaudeOS-Core не угадывает.** Claude Node.js:
+
+- `build.gradle` / `package.json` / `pyproject.toml` → **confirmed**
+- directory scan → **confirmed**
+- Java 5 patterns, Kotlin CQRS/BFF, Next.js App Router/FSD → **classified**
+- domain groups → **split**
+- stack-specific prompt → **assembled**
+
+### Результат
+
+Другие инструменты создают «в целом хорошую» документацию.
+ClaudeOS-Core создаёт документацию, которая знает, что ваш проект использует `ApiResponse.ok()` (а не `ResponseEntity.success()`), что MyBatis XML маппер находится в `src/main/resources/mapper/{domain}/` — потому что он прочитал ваш реальный код.
+
+### Before & After
+
+**Без ClaudeOS-Core**:
+```
+❌ JPA repository (MyBatis)
+❌ ResponseEntity.success() (ApiResponse.ok())
+❌ order/controller/ (controller/order/)
+→ 20 min fix per file
+```
+
+**С ClaudeOS-Core**:
+```
+✅ MyBatis mapper + XML (build.gradle)
+✅ ApiResponse.ok() (source code)
+✅ controller/order/ (Pattern A)
+→ immediate match
+```
+
+Эта разница накапливается. 10 задач/день × 20 минут экономии = **более 3 часов в день**.
 
 ---
 
@@ -79,6 +109,7 @@ ClaudeOS-Core автоматизирует весь процесс:
 - **FSD (Feature-Sliced Design)**: `features/*/`, `widgets/*/`, `entities/*/`
 - **RSC/Client разделение**: Обнаружение паттерна `client.tsx`, отслеживание разделения Server/Client
 - **Фолбэк конфигурации**: Обнаружение Next.js/Vite/Nuxt из конфиг-файлов (поддержка monorepo)
+- **Фолбэк глубоких директорий**: Для React/CRA/Vite/Vue/RN проектов сканирует `**/components/*/`, `**/views/*/`, `**/screens/*/`, `**/containers/*/`, `**/pages/*/`, `**/routes/*/`, `**/modules/*/`, `**/domains/*/` на любой глубине
 
 ---
 
@@ -117,7 +148,7 @@ bash claudeos-core-tools/bootstrap.sh
 
 ### Язык вывода (10 языков)
 
-При запуске `init` без `--lang` появляется интерактивный селектор со стрелками:
+При запуске `init` без `--lang` появляется интерактивный селектор (стрелки или цифровые клавиши):
 
 ```
 ╔══════════════════════════════════════════════════╗
@@ -132,7 +163,7 @@ bash claudeos-core-tools/bootstrap.sh
   ❯  8. ru     — Русский (Russian)
      ...
 
-  ↑↓ Move  ↵ Select
+  ↑↓ Move  1-0 Jump  Enter Select  ESC Cancel
 ```
 
 При навигации описание переключается на соответствующий язык. Чтобы пропустить селектор:
@@ -387,16 +418,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:
@@ -450,19 +486,31 @@ npx claudeos-core restore
 
 ## Чем отличается?
 
-| | ClaudeOS-Core | SuperClaude | Ручной CLAUDE.md | Универсальные Skills |
-|---|---|---|---|---|
-| **Читает ваш код** | ✅ Глубокий анализ (55–95 категорий) | ❌ Инъекция поведения | ❌ Ручное написание | ❌ Готовые шаблоны |
-| **Вывод под проект** | ✅ Каждый файл отражает ваши паттерны | ❌ Универсальные команды | Частично | ❌ Один размер для всех |
-| **Мульти-стек** | ✅ Автоопределение + раздельный анализ | ❌ Стек-агностик | Вручную | Неопределённо |
-| **Kotlin + CQRS/BFF** | ✅ Мультимодульный, разделение Command/Query | ❌ | ❌ | ❌ |
-| **Многоязычность** | ✅ 10 языков, интерактивный выбор | ❌ | ❌ | ❌ |
-| **Самопроверка** | ✅ 5 инструментов валидации | ❌ | ❌ | ❌ |
-| **Бэкап / Восстановление** | ✅ Система Master Plan | ❌ | ❌ | ❌ |
-| **Время настройки** | ~5–18 мин (автоматически) | ~5 мин (ручная настройка) | Часы–Дни | ~5 мин |
+| | ClaudeOS-Core | Everything Claude Code (50K+ ⭐) | Harness | specs-generator | Claude `/init` |
+|---|---|---|---|---|---|
+| **Approach** | Code analyzes first, then LLM generates | Pre-built config presets | LLM designs agent teams | LLM generates spec docs | LLM writes CLAUDE.md |
+| **Reads your source code** | ✅ Deterministic static analysis | ❌ | ❌ | ❌ (LLM reads) | ❌ (LLM reads) |
+| **Stack detection** | Code confirms (ORM, DB, build tool, pkg manager) | N/A (stack-agnostic) | LLM guesses | LLM guesses | LLM guesses |
+| **Domain detection** | Code confirms (Java 5 patterns, Kotlin CQRS, Next.js FSD) | N/A | LLM guesses | N/A | N/A |
+| **Same project → Same result** | ✅ Deterministic analysis | ✅ (static files) | ❌ (LLM varies) | ❌ (LLM varies) | ❌ (LLM varies) |
+| **Large project handling** | Domain group splitting (4 domains / 40 files per group) | N/A | No splitting | No splitting | Context window limit |
+| **Output** | CLAUDE.md + Rules + Standards + Skills + Guides + Plans (40-50+ files) | Agents + Skills + Commands + Hooks | Agents + Skills | 6 spec documents | CLAUDE.md (1 file) |
+| **Output location** | `.claude/rules/` (auto-loaded by Claude Code) | `.claude/` various | `.claude/agents/` + `.claude/skills/` | `.claude/steering/` + `specs/` | `CLAUDE.md` |
+| **Post-generation verification** | ✅ 5 automated validators | ❌ | ❌ | ❌ | ❌ |
+| **Multi-language output** | ✅ 10 languages | ❌ | ❌ | ❌ | ❌ |
+| **Multi-stack** | ✅ Backend + Frontend simultaneous | ❌ Stack-agnostic | ❌ | ❌ | Partial |
+| **Agent orchestration** | ❌ | ✅ 28 agents | ✅ 6 patterns | ❌ | ❌ |
 
----
+### Key difference
 
+**Other tools give Claude "generally good instructions." ClaudeOS-Core gives Claude "instructions extracted from your actual code."**
+
+### Complementary, not competing
+
+ClaudeOS-Core: **project-specific rules**. Other tools: **agent orchestration**.
+Use both together.
+
+---
 ## FAQ
 
 **В: Изменяет ли он мой исходный код?**

package/README.vi.md

@@ -1,6 +1,6 @@
 # ClaudeOS-Core
 
-**Một lệnh duy nhất. Toàn bộ tài liệu Claude Code — được tạo tự động từ mã nguồn thực tế của bạn.**
+**Công cụ duy nhất đọc mã nguồn trước, xác nhận stack và pattern bằng phân tích deterministic, sau đó tạo quy tắc Claude Code phù hợp chính xác với dự án của bạn.**
 
 ```bash
 npx claudeos-core init
@@ -12,20 +12,50 @@ ClaudeOS-Core đọc codebase của bạn, trích xuất mọi pattern tìm th
 
 ---
 
-## Vấn Đề
+## Tại sao ClaudeOS-Core?
 
-Claude Code rất mạnh mẽ, nhưng nó không biết quy ước của _dự án bạn_. Viết thủ công `CLAUDE.md`, hàng chục rules và scaffolding skills tốn hàng giờ — và chúng trở nên lỗi thời ngay khi codebase thay đổi.
+> Con người mô tả dự án → LLM tạo tài liệu
 
-## Giải Pháp
+ClaudeOS-Core:
 
-ClaudeOS-Core tự động hóa toàn bộ quy trình:
+> Code phân tích source → Code xây dựng prompt tùy chỉnh → LLM tạo tài liệu → Code xác minh đầu ra
 
-1. **Quét** dự án — tự động phát hiện stack, domain, ORM, database, package manager
-2. **Phân tích chuyên sâu** mã nguồn — controller patterns, service layers, quy ước đặt tên, xử lý lỗi, bảo mật, testing và hơn 50 danh mục
-3. **Tạo** hệ sinh thái tài liệu hoàn chỉnh — `CLAUDE.md`, Standards (15–19 file), Rules, Skills, Guides (9 file), Master Plans, tài liệu DB và hướng dẫn MCP
-4. **Xác thực** mọi thứ — 5 công cụ kiểm tra tích hợp đảm bảo tính nhất quán
+### Vấn đề cốt lõi: LLM đoán. Code xác nhận.
 
-Tổng thời gian: **5–18 phút**, tùy thuộc vào quy mô dự án. Không cần cấu hình thủ công.
+Khi bạn yêu cầu Claude "phân tích dự án này", nó **đoán** stack, ORM, cấu trúc domain.
+
+**ClaudeOS-Core không đoán.** Claude Node.js:
+
+- `build.gradle` / `package.json` / `pyproject.toml` → **confirmed**
+- directory scan → **confirmed**
+- Java 5 patterns, Kotlin CQRS/BFF, Next.js App Router/FSD → **classified**
+- domain groups → **split**
+- stack-specific prompt → **assembled**
+
+### Kết quả
+
+Các tool khác tạo tài liệu "tốt một cách chung chung".
+ClaudeOS-Core tạo tài liệu biết rằng dự án sử dụng `ApiResponse.ok()` (không phải `ResponseEntity.success()`), MyBatis XML mapper nằm ở `src/main/resources/mapper/{domain}/` — vì nó đã đọc code thực tế.
+
+### Before & After
+
+**Không có ClaudeOS-Core**:
+```
+❌ JPA repository (MyBatis)
+❌ ResponseEntity.success() (ApiResponse.ok())
+❌ order/controller/ (controller/order/)
+→ 20 min fix per file
+```
+
+**Có ClaudeOS-Core**:
+```
+✅ MyBatis mapper + XML (build.gradle)
+✅ ApiResponse.ok() (source code)
+✅ controller/order/ (Pattern A)
+→ immediate match
+```
+
+Sự khác biệt này tích lũy. 10 task/ngày × 20 phút tiết kiệm = **hơn 3 giờ/ngày**.
 
 ---
 
@@ -79,6 +109,7 @@ Loại module hỗ trợ: `command`, `query`, `bff`, `integration`, `standalone`
 - **FSD (Feature-Sliced Design)**: `features/*/`, `widgets/*/`, `entities/*/`
 - **RSC/Client split**: Phát hiện pattern `client.tsx`, theo dõi tách Server/Client
 - **Config fallback**: Phát hiện Next.js/Vite/Nuxt từ file config (hỗ trợ monorepo)
+- **Fallback thư mục sâu**: Với dự án React/CRA/Vite/Vue/RN, quét `**/components/*/`, `**/views/*/`, `**/screens/*/`, `**/containers/*/`, `**/pages/*/`, `**/routes/*/`, `**/modules/*/`, `**/domains/*/` ở mọi độ sâu
 
 ---
 
@@ -117,7 +148,7 @@ 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:
+Khi chạy `init` không có `--lang`, bộ chọn tương tác bằng phím mũi tên hoặc phím số sẽ xuất hiện:
 
 ```
 ╔══════════════════════════════════════════════════╗
@@ -132,7 +163,7 @@ Khi chạy `init` không có `--lang`, bộ chọn tương tác bằng phím mũ
   ❯  6. vi     — Tiếng Việt (Vietnamese)
      ...
 
-  ↑↓ Move  ↵ Select
+  ↑↓ Move  1-0 Jump  Enter Select  ESC Cancel
 ```
 
 Mô tả thay đổi sang ngôn ngữ tương ứng khi di chuyển. Bỏ qua bộ chọn:
@@ -387,16 +418,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:
@@ -450,19 +486,31 @@ npx claudeos-core restore
 
 ## Khác Biệt Gì?
 
-| | ClaudeOS-Core | SuperClaude | CLAUDE.md Thủ Công | Skills Chung |
-|---|---|---|---|---|
-| **Đọc code của bạn** | ✅ Phân tích sâu (55–95 danh mục) | ❌ Tiêm hành vi | ❌ Viết thủ công | ❌ Template có sẵn |
-| **Đầ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 |
+| | ClaudeOS-Core | Everything Claude Code (50K+ ⭐) | Harness | specs-generator | Claude `/init` |
+|---|---|---|---|---|---|
+| **Approach** | Code analyzes first, then LLM generates | Pre-built config presets | LLM designs agent teams | LLM generates spec docs | LLM writes CLAUDE.md |
+| **Reads your source code** | ✅ Deterministic static analysis | ❌ | ❌ | ❌ (LLM reads) | ❌ (LLM reads) |
+| **Stack detection** | Code confirms (ORM, DB, build tool, pkg manager) | N/A (stack-agnostic) | LLM guesses | LLM guesses | LLM guesses |
+| **Domain detection** | Code confirms (Java 5 patterns, Kotlin CQRS, Next.js FSD) | N/A | LLM guesses | N/A | N/A |
+| **Same project → Same result** | ✅ Deterministic analysis | ✅ (static files) | ❌ (LLM varies) | ❌ (LLM varies) | ❌ (LLM varies) |
+| **Large project handling** | Domain group splitting (4 domains / 40 files per group) | N/A | No splitting | No splitting | Context window limit |
+| **Output** | CLAUDE.md + Rules + Standards + Skills + Guides + Plans (40-50+ files) | Agents + Skills + Commands + Hooks | Agents + Skills | 6 spec documents | CLAUDE.md (1 file) |
+| **Output location** | `.claude/rules/` (auto-loaded by Claude Code) | `.claude/` various | `.claude/agents/` + `.claude/skills/` | `.claude/steering/` + `specs/` | `CLAUDE.md` |
+| **Post-generation verification** | ✅ 5 automated validators | ❌ | ❌ | ❌ | ❌ |
+| **Multi-language output** | ✅ 10 languages | ❌ | ❌ | ❌ | ❌ |
+| **Multi-stack** | ✅ Backend + Frontend simultaneous | ❌ Stack-agnostic | ❌ | ❌ | Partial |
+| **Agent orchestration** | ❌ | ✅ 28 agents | ✅ 6 patterns | ❌ | ❌ |
 
----
+### Key difference
 
+**Other tools give Claude "generally good instructions." ClaudeOS-Core gives Claude "instructions extracted from your actual code."**
+
+### Complementary, not competing
+
+ClaudeOS-Core: **project-specific rules**. Other tools: **agent orchestration**.
+Use both together.
+
+---
 ## FAQ
 
 **H: Nó có sửa đổi mã nguồn của tôi không?**