claudeos-core 1.0.6 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [1.1.0] — 2026-04
+
+### Added
+- **Java 5-pattern domain detection** (A→B/D→E→C fallback):
+  - A: `controller/{domain}/` (layer-first)
+  - B: `{domain}/controller/` (domain-first)
+  - C: `controller/*.java` (flat, extract from class name)
+  - D: `{module}/{domain}/controller/` (module prefix, auto-upgrade on name conflict)
+  - E: `{domain}/adapter/in/web/` (DDD/hexagonal)
+- **Service-only domain detection**: Domains without controllers (e.g., `core/delivery/service/`) are now detected
+- **Frontend FSD support**: `features/*/`, `widgets/*/`, `entities/*/` (Feature-Sliced Design)
+- **RSC/Client component detection**: Counts `client.tsx` files, tracks RSC+Client split pattern per domain
+- **Config file fallback**: Detect Next.js/Vite/Nuxt from config files when framework not in package.json (monorepo support)
+- **Windows glob compatibility**: Direct file scan fallback for Java and Frontend when glob patterns fail on Windows
+- **Pipe-based prompt delivery**: Write prompt to temp file and pipe to `claude -p` to bypass Windows 8191-char command-line limit
+- **8 language READMEs**: Chinese, Japanese, Spanish, Vietnamese, Hindi, Russian, French, German
+- **Monorepo Support section** in all 10 READMEs (Turborepo, Nx, Lerna, pnpm workspaces)
+- **Cross-language navigation links** in all READMEs (Korean last position)
+- **Skip filters**: API version paths (`v1`, `v2`), module prefixes (`front`, `admin`, `back`) excluded from domain detection
+
+### Fixed
+- `frontend` variable reference before initialization (RSC stats)
+- npm bin path warning (`npm pkg fix`)
+
 ## [1.0.0] — 2025
 
 ### Added

package/CONTRIBUTING.md

@@ -5,9 +5,15 @@ Thank you for your interest in contributing! Here's how you can help.
 ## Areas Where Help Is Needed
 
 - **New stack templates** — Ruby/Rails, Go/Gin, PHP/Laravel, Rust/Axum
-- **Monorepo deep support** — Separate sub-project roots, workspace detection
+- **IDE integration** — VS Code extension, IntelliJ plugin
 - **Test coverage** — Unit tests for verification tools
-- **Localization** — README translations (Chinese, Japanese, Spanish, etc.)
+- **CI/CD templates** — GitHub Actions, GitLab CI integration examples
+- **Custom template authoring** — User-defined pass1/pass2/pass3 templates
+
+## What's Already Done (no longer needed)
+
+- ~~Monorepo deep support~~ — Implemented (Turborepo, Nx, Lerna, pnpm workspaces)
+- ~~Localization~~ — 10 languages available (EN, KO, ZH-CN, JA, ES, VI, HI, RU, FR, DE)
 
 ## How to Contribute
 

package/README.de.md

@@ -33,9 +33,9 @@ Gesamtzeit: **5–18 Minuten**, abhängig von der Projektgröße. Null manuelle
 
 | Stack | Erkennung | Analysetiefe |
 |---|---|---|
-| **Java / Spring Boot** | `build.gradle`, `pom.xml` | 10 Kategorien, 59 Unterpunkte |
+| **Java / Spring Boot** | `build.gradle`, `pom.xml`, 5 Paketmuster | 10 Kategorien, 59 Unterpunkte |
 | **Node.js / Express / NestJS** | `package.json` | 9 Kategorien, 57 Unterpunkte |
-| **Next.js / React / Vue** | `package.json` (next, react, vue) | 9 Kategorien, 55 Unterpunkte |
+| **Next.js / React / Vue** | `package.json`, `next.config.*`, FSD-Unterstützung | 9 Kategorien, 55 Unterpunkte |
 | **Python / Django** | `requirements.txt`, `pyproject.toml` | 10 Kategorien, 55 Unterpunkte |
 | **Python / FastAPI** | `requirements.txt`, `pyproject.toml` | 10 Kategorien, 58 Unterpunkte |
 
