claudeos-core 1.5.0 → 1.6.0

package/README.md

@@ -75,14 +75,16 @@ This difference compounds. 10 tasks/day × 20 minutes saved = **3+ hours/day**.
 |---|---|---|
 | **Java / Spring Boot** | `build.gradle`, `pom.xml`, 5 package patterns | 10 categories, 59 sub-items |
 | **Kotlin / Spring Boot** | `build.gradle.kts`, kotlin plugin, `settings.gradle.kts`, CQRS/BFF auto-detect | 12 categories, 95 sub-items |
-| **Node.js / Express / NestJS** | `package.json` | 9 categories, 57 sub-items |
-| **Next.js / React / Vue** | `package.json`, `next.config.*`, FSD support | 9 categories, 55 sub-items |
+| **Node.js / Express** | `package.json` | 9 categories, 57 sub-items |
+| **Node.js / NestJS** | `package.json` (`@nestjs/core`) | 10 categories, 68 sub-items |
+| **Next.js / React** | `package.json`, `next.config.*`, FSD support | 9 categories, 55 sub-items |
+| **Vue / Nuxt** | `package.json`, `nuxt.config.*`, Composition API | 9 categories, 58 sub-items |
 | **Python / Django** | `requirements.txt`, `pyproject.toml` | 10 categories, 55 sub-items |
 | **Python / FastAPI** | `requirements.txt`, `pyproject.toml` | 10 categories, 58 sub-items |
 | **Node.js / Fastify** | `package.json` | 10 categories, 62 sub-items |
 | **Angular** | `package.json`, `angular.json` | 12 categories, 78 sub-items |
 
-Auto-detected: language & version, framework & version, ORM (MyBatis, JPA, Exposed, Prisma, TypeORM, SQLAlchemy, etc.), database (PostgreSQL, MySQL, Oracle, MongoDB, SQLite), package manager (Gradle, Maven, npm, yarn, pnpm, pip, poetry), architecture (CQRS, BFF — from module names), multi-module structure (from settings.gradle).
+Auto-detected: language & version, framework & version, ORM (MyBatis, JPA, Exposed, Prisma, TypeORM, SQLAlchemy, etc.), database (PostgreSQL, MySQL, Oracle, MongoDB, SQLite), package manager (Gradle, Maven, npm, yarn, pnpm, pip, poetry), architecture (CQRS, BFF — from module names), multi-module structure (from settings.gradle), monorepo (Turborepo, pnpm-workspace, Lerna, npm/yarn workspaces).
 
 **You don't specify anything. It's all detected automatically.**
 