@@ -43,6 +43,27 @@ Automatisch erkannt: Sprache und Version, Framework und Version, ORM (MyBatis, J
 
 **Sie müssen nichts angeben. Alles wird automatisch erkannt.**
 
+
+### Java-Domain-Erkennung (5 Muster mit Fallback)
+
+| Priorität | Muster | Struktur | Beispiel |
+|---|---|---|---|
+| A | Layer-first | `controller/{domain}/` | `controller/user/UserController.java` |
+| B | Domain-first | `{domain}/controller/` | `user/controller/UserController.java` |
+| D | Modul-Präfix | `{module}/{domain}/controller/` | `front/member/controller/MemberController.java` |
+| E | DDD/Hexagonal | `{domain}/adapter/in/web/` | `user/adapter/in/web/UserController.java` |
+| C | Flach | `controller/*.java` | `controller/UserController.java` → extrahiert `user` aus Klassenname |
+
+Domains nur mit Services (ohne Controller) werden ebenfalls erkannt. Übersprungen: `common`, `config`, `util`, `front`, `admin`, `v1`, `v2` usw.
+
+### Frontend-Domain-Erkennung
+
+- **App Router**: `app/{domain}/page.tsx` (Next.js)
+- **Pages Router**: `pages/{domain}/index.tsx`
+- **FSD (Feature-Sliced Design)**: `features/*/`, `widgets/*/`, `entities/*/`
+- **RSC/Client-Split**: Erkennt `client.tsx`-Muster, verfolgt Server/Client-Trennung
+- **Config-Fallback**: Erkennt Next.js/Vite/Nuxt aus Config-Dateien (Monorepo-Unterstützung)
+
 ---
 
 ## Schnellstart

package/README.es.md

@@ -33,9 +33,9 @@ Tiempo total: **5–18 minutos**, según el tamaño del proyecto. Cero configura
 
 | Stack | Detección | Profundidad de Análisis |
 |---|---|---|
-| **Java / Spring Boot** | `build.gradle`, `pom.xml` | 10 categorías, 59 sub-ítems |
+| **Java / Spring Boot** | `build.gradle`, `pom.xml`, 5 patrones de paquete | 10 categorías, 59 sub-ítems |
 | **Node.js / Express / NestJS** | `package.json` | 9 categorías, 57 sub-ítems |
-| **Next.js / React / Vue** | `package.json` (next, react, vue) | 9 categorías, 55 sub-ítems |
+| **Next.js / React / Vue** | `package.json`, `next.config.*`, soporte FSD | 9 categorías, 55 sub-ítems |
 | **Python / Django** | `requirements.txt`, `pyproject.toml` | 10 categorías, 55 sub-ítems |
 | **Python / FastAPI** | `requirements.txt`, `pyproject.toml` | 10 categorías, 58 sub-ítems |
 
@@ -43,6 +43,27 @@ Detección automática: lenguaje y versión, framework y versión, ORM (MyBatis,
 
 **No necesitas especificar nada. Todo se detecta automáticamente.**
 
+
+### Detección de Dominios Java (5 patrones con fallback)
+
+| Prioridad | Patrón | Estructura | Ejemplo |
+|---|---|---|---|
+| A | Capa primero | `controller/{domain}/` | `controller/user/UserController.java` |
+| B | Dominio primero | `{domain}/controller/` | `user/controller/UserController.java` |
+| D | Prefijo de módulo | `{module}/{domain}/controller/` | `front/member/controller/MemberController.java` |
+| E | DDD/Hexagonal | `{domain}/adapter/in/web/` | `user/adapter/in/web/UserController.java` |
+| C | Plano | `controller/*.java` | `controller/UserController.java` → extrae `user` del nombre de clase |
+
+Los dominios solo con servicios (sin controladores) también se detectan. Se omiten: `common`, `config`, `util`, `front`, `admin`, `v1`, `v2`, etc.
+
+### Detección de Dominios Frontend
+
+- **App Router**: `app/{domain}/page.tsx` (Next.js)
+- **Pages Router**: `pages/{domain}/index.tsx`
+- **FSD (Feature-Sliced Design)**: `features/*/`, `widgets/*/`, `entities/*/`
+- **RSC/Client split**: Detecta patrón `client.tsx`, rastrea separación Server/Client
+- **Config fallback**: Detecta Next.js/Vite/Nuxt desde archivos de configuración (soporte monorepo)
+
 ---
 
 ## Inicio Rápido

package/README.fr.md

@@ -33,9 +33,9 @@ Temps total : **5–18 minutes**, selon la taille du projet. Zéro configuration
 
 | Stack | Détection | Profondeur d'Analyse |
 |---|---|---|
-| **Java / Spring Boot** | `build.gradle`, `pom.xml` | 10 catégories, 59 sous-éléments |
+| **Java / Spring Boot** | `build.gradle`, `pom.xml`, 5 patterns de paquets | 10 catégories, 59 sous-éléments |
 | **Node.js / Express / NestJS** | `package.json` | 9 catégories, 57 sous-éléments |
-| **Next.js / React / Vue** | `package.json` (next, react, vue) | 9 catégories, 55 sous-éléments |
+| **Next.js / React / Vue** | `package.json`, `next.config.*`, support FSD | 9 catégories, 55 sous-éléments |
 | **Python / Django** | `requirements.txt`, `pyproject.toml` | 10 catégories, 55 sous-éléments |
 | **Python / FastAPI** | `requirements.txt`, `pyproject.toml` | 10 catégories, 58 sous-éléments |
 
@@ -43,6 +43,27 @@ Détection automatique : langage et version, framework et version, ORM (MyBatis,
 
 **Vous n'avez rien à spécifier. Tout est détecté automatiquement.**
 
+
+### Détection des Domaines Java (5 patterns avec fallback)
+
+| Priorité | Pattern | Structure | Exemple |
+|---|---|---|---|
+| A | Couche d'abord | `controller/{domain}/` | `controller/user/UserController.java` |
+| B | Domaine d'abord | `{domain}/controller/` | `user/controller/UserController.java` |
+| D | Préfixe module | `{module}/{domain}/controller/` | `front/member/controller/MemberController.java` |
+| E | DDD/Hexagonal | `{domain}/adapter/in/web/` | `user/adapter/in/web/UserController.java` |
+| C | Plat | `controller/*.java` | `controller/UserController.java` → extrait `user` du nom de classe |
+
+Les domaines sans contrôleurs (service uniquement) sont aussi détectés. Ignorés : `common`, `config`, `util`, `front`, `admin`, `v1`, `v2`, etc.
+
+### Détection des Domaines Frontend
+
+- **App Router** : `app/{domain}/page.tsx` (Next.js)
+- **Pages Router** : `pages/{domain}/index.tsx`
+- **FSD (Feature-Sliced Design)** : `features/*/`, `widgets/*/`, `entities/*/`
+- **RSC/Client split** : Détecte le pattern `client.tsx`, suit la séparation Server/Client
+- **Fallback config** : Détecte Next.js/Vite/Nuxt depuis les fichiers de config (support monorepo)
+
 ---
 
 ## Démarrage Rapide

package/README.hi.md

@@ -33,9 +33,9 @@ ClaudeOS-Core पूरी प्रक्रिया को ऑटोमेट
 
 | स्टैक | डिटेक्शन | विश्लेषण गहराई |
 |---|---|---|
-| **Java / Spring Boot** | `build.gradle`, `pom.xml` | 10 कैटेगरी, 59 सब-आइटम |
+| **Java / Spring Boot** | `build.gradle`, `pom.xml`, 5 पैकेज पैटर्न | 10 कैटेगरी, 59 सब-आइटम |
 | **Node.js / Express / NestJS** | `package.json` | 9 कैटेगरी, 57 सब-आइटम |
-| **Next.js / React / Vue** | `package.json` (next, react, vue) | 9 कैटेगरी, 55 सब-आइटम |
+| **Next.js / React / Vue** | `package.json`, `next.config.*`, FSD सपोर्ट | 9 कैटेगरी, 55 सब-आइटम |
 | **Python / Django** | `requirements.txt`, `pyproject.toml` | 10 कैटेगरी, 55 सब-आइटम |
 | **Python / FastAPI** | `requirements.txt`, `pyproject.toml` | 10 कैटेगरी, 58 सब-आइटम |
 
@@ -43,6 +43,27 @@ ClaudeOS-Core पूरी प्रक्रिया को ऑटोमेट
 
 **आपको कुछ भी स्पेसिफाई करने की ज़रूरत नहीं। सब कुछ ऑटोमैटिकली डिटेक्ट होता है।**
 
+
+### Java डोमेन डिटेक्शन (5 पैटर्न, फॉलबैक के साथ)
+
+| प्राथमिकता | पैटर्न | संरचना | उदाहरण |
+|---|---|---|---|
+| A | लेयर-फर्स्ट | `controller/{domain}/` | `controller/user/UserController.java` |
+| B | डोमेन-फर्स्ट | `{domain}/controller/` | `user/controller/UserController.java` |
+| D | मॉड्यूल प्रीफ़िक्स | `{module}/{domain}/controller/` | `front/member/controller/MemberController.java` |
+| E | DDD/हेक्सागोनल | `{domain}/adapter/in/web/` | `user/adapter/in/web/UserController.java` |
+| C | फ्लैट | `controller/*.java` | `controller/UserController.java` → क्लास नाम से `user` एक्सट्रैक्ट |
+
+बिना Controller वाले सर्विस-ओनली डोमेन भी डिटेक्ट होते हैं। स्किप: `common`, `config`, `util`, `front`, `admin`, `v1`, `v2` आदि।
+
+### फ्रंटएंड डोमेन डिटेक्शन
+
+- **App Router**: `app/{domain}/page.tsx` (Next.js)
+- **Pages Router**: `pages/{domain}/index.tsx`
+- **FSD (Feature-Sliced Design)**: `features/*/`, `widgets/*/`, `entities/*/`
+- **RSC/Client split**: `client.tsx` पैटर्न डिटेक्ट, Server/Client कम्पोनेंट सेपरेशन ट्रैक
+- **Config fallback**: `package.json` में न होने पर भी config फ़ाइलों से Next.js/Vite/Nuxt डिटेक्ट (monorepo सपोर्ट)
+
 ---
 
 ## क्विक स्टार्ट

package/README.ja.md

@@ -43,6 +43,27 @@ ClaudeOS-Core がプロセス全体を自動化します：
 
 **何も指定する必要はありません。すべて自動検出されます。**
 
+
+### Java ドメイン検出（5パターン、フォールバック付き）
+
+| 優先度 | パターン | 構造 | 例 |
+|---|---|---|---|
+| A | レイヤー優先 | `controller/{domain}/` | `controller/user/UserController.java` |
+| B | ドメイン優先 | `{domain}/controller/` | `user/controller/UserController.java` |
+| D | モジュールプレフィックス | `{module}/{domain}/controller/` | `front/member/controller/MemberController.java` |
+| E | DDD/ヘキサゴナル | `{domain}/adapter/in/web/` | `user/adapter/in/web/UserController.java` |
+| C | フラット | `controller/*.java` | `controller/UserController.java` → クラス名から `user` を抽出 |
+
+Controller のないサービスのみのドメインも検出されます。スキップ：`common`、`config`、`util`、`front`、`admin`、`v1`、`v2` など。
+
+### フロントエンドドメイン検出
+
+- **App Router**：`app/{domain}/page.tsx`（Next.js）
+- **Pages Router**：`pages/{domain}/index.tsx`
+- **FSD（Feature-Sliced Design）**：`features/*/`、`widgets/*/`、`entities/*/`
+- **RSC/Client分離**：`client.tsx` パターンを検出、サーバー/クライアントコンポーネントの分離を追跡
+- **設定ファイルフォールバック**：`package.json` になくても設定ファイルから Next.js/Vite/Nuxt を検出（monorepo対応）
+
 ---
 
 ## クイックスタート

package/README.ko.md

@@ -53,9 +53,9 @@ Claude Code generates code that **matches your existing patterns 100%**.
 
 | 스택 / Stack | 감지 기준 / Detection | 분석 대상 / Analysis Targets |
 |---|---|---|
-| **Java / Spring Boot** | `build.gradle`, `pom.xml` | Controller, Service, Repository/Mapper, DTO, Entity, MyBatis XML, JPA |
+| **Java / Spring Boot** | `build.gradle`, `pom.xml`, 5가지 패키지 패턴 | Controller, Service, Repository/Mapper, DTO, Entity, MyBatis XML, JPA |
 | **Node.js / Express / NestJS** | `package.json` (express, @nestjs/core) | Router, Controller, Service, Repository, DTO, Middleware |
-| **Next.js / React / Vue** | `package.json` (next, react, vue) | Pages, Components, Hooks, Data Fetching, State Management |
+| **Next.js / React / Vue** | `package.json`, `next.config.*`, FSD 지원 | Pages, Components, Hooks, Data Fetching, State Management |
 | **Python / Django** | `requirements.txt`, `pyproject.toml` (django) | Views, Serializers, Models, Admin, Celery Tasks |
 | **Python / FastAPI** | `requirements.txt`, `pyproject.toml` (fastapi) | Routers, Pydantic Schemas, SQLAlchemy Models, Depends |
 
@@ -70,6 +70,26 @@ Claude Code generates code that **matches your existing patterns 100%**.
 **스택을 직접 지정할 필요 없습니다. 자동으로 감지합니다.**
 **You don't need to specify the stack. It's detected automatically.**
 
+### Java 도메인 감지 (5가지 패턴, 폴백 포함)
+
+| 우선순위 | 패턴 | 구조 | 예시 |
+|---|---|---|---|
+| A | 레이어 우선 | `controller/{domain}/` | `controller/user/UserController.java` |
+| B | 도메인 우선 | `{domain}/controller/` | `user/controller/UserController.java` |
+| D | 모듈 접두사 | `{module}/{domain}/controller/` | `front/member/controller/MemberController.java` |
+| E | DDD/헥사고날 | `{domain}/adapter/in/web/` | `user/adapter/in/web/UserController.java` |
+| C | 플랫 | `controller/*.java` | `controller/UserController.java` → 클래스명에서 `user` 추출 |
+
+Controller 없는 서비스 전용 도메인도 감지됩니다. 스킵: `common`, `config`, `util`, `front`, `admin`, `v1`, `v2` 등.
+
+### 프론트엔드 도메인 감지
+
+- **App Router**: `app/{domain}/page.tsx` (Next.js)
+- **Pages Router**: `pages/{domain}/index.tsx`
+- **FSD (Feature-Sliced Design)**: `features/*/`, `widgets/*/`, `entities/*/`
+- **RSC/Client 분리**: `client.tsx` 패턴 감지, Server/Client 컴포넌트 분리 추적
+- **설정 파일 폴백**: `package.json`에 없어도 `next.config.*`, `vite.config.*` 등에서 감지 (모노레포 지원)
+
 ---
 
 ## ✅ 사전 요구사항 / Prerequisites

package/README.md

@@ -33,9 +33,9 @@ Total time: **5–18 minutes**, depending on project size. Zero manual configura
 
 | Stack | Detection | Analysis Depth |
 |---|---|---|
-| **Java / Spring Boot** | `build.gradle`, `pom.xml` | 10 categories, 59 sub-items |
+| **Java / Spring Boot** | `build.gradle`, `pom.xml`, 5 package patterns | 10 categories, 59 sub-items |
 | **Node.js / Express / NestJS** | `package.json` | 9 categories, 57 sub-items |
-| **Next.js / React / Vue** | `package.json` (next, react, vue) | 9 categories, 55 sub-items |
+| **Next.js / React / Vue** | `package.json`, `next.config.*`, FSD support | 9 categories, 55 sub-items |
 | **Python / Django** | `requirements.txt`, `pyproject.toml` | 10 categories, 55 sub-items |
 | **Python / FastAPI** | `requirements.txt`, `pyproject.toml` | 10 categories, 58 sub-items |
 
@@ -43,6 +43,26 @@ Auto-detected: language & version, framework & version, ORM (MyBatis, JPA, Prism
 
 **You don't specify anything. It's all detected automatically.**
 
+### Java Domain Detection (5 patterns with fallback)
+
+| Priority | Pattern | Structure | Example |
+|---|---|---|---|
+| A | Layer-first | `controller/{domain}/` | `controller/user/UserController.java` |
+| B | Domain-first | `{domain}/controller/` | `user/controller/UserController.java` |
+| D | Module prefix | `{module}/{domain}/controller/` | `front/member/controller/MemberController.java` |
+| 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. Skips: `common`, `config`, `util`, `front`, `admin`, `v1`, `v2`, etc.
+
+### Frontend Domain Detection
+
+- **App Router**: `app/{domain}/page.tsx` (Next.js)
+- **Pages Router**: `pages/{domain}/index.tsx`
+- **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)
+
 ---
 
 ## Quick Start

package/README.ru.md

@@ -33,9 +33,9 @@ ClaudeOS-Core автоматизирует весь процесс:
 
 | Стек | Обнаружение | Глубина анализа |
 |---|---|---|
-| **Java / Spring Boot** | `build.gradle`, `pom.xml` | 10 категорий, 59 подпунктов |
+| **Java / Spring Boot** | `build.gradle`, `pom.xml`, 5 паттернов пакетов | 10 категорий, 59 подпунктов |
 | **Node.js / Express / NestJS** | `package.json` | 9 категорий, 57 подпунктов |
-| **Next.js / React / Vue** | `package.json` (next, react, vue) | 9 категорий, 55 подпунктов |
+| **Next.js / React / Vue** | `package.json`, `next.config.*`, поддержка FSD | 9 категорий, 55 подпунктов |
 | **Python / Django** | `requirements.txt`, `pyproject.toml` | 10 категорий, 55 подпунктов |
 | **Python / FastAPI** | `requirements.txt`, `pyproject.toml` | 10 категорий, 58 подпунктов |
 
@@ -43,6 +43,27 @@ ClaudeOS-Core автоматизирует весь процесс:
 
 **Вам не нужно ничего указывать. Всё определяется автоматически.**
 
+
+### Обнаружение Java-доменов (5 паттернов с фолбэком)
+
+| Приоритет | Паттерн | Структура | Пример |
+|---|---|---|---|
+| A | Слой-первый | `controller/{domain}/` | `controller/user/UserController.java` |
+| B | Домен-первый | `{domain}/controller/` | `user/controller/UserController.java` |
+| D | Модуль-префикс | `{module}/{domain}/controller/` | `front/member/controller/MemberController.java` |
+| E | DDD/Гексагональный | `{domain}/adapter/in/web/` | `user/adapter/in/web/UserController.java` |
+| C | Плоский | `controller/*.java` | `controller/UserController.java` → извлекает `user` из имени класса |
+
+Домены только с сервисами (без контроллеров) тоже обнаруживаются. Пропускаются: `common`, `config`, `util`, `front`, `admin`, `v1`, `v2` и т.д.
+
+### Обнаружение фронтенд-доменов
+
+- **App Router**: `app/{domain}/page.tsx` (Next.js)
+- **Pages Router**: `pages/{domain}/index.tsx`
+- **FSD (Feature-Sliced Design)**: `features/*/`, `widgets/*/`, `entities/*/`
+- **RSC/Client разделение**: Обнаружение паттерна `client.tsx`, отслеживание разделения Server/Client
+- **Фолбэк конфигурации**: Обнаружение Next.js/Vite/Nuxt из конфиг-файлов (поддержка monorepo)
+
 ---
 
 ## Быстрый старт

package/README.vi.md

@@ -33,9 +33,9 @@ Tổng thời gian: **5–18 phút**, tùy thuộc vào quy mô dự án. Không
 
 | Stack | Phát Hiện | Độ Sâu Phân Tích |
 |---|---|---|
-| **Java / Spring Boot** | `build.gradle`, `pom.xml` | 10 danh mục, 59 mục con |
+| **Java / Spring Boot** | `build.gradle`, `pom.xml`, 5 package patterns | 10 danh mục, 59 mục con |
 | **Node.js / Express / NestJS** | `package.json` | 9 danh mục, 57 mục con |
-| **Next.js / React / Vue** | `package.json` (next, react, vue) | 9 danh mục, 55 mục con |
+| **Next.js / React / Vue** | `package.json`, `next.config.*`, hỗ trợ FSD | 9 danh mục, 55 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 |
 
@@ -43,6 +43,27 @@ Tự động phát hiện: ngôn ngữ & phiên bản, framework & phiên bản,
 
 **Bạn không cần chỉ định gì cả. Tất cả được phát hiện tự động.**
 
+
+### Phát Hiện Domain Java (5 pattern với fallback)
+
+| Ưu tiên | Pattern | Cấu trúc | Ví dụ |
+|---|---|---|---|
+| A | Layer trước | `controller/{domain}/` | `controller/user/UserController.java` |
+| B | Domain trước | `{domain}/controller/` | `user/controller/UserController.java` |
+| D | Module prefix | `{module}/{domain}/controller/` | `front/member/controller/MemberController.java` |
+| 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. Bỏ qua: `common`, `config`, `util`, `front`, `admin`, `v1`, `v2`, v.v.
+
+### Phát Hiện Domain Frontend
+
+- **App Router**: `app/{domain}/page.tsx` (Next.js)
+- **Pages Router**: `pages/{domain}/index.tsx`
+- **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)
+
 ---
 
 ## Bắt Đầu Nhanh

package/README.zh-CN.md

@@ -43,6 +43,27 @@ ClaudeOS-Core 将整个过程自动化：
 
 **你不需要指定任何内容，一切自动检测。**
 
+
+### Java 域检测（5种模式自动回退）
+
+| 优先级 | 模式 | 结构 | 示例 |
+|---|---|---|---|
+| A | 层优先 | `controller/{domain}/` | `controller/user/UserController.java` |
+| B | 域优先 | `{domain}/controller/` | `user/controller/UserController.java` |
+| D | 模块前缀 | `{module}/{domain}/controller/` | `front/member/controller/MemberController.java` |
+| E | DDD/六角形 | `{domain}/adapter/in/web/` | `user/adapter/in/web/UserController.java` |
+| C | 扁平 | `controller/*.java` | `controller/UserController.java` → 从类名提取 `user` |
+
+无 Controller 的纯 Service 域也会被检测。跳过：`common`、`config`、`util`、`front`、`admin`、`v1`、`v2` 等。
+
+### 前端域检测
+
+- **App Router**：`app/{domain}/page.tsx`（Next.js）
+- **Pages Router**：`pages/{domain}/index.tsx`
+- **FSD（功能切片设计）**：`features/*/`、`widgets/*/`、`entities/*/`
+- **RSC/Client 分离**：检测 `client.tsx` 模式，追踪服务端/客户端组件分离
+- **配置文件回退**：从配置文件检测 Next.js/Vite/Nuxt（monorepo 支持）
+
 ---
 
 ## 快速开始

package/bin/cli.js

@@ -54,6 +54,29 @@ function run(cmd, options = {}) {
   }
 }
 
+// claude -p 실행: 프롬프트를 파일에 저장 후 파이프로 전달 (Windows 8191자 제한 우회)
+function runClaudePrompt(prompt, options = {}) {
+  const tmpFile = path.join(GENERATED_DIR, "_tmp_prompt.md");
+  fs.writeFileSync(tmpFile, prompt, "utf-8");
+  try {
+    const catCmd = process.platform === "win32" ? "type" : "cat";
+    const escaped = escapeShellArg(tmpFile);
+    const cmd = `${catCmd} ${escaped} | claude -p --dangerously-skip-permissions`;
+    execSync(cmd, {
+      cwd: options.cwd || PROJECT_ROOT,
+      stdio: "inherit",
+      encoding: "utf-8",
+      shell: true,
+    });
+    return true;
+  } catch (e) {
+    if (options.ignoreError) return false;
+    throw e;
+  } finally {
+    try { fs.unlinkSync(tmpFile); } catch {}
+  }
+}
+
 function ensureDir(dir) {
   if (!fs.existsSync(dir)) {
     fs.mkdirSync(dir, { recursive: true });
@@ -197,10 +220,7 @@ async function cmdInit() {
       .replace(/\{\{PASS_NUM\}\}/g, String(i));
     prompt = injectProjectRoot(prompt);
 
-    const ok = run(
-      `claude -p ${escapeShellArg(prompt)} --dangerously-skip-permissions`,
-      { ignoreError: true }
-    );
+    const ok = runClaudePrompt(prompt, { ignoreError: true });
 
     if (!ok) {
       log(`    ❌ Pass 1-${i} failed. Aborting.`);
@@ -227,10 +247,7 @@ async function cmdInit() {
       readFile(path.join(GENERATED_DIR, "pass2-prompt.md"))
     );
 
-    const ok = run(
-      `claude -p ${escapeShellArg(prompt)} --dangerously-skip-permissions`,
-      { ignoreError: true }
-    );
+    const ok = runClaudePrompt(prompt, { ignoreError: true });
 
     if (!ok) {
       log("    ❌ Pass 2 failed. Aborting.");
@@ -253,10 +270,7 @@ async function cmdInit() {
     readFile(path.join(GENERATED_DIR, "pass3-prompt.md"))
   );
 
-  const ok = run(
-    `claude -p ${escapeShellArg(prompt)} --dangerously-skip-permissions`,
-    { ignoreError: true }
-  );
+  const ok = runClaudePrompt(prompt, { ignoreError: true });
 
   if (!ok) {
     log("    ❌ Pass 3 failed. Aborting.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudeos-core",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "description": "Auto-generate Claude Code documentation from your actual source code — Standards, Rules, Skills, and Guides tailored to your project",
   "main": "health-checker/index.js",
   "bin": {

package/pass-prompts/templates/common/header.md

@@ -1,8 +1,5 @@
-⚠️ CRITICAL INSTRUCTION: 이것은 대화가 아닙니다. 아래 지시를 즉시 실행하세요.
-- 질문하지 마세요. "무엇을 도와드릴까요?" 같은 응답을 하지 마세요.
-- 프로젝트 구조 설명을 하지 마세요.
-- 아래 분석 항목을 모두 수행하고, 결과를 지정된 JSON 파일에 저장하세요.
-- 반드시 파일을 생성해야 합니다. 대화형 응답은 실패로 간주됩니다.
+당신은 코드 분석 도구입니다. 아래 지시에 따라 프로젝트 소스 코드를 분석하고, 결과를 JSON 파일로 저장하세요.
+대화하지 말고, 분석 결과만 JSON으로 출력하세요.
 
 프로젝트 루트 경로: {{PROJECT_ROOT}}
 이 경로를 기준으로 모든 파일 경로를 해석해줘.