@@ -96,7 +98,7 @@ Auto-detected: language & version, framework & version, ORM (MyBatis, JPA, Expos
 | E | DDD/Hexagonal | `{domain}/adapter/in/web/` | `user/adapter/in/web/UserController.java` |
 | C | Flat | `controller/*.java` | `controller/UserController.java` → extracts `user` from class name |
 
-Service-only domains (without controllers) are also detected via `service/`, `dao/`, `aggregator/`, `mapper/`, `repository/` directories. Skips: `common`, `config`, `util`, `core`, `front`, `admin`, `v1`, `v2`, etc.
+Service-only domains (without controllers) are also detected via `service/`, `dao/`, `aggregator/`, `facade/`, `usecase/`, `orchestrator/`, `mapper/`, `repository/` directories. Skips: `common`, `config`, `util`, `core`, `front`, `admin`, `v1`, `v2`, etc.
 
 ### Kotlin Multi-Module Domain Detection
 
@@ -192,7 +194,7 @@ 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.
+That's it. After 5–18 minutes, all documentation is generated and ready to use. The CLI shows elapsed time per pass and total time in the completion banner.
 
 ### Manual Step-by-Step Installation
 
@@ -583,9 +585,18 @@ Yes, recommended. Your team can share the same Claude Code standards. Consider a
 **Q: What about mixed-stack projects (e.g., Java backend + React frontend)?**
 Fully supported. ClaudeOS-Core auto-detects both stacks, tags domains as `backend` or `frontend`, and uses stack-specific analysis prompts for each. Pass 2 merges everything, and Pass 3 generates both backend and frontend standards in one pass.
 
+**Q: Does it work with Turborepo / pnpm workspaces / Lerna monorepos?**
+Yes. ClaudeOS-Core detects `turbo.json`, `pnpm-workspace.yaml`, `lerna.json`, or `package.json#workspaces` and automatically scans sub-package `package.json` files for framework/ORM/DB dependencies. Domain scanning covers `apps/*/src/` and `packages/*/src/` patterns. Run from the monorepo root.
+
 **Q: What happens on re-run?**
 If previous Pass 1/2 results exist, an interactive prompt lets you choose: **Continue** (resume from where it stopped) or **Fresh** (delete all and start over). Use `--force` to skip the prompt and always start fresh. Pass 3 always re-runs. Previous versions can be restored from Master Plans.
 
+**Q: Does NestJS get its own template or use the Express one?**
+NestJS uses a dedicated `node-nestjs` template with NestJS-specific analysis categories: `@Module`, `@Injectable`, `@Controller` decorators, Guards, Pipes, Interceptors, DI container, CQRS patterns, and `Test.createTestingModule`. Express projects use the separate `node-express` template.
+
+**Q: What about Vue / Nuxt projects?**
+Vue/Nuxt uses a dedicated `vue-nuxt` template covering Composition API, `<script setup>`, defineProps/defineEmits, Pinia stores, `useFetch`/`useAsyncData`, Nitro server routes, and `@nuxt/test-utils`. Next.js/React projects use the `node-nextjs` template.
+
 **Q: Does it support Kotlin?**
 Yes. ClaudeOS-Core auto-detects Kotlin from `build.gradle.kts` or the kotlin plugin in `build.gradle`. It uses a dedicated `kotlin-spring` template with Kotlin-specific analysis (data classes, sealed classes, coroutines, extension functions, MockK, etc.).
 
@@ -604,50 +615,66 @@ pass-prompts/templates/
 ├── common/                  # Shared header/footer
 ├── java-spring/             # Java / Spring Boot
 ├── kotlin-spring/           # Kotlin / Spring Boot (CQRS, BFF, multi-module)
-├── node-express/            # Node.js / Express / NestJS
+├── node-express/            # Node.js / Express
+├── node-nestjs/             # Node.js / NestJS (Module, DI, Guard, Pipe, Interceptor)
 ├── node-fastify/            # Node.js / Fastify
-├── node-nextjs/             # Next.js / React / Vue
+├── node-nextjs/             # Next.js / React
+├── vue-nuxt/                # Vue / Nuxt (Composition API, Pinia, Nitro)
 ├── angular/                 # Angular
 ├── python-django/           # Python / Django (DRF)
 └── python-fastapi/          # Python / FastAPI
 ```
 
-`plan-installer` auto-detects your stack(s), then assembles type-specific prompts. For multi-stack projects, separate `pass1-backend-prompt.md` and `pass1-frontend-prompt.md` are generated, while `pass3-prompt.md` combines both stacks' generation targets.
+`plan-installer` auto-detects your stack(s), then assembles type-specific prompts. NestJS and Vue/Nuxt use dedicated templates with framework-specific analysis categories (e.g., `@Module`/`@Injectable`/Guards for NestJS, `<script setup>`/Pinia/useFetch for Vue). For multi-stack projects, separate `pass1-backend-prompt.md` and `pass1-frontend-prompt.md` are generated, while `pass3-prompt.md` combines both stacks' generation targets.
 
 ---
 
 ## Monorepo Support
 
-ClaudeOS-Core reads the `package.json` in the **current directory**. In monorepo setups (Turborepo, Nx, Lerna, pnpm workspaces), the root `package.json` often doesn't contain framework dependencies like `next`, `express`, or `react` — they live in individual app directories.
+ClaudeOS-Core automatically detects JS/TS monorepo setups and scans sub-packages for dependencies.
 
-**Run ClaudeOS-Core from the app directory, not the monorepo root:**
+**Supported monorepo markers** (auto-detected):
+- `turbo.json` (Turborepo)
+- `pnpm-workspace.yaml` (pnpm workspaces)
+- `lerna.json` (Lerna)
+- `package.json#workspaces` (npm/yarn workspaces)
 
-```bash
-# Example: Turborepo with apps/my-app
-cd apps/my-app
-npx claudeos-core init
+**Run from the monorepo root** — ClaudeOS-Core reads `apps/*/package.json` and `packages/*/package.json` to discover framework/ORM/DB dependencies across sub-packages:
 
-# Example: Nx workspace
-cd apps/frontend
+```bash
+cd my-monorepo
 npx claudeos-core init
 ```
 
-Each app gets its own independent set of Standards, Rules, Skills, and Guides tailored to that specific app's stack and patterns.
+**What gets detected:**
+- Dependencies from `apps/web/package.json` (e.g., `next`, `react`) → frontend stack
+- Dependencies from `apps/api/package.json` (e.g., `express`, `prisma`) → backend stack
+- Dependencies from `packages/db/package.json` (e.g., `drizzle-orm`) → ORM/DB
+- Custom workspace paths from `pnpm-workspace.yaml` (e.g., `services/*`)
 
-**Typical monorepo structure:**
+**Domain scanning also covers monorepo layouts:**
+- `apps/api/src/modules/*/` and `apps/api/src/*/` for backend domains
+- `apps/web/app/*/`, `apps/web/src/app/*/`, `apps/web/pages/*/` for frontend domains
+- `packages/*/src/*/` for shared package domains
 
 ```
-my-monorepo/                    ← Don't run here (root has no framework deps)
+my-monorepo/                    ← Run here: npx claudeos-core init
+├── turbo.json                  ← Auto-detected as Turborepo
 ├── apps/
-│   ├── web/                    ← Run here: cd apps/web && npx claudeos-core init
-│   ├── api/                    ← Run here: cd apps/api && npx claudeos-core init
-│   └── storybook/
+│   ├── web/                    ← Next.js detected from apps/web/package.json
+│   │   ├── app/dashboard/      ← Frontend domain detected
+│   │   └── package.json        ← { "dependencies": { "next": "^14" } }
+│   └── api/                    ← Express detected from apps/api/package.json
+│       ├── src/modules/users/  ← Backend domain detected
+│       └── package.json        ← { "dependencies": { "express": "^4" } }
 ├── packages/
-│   ├── ui/
-│   └── utils/
-└── package.json                ← Only has devDependencies (turbo, eslint, etc.)
+│   ├── db/                     ← Drizzle detected from packages/db/package.json
+│   └── ui/
+└── package.json                ← { "workspaces": ["apps/*", "packages/*"] }
 ```
 
+> **Note:** For Kotlin/Java monorepos, multi-module detection uses `settings.gradle.kts` (see [Kotlin Multi-Module Detection](#kotlin-multi-module-domain-detection) above) and does not require JS monorepo markers.
+
 ## Troubleshooting
 
 **"claude: command not found"** — Claude Code CLI is not installed or not in PATH. See [Claude Code docs](https://code.claude.com/docs/en/overview).
@@ -670,7 +697,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** — Expanding test suite (currently 87 tests covering stack detection, domain grouping, plan validation, structure scanning, and verification tools)
+- **Test coverage** — Expanding test suite (currently 256 tests covering all scanners, stack detection, domain grouping, plan parsing, prompt generation, CLI selectors, monorepo detection, and verification tools)
 
 ---
 

package/README.ru.md

@@ -65,14 +65,16 @@ ClaudeOS-Core создаёт документацию, которая знает
 |---|---|---|
 | **Java / Spring Boot** | `build.gradle`, `pom.xml`, 5 паттернов пакетов | 10 категорий, 59 подпунктов |
 | **Kotlin / Spring Boot** | `build.gradle.kts`, kotlin plugin, `settings.gradle.kts`, CQRS/BFF auto-detect | 12 категорий, 95 подпунктов |
-| **Node.js / Express / NestJS** | `package.json` | 9 категорий, 57 подпунктов |
-| **Next.js / React / Vue** | `package.json`, `next.config.*`, поддержка FSD | 9 категорий, 55 подпунктов |
+| **Node.js / Express** | `package.json` | 9 категорий, 57 подпунктов |
+| **Node.js / NestJS** | `package.json` (`@nestjs/core`) | 10 категорий, 68 подпунктов |
+| **Next.js / React** | `package.json`, `next.config.*`, поддержка FSD | 9 категорий, 55 подпунктов |
+| **Vue / Nuxt** | `package.json`, `nuxt.config.*`, Composition API | 9 категорий, 58 подпунктов |
 | **Python / Django** | `requirements.txt`, `pyproject.toml` | 10 категорий, 55 подпунктов |
 | **Python / FastAPI** | `requirements.txt`, `pyproject.toml` | 10 категорий, 58 подпунктов |
 | **Node.js / Fastify** | `package.json` | 10 категорий, 62 подпункта |
 | **Angular** | `package.json`, `angular.json` | 12 категорий, 78 подпунктов |
 
-Автоматическое определение: язык и версия, фреймворк и версия, ORM (MyBatis, JPA, Exposed, Prisma, TypeORM, SQLAlchemy и др.), база данных (PostgreSQL, MySQL, Oracle, MongoDB, SQLite), пакетный менеджер (Gradle, Maven, npm, yarn, pnpm, pip, poetry), архитектура (CQRS, BFF — определяется из имён модулей), мультимодульная структура (из settings.gradle).
+Автоматическое определение: язык и версия, фреймворк и версия, ORM (MyBatis, JPA, Exposed, Prisma, TypeORM, SQLAlchemy и др.), база данных (PostgreSQL, MySQL, Oracle, MongoDB, SQLite), пакетный менеджер (Gradle, Maven, npm, yarn, pnpm, pip, poetry), архитектура (CQRS, BFF — определяется из имён модулей), мультимодульная структура (из settings.gradle), монорепозиторий (Turborepo, pnpm-workspace, Lerna, npm/yarn workspaces).
 
 **Вам не нужно ничего указывать. Всё определяется автоматически.**
 
@@ -87,7 +89,7 @@ ClaudeOS-Core создаёт документацию, которая знает
 | E | DDD/Гексагональный | `{domain}/adapter/in/web/` | `user/adapter/in/web/UserController.java` |
 | C | Плоский | `controller/*.java` | `controller/UserController.java` → извлекает `user` из имени класса |
 
-Домены только с сервисами (без контроллеров) тоже обнаруживаются через директории `service/`, `dao/`, `aggregator/`, `mapper/`, `repository/`. Пропускаются: `common`, `config`, `util`, `core`, `front`, `admin`, `v1`, `v2` и т.д.
+Домены только с сервисами (без контроллеров) тоже обнаруживаются через директории `service/`, `dao/`, `aggregator/`, `facade/`, `usecase/`, `orchestrator/`, `mapper/`, `repository/`. Пропускаются: `common`, `config`, `util`, `core`, `front`, `admin`, `v1`, `v2` и т.д.
 
 
 ### Обнаружение доменов Kotlin мультимодульных проектов
@@ -178,7 +180,7 @@ npx claudeos-core init --lang ko    # 한국어
 
 > **Примечание:** Эта настройка изменяет только язык генерируемых файлов документации. Анализ кода (Pass 1–2) всегда выполняется на английском; только результат генерации (Pass 3) пишется на выбранном языке.
 
-Это всё. Через 5–18 минут вся документация сгенерирована и готова к использованию.
+Это всё. Через 5–18 минут вся документация сгенерирована и готова к использованию. CLI показывает время каждого Pass и общее время в баннере завершения.
 
 ### Ручная пошаговая установка
 
@@ -530,6 +532,15 @@ Use both together.
 **В: Что происходит при повторном запуске?**
 Если предыдущие результаты Pass 1/2 существуют, интерактивный промпт позволяет выбрать: **Continue** (продолжить с места остановки) или **Fresh** (удалить всё и начать заново). Используйте `--force`, чтобы пропустить промпт и всегда начинать заново. Pass 3 всегда перезапускается. Предыдущие версии можно восстановить из Master Plans.
 
+**В: Работает ли с Turborepo / pnpm workspaces / Lerna monorepo?**
+Да. ClaudeOS-Core определяет `turbo.json`, `pnpm-workspace.yaml`, `lerna.json` или `package.json#workspaces` и автоматически сканирует `package.json` подпакетов для обнаружения зависимостей фреймворков/ORM/БД. Сканирование доменов охватывает паттерны `apps/*/src/` и `packages/*/src/`. Запускайте из корня monorepo.
+
+**В: Использует ли NestJS собственный шаблон или шаблон Express?**
+NestJS использует выделенный шаблон `node-nestjs` с NestJS-специфичными категориями анализа: декораторы `@Module`, `@Injectable`, `@Controller`, Guards, Pipes, Interceptors, DI-контейнер, паттерны CQRS и `Test.createTestingModule`. Проекты Express используют отдельный шаблон `node-express`.
+
+**В: Как насчёт проектов Vue / Nuxt?**
+Vue/Nuxt использует выделенный шаблон `vue-nuxt`, охватывающий Composition API, `<script setup>`, defineProps/defineEmits, хранилища Pinia, `useFetch`/`useAsyncData`, серверные маршруты Nitro и `@nuxt/test-utils`. Проекты Next.js/React используют шаблон `node-nextjs`.
+
 **В: Поддерживается ли Kotlin?**
 Да. ClaudeOS-Core автоматически определяет Kotlin из `build.gradle.kts` или плагина kotlin в `build.gradle`. Используется специальный шаблон `kotlin-spring` с Kotlin-специфичным анализом (data class, sealed class, корутины, функции-расширения, MockK и т.д.).
 
@@ -548,50 +559,66 @@ pass-prompts/templates/
 ├── common/                  # Общий заголовок/футер
 ├── java-spring/             # Java / Spring Boot
 ├── kotlin-spring/           # Kotlin / Spring Boot (CQRS, BFF, multi-module)
-├── node-express/            # Node.js / Express / NestJS
-├── node-nextjs/             # Next.js / React / Vue
-├── python-django/           # Python / Django (DRF)
+├── node-express/            # Node.js / Express
+├── node-nestjs/             # Node.js / NestJS (Module, DI, Guard, Pipe, Interceptor)
 ├── node-fastify/            # Node.js / Fastify
+├── node-nextjs/             # Next.js / React
+├── vue-nuxt/                # Vue / Nuxt (Composition API, Pinia, Nitro)
 ├── angular/                 # Angular
+├── python-django/           # Python / Django (DRF)
 └── python-fastapi/          # Python / FastAPI
 ```
 
-`plan-installer` автоматически определяет ваш стек(и) и собирает типо-специфичные промпты. Для мульти-стек проектов генерируются отдельные `pass1-backend-prompt.md` и `pass1-frontend-prompt.md`, а `pass3-prompt.md` объединяет цели генерации обоих стеков.
+`plan-installer` автоматически определяет ваш стек(и) и собирает типо-специфичные промпты. NestJS и Vue/Nuxt используют выделенные шаблоны с фреймворк-специфичными категориями анализа (например, `@Module`/`@Injectable`/Guards для NestJS, `<script setup>`/Pinia/useFetch для Vue). Для мульти-стек проектов генерируются отдельные `pass1-backend-prompt.md` и `pass1-frontend-prompt.md`, а `pass3-prompt.md` объединяет цели генерации обоих стеков.
 
 ---
 
 ## Поддержка Monorepo
 
-ClaudeOS-Core читает `package.json` в **текущей директории**. В monorepo (Turborepo, Nx, Lerna, pnpm workspaces) корневой `package.json` обычно не содержит зависимостей фреймворков, таких как `next`, `express`, `react` — они находятся в директориях отдельных приложений.
+ClaudeOS-Core автоматически определяет JS/TS monorepo-структуры и сканирует подпакеты для обнаружения зависимостей.
 
-**Запускайте ClaudeOS-Core из директории приложения, а не из корня monorepo:**
+**Поддерживаемые маркеры monorepo** (определяются автоматически):
+- `turbo.json` (Turborepo)
+- `pnpm-workspace.yaml` (pnpm workspaces)
+- `lerna.json` (Lerna)
+- `package.json#workspaces` (npm/yarn workspaces)
 
-```bash
-# Пример: Turborepo с apps/my-app
-cd apps/my-app
-npx claudeos-core init
+**Запускайте из корня monorepo** — ClaudeOS-Core читает `apps/*/package.json` и `packages/*/package.json` для обнаружения зависимостей фреймворков/ORM/БД по всем подпакетам:
 
-# Пример: Nx workspace
-cd apps/frontend
+```bash
+cd my-monorepo
 npx claudeos-core init
 ```
 
-Каждое приложение получает собственный независимый набор Standards, Rules, Skills и Guides, адаптированных под стек и паттерны конкретного приложения.
+**Что обнаруживается:**
+- Зависимости из `apps/web/package.json` (например, `next`, `react`) — frontend-стек
+- Зависимости из `apps/api/package.json` (например, `express`, `prisma`) — backend-стек
+- Зависимости из `packages/db/package.json` (например, `drizzle-orm`) — ORM/БД
+- Пользовательские пути воркспейсов из `pnpm-workspace.yaml` (например, `services/*`)
 
-**Типичная структура monorepo:**
+**Сканирование доменов также охватывает monorepo-структуры:**
+- `apps/api/src/modules/*/` и `apps/api/src/*/` для backend-доменов
+- `apps/web/app/*/`, `apps/web/src/app/*/`, `apps/web/pages/*/` для frontend-доменов
+- `packages/*/src/*/` для доменов общих пакетов
 
 ```
-my-monorepo/                    ← Не запускайте здесь (в корне нет зависимостей фреймворков)
+my-monorepo/                    ← Запускайте здесь: npx claudeos-core init
+├── turbo.json                  ← Автоопределение как Turborepo
 ├── apps/
-│   ├── web/                    ← Запускайте здесь: cd apps/web && npx claudeos-core init
-│   ├── api/                    ← Запускайте здесь: cd apps/api && npx claudeos-core init
-│   └── storybook/
+│   ├── web/                    ← Next.js определён из apps/web/package.json
+│   │   ├── app/dashboard/      ← Frontend-домен обнаружен
+│   │   └── package.json        ← { "dependencies": { "next": "^14" } }
+│   └── api/                    ← Express определён из apps/api/package.json
+│       ├── src/modules/users/  ← Backend-домен обнаружен
+│       └── package.json        ← { "dependencies": { "express": "^4" } }
 ├── packages/
-│   ├── ui/
-│   └── utils/
-└── package.json                ← Только devDependencies (turbo, eslint и т.д.)
+│   ├── db/                     ← Drizzle определён из packages/db/package.json
+│   └── ui/
+└── package.json                ← { "workspaces": ["apps/*", "packages/*"] }
 ```
 
+> **Примечание:** Для Kotlin/Java monorepo мультимодульное определение использует `settings.gradle.kts` (см. [Обнаружение доменов Kotlin мультимодульных проектов](#обнаружение-доменов-kotlin-мультимодульных-проектов) выше) и не требует JS monorepo-маркеров.
+
 ## Устранение неполадок
 
 **"claude: command not found"** — Claude Code CLI не установлен или не в PATH. Смотрите [документацию Claude Code](https://code.claude.com/docs/en/overview).
@@ -614,7 +641,7 @@ my-monorepo/                    ← Не запускайте здесь (в к
 
 - **Новые шаблоны стеков** — Ruby/Rails, Go/Gin, PHP/Laravel, Rust/Axum
 - **Глубокая поддержка монорепо** — Отдельные корни подпроектов, обнаружение воркспейсов
-- **Покрытие тестами** — Расширение набора тестов (сейчас 87 тестов, покрывающих обнаружение стека, группировку доменов, валидацию планов, сканирование структуры и инструменты проверки)
+- **Покрытие тестами** — Расширение набора тестов (сейчас 256 тестов, покрывающих все сканеры, обнаружение стека, группировку доменов, парсинг планов, генерацию промптов, селекторы CLI, обнаружение monorepo и инструменты проверки)
 
 ---
 

package/README.vi.md

@@ -65,14 +65,16 @@ Sự khác biệt này tích lũy. 10 task/ngày × 20 phút tiết kiệm = **h
 |---|---|---|
 | **Java / Spring Boot** | `build.gradle`, `pom.xml`, 5 package patterns | 10 danh mục, 59 mục con |
 | **Kotlin / Spring Boot** | `build.gradle.kts`, kotlin plugin, `settings.gradle.kts`, CQRS/BFF auto-detect | 12 danh mục, 95 mục con |
-| **Node.js / Express / NestJS** | `package.json` | 9 danh mục, 57 mục con |
-| **Next.js / React / Vue** | `package.json`, `next.config.*`, hỗ trợ FSD | 9 danh mục, 55 mục con |
+| **Node.js / Express** | `package.json` | 9 danh mục, 57 mục con |
+| **Node.js / NestJS** | `package.json` (`@nestjs/core`) | 10 danh mục, 68 mục con |
+| **Next.js / React** | `package.json`, `next.config.*`, hỗ trợ FSD | 9 danh mục, 55 mục con |
+| **Vue / Nuxt** | `package.json`, `nuxt.config.*`, Composition API | 9 danh mục, 58 mục con |
 | **Python / Django** | `requirements.txt`, `pyproject.toml` | 10 danh mục, 55 mục con |
 | **Python / FastAPI** | `requirements.txt`, `pyproject.toml` | 10 danh mục, 58 mục con |
 | **Node.js / Fastify** | `package.json` | 10 danh mục, 62 mục con |
 | **Angular** | `package.json`, `angular.json` | 12 danh mục, 78 mục con |
 
-Tự động phát hiện: ngôn ngữ & phiên bản, framework & phiên bản, ORM (MyBatis, JPA, Exposed, Prisma, TypeORM, SQLAlchemy, v.v.), database (PostgreSQL, MySQL, Oracle, MongoDB, SQLite), package manager (Gradle, Maven, npm, yarn, pnpm, pip, poetry), kiến trúc (CQRS, BFF — phát hiện từ tên module), cấu trúc multi-module (từ settings.gradle).
+Tự động phát hiện: ngôn ngữ & phiên bản, framework & phiên bản, ORM (MyBatis, JPA, Exposed, Prisma, TypeORM, SQLAlchemy, v.v.), database (PostgreSQL, MySQL, Oracle, MongoDB, SQLite), package manager (Gradle, Maven, npm, yarn, pnpm, pip, poetry), kiến trúc (CQRS, BFF — phát hiện từ tên module), cấu trúc multi-module (từ settings.gradle), monorepo (Turborepo, pnpm-workspace, Lerna, npm/yarn workspaces).
 
 **Bạn không cần chỉ định gì cả. Tất cả được phát hiện tự động.**
 
@@ -87,7 +89,7 @@ Tự động phát hiện: ngôn ngữ & phiên bản, framework & phiên bản,
 | E | DDD/Hexagonal | `{domain}/adapter/in/web/` | `user/adapter/in/web/UserController.java` |
 | C | Phẳng | `controller/*.java` | `controller/UserController.java` → trích `user` từ tên class |
 
-Các domain chỉ có service (không có controller) cũng được phát hiện qua thư mục `service/`, `dao/`, `aggregator/`, `mapper/`, `repository/`. Bỏ qua: `common`, `config`, `util`, `core`, `front`, `admin`, `v1`, `v2`, v.v.
+Các domain chỉ có service (không có controller) cũng được phát hiện qua thư mục `service/`, `dao/`, `aggregator/`, `facade/`, `usecase/`, `orchestrator/`, `mapper/`, `repository/`. Bỏ qua: `common`, `config`, `util`, `core`, `front`, `admin`, `v1`, `v2`, v.v.
 
 
 ### Phát Hiện Domain Kotlin Multi-Module
@@ -178,7 +180,7 @@ 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.
+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. CLI hiển thị thời gian mỗi Pass và tổng thời gian trong banner hoàn thành.
 
 ### Cài Đặt Thủ Công Từng Bước
 
@@ -530,6 +532,15 @@ Hỗ trợ hoàn toàn. ClaudeOS-Core tự phát hiện cả hai stack, gắn ta
 **H: Chạy lại thì sao?**
 Nếu kết quả Pass 1/2 trước đó tồn tại, prompt tương tác cho phép bạn chọn: **Continue** (tiếp tục từ nơi dừng lại) hoặc **Fresh** (xóa tất cả và bắt đầu lại). Dùng `--force` để bỏ qua prompt và luôn bắt đầu lại từ đầu. Pass 3 luôn chạy lại. Phiên bản trước có thể khôi phục từ Master Plans.
 
+**H: Có hoạt động với Turborepo / pnpm workspaces / Lerna monorepo không?**
+Có. ClaudeOS-Core phát hiện `turbo.json`, `pnpm-workspace.yaml`, `lerna.json`, hoặc `package.json#workspaces` và tự động quét file `package.json` của sub-package để tìm dependency framework/ORM/DB. Quét domain bao gồm pattern `apps/*/src/` và `packages/*/src/`. Chạy từ thư mục gốc monorepo.
+
+**H: NestJS có template riêng hay dùng chung với Express?**
+NestJS sử dụng template `node-nestjs` chuyên dụng với các danh mục phân tích riêng cho NestJS: decorator `@Module`, `@Injectable`, `@Controller`, Guards, Pipes, Interceptors, DI container, pattern CQRS, và `Test.createTestingModule`. Dự án Express sử dụng template `node-express` riêng biệt.
+
+**H: Dự án Vue / Nuxt thì sao?**
+Vue/Nuxt sử dụng template `vue-nuxt` chuyên dụng bao gồm Composition API, `<script setup>`, defineProps/defineEmits, Pinia stores, `useFetch`/`useAsyncData`, Nitro server routes, và `@nuxt/test-utils`. Dự án Next.js/React sử dụng template `node-nextjs`.
+
 **H: Có hỗ trợ Kotlin không?**
 Có. ClaudeOS-Core tự động phát hiện Kotlin từ `build.gradle.kts` hoặc kotlin plugin trong `build.gradle`. Sử dụng template chuyên dụng `kotlin-spring` để phân tích các pattern đặc thù của Kotlin (data class, sealed class, coroutine, extension function, MockK, v.v.).
 
@@ -548,50 +559,66 @@ pass-prompts/templates/
 ├── common/                  # Header/footer chung
 ├── java-spring/             # Java / Spring Boot
 ├── kotlin-spring/           # Kotlin / Spring Boot (CQRS, BFF, multi-module)
-├── node-express/            # Node.js / Express / NestJS
-├── node-nextjs/             # Next.js / React / Vue
-├── python-django/           # Python / Django (DRF)
+├── node-express/            # Node.js / Express
+├── node-nestjs/             # Node.js / NestJS (Module, DI, Guard, Pipe, Interceptor)
 ├── node-fastify/            # Node.js / Fastify
+├── node-nextjs/             # Next.js / React
+├── vue-nuxt/                # Vue / Nuxt (Composition API, Pinia, Nitro)
 ├── angular/                 # Angular
+├── python-django/           # Python / Django (DRF)
 └── python-fastapi/          # Python / FastAPI
 ```
 
-`plan-installer` tự phát hiện stack của bạn, sau đó lắp ráp prompt theo loại. Với dự án multi-stack, `pass1-backend-prompt.md` và `pass1-frontend-prompt.md` được tạo riêng, trong khi `pass3-prompt.md` kết hợp mục tiêu tạo file của cả hai stack.
+`plan-installer` tự phát hiện stack của bạn, sau đó lắp ráp prompt theo loại. NestJS và Vue/Nuxt sử dụng template chuyên dụng với các danh mục phân tích riêng cho từng framework (ví dụ: `@Module`/`@Injectable`/Guards cho NestJS, `<script setup>`/Pinia/useFetch cho Vue). Với dự án multi-stack, `pass1-backend-prompt.md` và `pass1-frontend-prompt.md` được tạo riêng, trong khi `pass3-prompt.md` kết hợp mục tiêu tạo file của cả hai stack.
 
 ---
 
 ## Hỗ Trợ Monorepo
 
-ClaudeOS-Core đọc `package.json` trong **thư mục hiện tại**. Trong các thiết lập monorepo (Turborepo, Nx, Lerna, pnpm workspaces), `package.json` gốc thường không chứa các dependency framework như `next`, `express`, `react` — chúng nằm trong các thư mục app riêng lẻ.
+ClaudeOS-Core tự động phát hiện thiết lập monorepo JS/TS và quét các sub-package để tìm dependency.
 
-**Chạy ClaudeOS-Core từ thư mục app, không phải gốc monorepo:**
+**Monorepo marker được hỗ trợ** (tự động phát hiện):
+- `turbo.json` (Turborepo)
+- `pnpm-workspace.yaml` (pnpm workspaces)
+- `lerna.json` (Lerna)
+- `package.json#workspaces` (npm/yarn workspaces)
 
-```bash
-# Ví dụ: Turborepo với apps/my-app
-cd apps/my-app
-npx claudeos-core init
+**Chạy từ thư mục gốc monorepo** — ClaudeOS-Core đọc `apps/*/package.json` và `packages/*/package.json` để tìm dependency framework/ORM/DB trong các sub-package:
 
-# Ví dụ: Nx workspace
-cd apps/frontend
+```bash
+cd my-monorepo
 npx claudeos-core init
 ```
 
-Mỗi app nhận được bộ Standards, Rules, Skills và Guides độc lập, được tùy chỉnh cho stack và pattern của app cụ thể đó.
+**Những gì được phát hiện:**
+- Dependency từ `apps/web/package.json` (ví dụ: `next`, `react`) → frontend stack
+- Dependency từ `apps/api/package.json` (ví dụ: `express`, `prisma`) → backend stack
+- Dependency từ `packages/db/package.json` (ví dụ: `drizzle-orm`) → ORM/DB
+- Đường dẫn workspace tùy chỉnh từ `pnpm-workspace.yaml` (ví dụ: `services/*`)
 
-**Cấu trúc monorepo điển hình:**
+**Quét domain cũng bao gồm cấu trúc monorepo:**
+- `apps/api/src/modules/*/` và `apps/api/src/*/` cho domain backend
+- `apps/web/app/*/`, `apps/web/src/app/*/`, `apps/web/pages/*/` cho domain frontend
+- `packages/*/src/*/` cho domain package chia sẻ
 
 ```
-my-monorepo/                    ← Đừng chạy ở đây (gốc không có framework deps)
+my-monorepo/                    ← Chạy ở đây: npx claudeos-core init
+├── turbo.json                  ← Tự động phát hiện là Turborepo
 ├── apps/
-│   ├── web/                    ← Chạy ở đây: cd apps/web && npx claudeos-core init
-│   ├── api/                    ← Chạy ở đây: cd apps/api && npx claudeos-core init
-│   └── storybook/
+│   ├── web/                    ← Next.js phát hiện từ apps/web/package.json
+│   │   ├── app/dashboard/      ← Domain frontend được phát hiện
+│   │   └── package.json        ← { "dependencies": { "next": "^14" } }
+│   └── api/                    ← Express phát hiện từ apps/api/package.json
+│       ├── src/modules/users/  ← Domain backend được phát hiện
+│       └── package.json        ← { "dependencies": { "express": "^4" } }
 ├── packages/
-│   ├── ui/
-│   └── utils/
-└── package.json                ← Chỉ có devDependencies (turbo, eslint, v.v.)
+│   ├── db/                     ← Drizzle phát hiện từ packages/db/package.json
+│   └── ui/
+└── package.json                ← { "workspaces": ["apps/*", "packages/*"] }
 ```
 
+> **Lưu ý:** Với monorepo Kotlin/Java, phát hiện multi-module sử dụng `settings.gradle.kts` (xem [Phát Hiện Domain Kotlin Multi-Module](#phát-hiện-domain-kotlin-multi-module) ở trên) và không yêu cầu JS monorepo marker.
+
 ## Xử Lý Sự Cố
 
 **"claude: command not found"** — Claude Code CLI chưa được cài đặt hoặc không nằm trong PATH. Xem [tài liệu Claude Code](https://code.claude.com/docs/en/overview).
@@ -614,7 +641,7 @@ Chào đón mọi đóng góp! Các lĩnh vực cần hỗ trợ nhất:
 
 - **Template stack mới** — Ruby/Rails, Go/Gin, PHP/Laravel, Rust/Axum
 - **Hỗ trợ monorepo sâu** — Root sub-project riêng, phát hiện workspace
-- **Độ phủ test** — Mở rộng bộ test (hiện tại 87 test bao gồm phát hiện stack, nhóm domain, xác thực plan, quét cấu trúc và công cụ xác thực)
+- **Độ phủ test** — Mở rộng bộ test (hiện tại 256 test bao gồm tất cả scanner, phát hiện stack, nhóm domain, phân tích plan, tạo prompt, bộ chọn CLI, phát hiện monorepo và công cụ xác thực)
 
 ---