claudeos-core 1.0.7 → 1.2.0

package/README.hi.md

@@ -8,7 +8,7 @@ npx claudeos-core init
 
 ClaudeOS-Core आपका कोडबेस पढ़ता है, हर पैटर्न को एक्सट्रैक्ट करता है, और _आपके_ प्रोजेक्ट के लिए कस्टमाइज़्ड Standards, Rules, Skills और Guides का पूरा सेट जेनरेट करता है। इसके बाद, जब आप Claude Code को "ऑर्डर के लिए CRUD बनाओ" कहते हैं, तो यह आपके मौजूदा पैटर्न से बिल्कुल मेल खाने वाला कोड जेनरेट करता है।
 
-[🇺🇸 English](./README.md) · [🇨🇳 中文](./README.zh-CN.md) · [🇯🇵 日本語](./README.ja.md) · [🇪🇸 Español](./README.es.md) · [🇻🇳 Tiếng Việt](./README.vi.md) · [🇷🇺 Русский](./README.ru.md) · [🇫🇷 Français](./README.fr.md) · [🇩🇪 Deutsch](./README.de.md) · [🇰🇷 한국어](./README.ko.md)
+[🇺🇸 English](./README.md) · [🇰🇷 한국어](./README.ko.md) · [🇨🇳 中文](./README.zh-CN.md) · [🇯🇵 日本語](./README.ja.md) · [🇪🇸 Español](./README.es.md) · [🇻🇳 Tiếng Việt](./README.vi.md) · [🇷🇺 Русский](./README.ru.md) · [🇫🇷 Français](./README.fr.md) · [🇩🇪 Deutsch](./README.de.md)
 
 ---
 
@@ -22,7 +22,7 @@ ClaudeOS-Core पूरी प्रक्रिया को ऑटोमेट
 
 1. **स्कैन** — स्टैक, डोमेन, ORM, डेटाबेस, पैकेज मैनेजर ऑटो-डिटेक्ट
 2. **गहन विश्लेषण** — कंट्रोलर पैटर्न, सर्विस लेयर्स, नेमिंग कन्वेंशन, एरर हैंडलिंग, सिक्योरिटी, टेस्टिंग और 50+ कैटेगरी
-3. **जेनरेट** — `CLAUDE.md`, Standards (15–17 फाइलें), Rules, Skills, Guides (9 फाइलें), Master Plans, DB डॉक्स और MCP गाइड का पूरा डॉक्यूमेंटेशन इकोसिस्टम
+3. **जेनरेट** — `CLAUDE.md`, Standards (15–19 फाइलें), Rules, Skills, Guides (9 फाइलें), Master Plans, DB डॉक्स और MCP गाइड का पूरा डॉक्यूमेंटेशन इकोसिस्टम
 4. **वैलिडेट** — 6 बिल्ट-इन वेरिफिकेशन टूल्स कंसिस्टेंसी सुनिश्चित करते हैं
 
 कुल समय: प्रोजेक्ट साइज़ के अनुसार **5–18 मिनट**। शून्य मैन्युअल कॉन्फ़िगरेशन।
@@ -33,16 +33,53 @@ ClaudeOS-Core पूरी प्रक्रिया को ऑटोमेट
 
 | स्टैक | डिटेक्शन | विश्लेषण गहराई |
 |---|---|---|
-| **Java / Spring Boot** | `build.gradle`, `pom.xml` | 10 कैटेगरी, 59 सब-आइटम |
+| **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, 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 सब-आइटम |
 
-ऑटो-डिटेक्ट: भाषा और वर्शन, फ्रेमवर्क और वर्शन, ORM (MyBatis, JPA, Prisma, TypeORM, SQLAlchemy, आदि), डेटाबेस (PostgreSQL, MySQL, Oracle, MongoDB, SQLite), पैकेज मैनेजर (Gradle, Maven, npm, yarn, pnpm, pip, poetry)।
+ऑटो-डिटेक्ट: भाषा और वर्शन, फ्रेमवर्क और वर्शन, ORM (MyBatis, JPA, Exposed, Prisma, TypeORM, SQLAlchemy, आदि), डेटाबेस (PostgreSQL, MySQL, Oracle, MongoDB, SQLite), पैकेज मैनेजर (Gradle, Maven, npm, yarn, pnpm, pip, poetry), आर्किटेक्चर (CQRS, BFF — मॉड्यूल नामों से पता लगाया), मल्टी-मॉड्यूल संरचना (settings.gradle से पता लगाया)।
 
 **आपको कुछ भी स्पेसिफाई करने की ज़रूरत नहीं। सब कुछ ऑटोमैटिकली डिटेक्ट होता है।**
 
+
+### 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` आदि।
+
+
+### Kotlin मल्टी-मॉड्यूल डोमेन डिटेक्शन
+
+Gradle मल्टी-मॉड्यूल संरचना वाले Kotlin प्रोजेक्ट्स (जैसे: CQRS मोनोरेपो) के लिए:
+
+| स्टेप | क्या करता है | उदाहरण |
+|---|---|---|
+| 1 | `settings.gradle.kts` में `include()` स्कैन करें | 14 मॉड्यूल मिले |
+| 2 | नाम से मॉड्यूल टाइप डिटेक्ट करें | `reservation-command-server` → type: `command` |
+| 3 | मॉड्यूल नाम से डोमेन एक्सट्रैक्ट करें | `reservation-command-server` → domain: `reservation` |
+| 4 | मॉड्यूल्स में समान डोमेन ग्रुप करें | `reservation-command-server` + `common-query-server` → 1 डोमेन |
+| 5 | आर्किटेक्चर डिटेक्ट करें | `command` + `query` मॉड्यूल हैं → CQRS |
+
+सपोर्टेड मॉड्यूल टाइप: `command`, `query`, `bff`, `integration`, `standalone`, `library`। शेयर्ड लाइब्रेरी (`shared-lib`, `integration-lib`) स्पेशल डोमेन के रूप में डिटेक्ट होती हैं।
+
+### फ्रंटएंड डोमेन डिटेक्शन
+
+- **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 सपोर्ट)
+
 ---
 
 ## क्विक स्टार्ट
@@ -57,16 +94,138 @@ ClaudeOS-Core पूरी प्रक्रिया को ऑटोमेट
 ```bash
 cd /your/project/root
 
-# विकल्प A: npx (अनुशंसित)
+# विकल्प A: npx (अनुशंसित — इंस्टॉल की आवश्यकता नहीं)
 npx claudeos-core init
 
-# विकल्प B: git clone (डेवलपमेंट/कॉन्ट्रिब्यूशन के लिए)
+# विकल्प B: ग्लोबल इंस्टॉल
+npm install -g claudeos-core
+claudeos-core init
+
+# विकल्प C: प्रोजेक्ट devDependency
+npm install --save-dev claudeos-core
+npx claudeos-core init
+
+# विकल्प D: git clone (डेवलपमेंट/कॉन्ट्रिब्यूशन के लिए)
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
 bash claudeos-core-tools/bootstrap.sh
 ```
 
 बस इतना ही। 5–18 मिनट बाद, सारा डॉक्यूमेंटेशन जेनरेट होकर उपयोग के लिए तैयार है।
 
+### मैन्युअल स्टेप-बाय-स्टेप इंस्टॉलेशन
+
+यदि आप प्रत्येक चरण पर पूर्ण नियंत्रण चाहते हैं — या यदि ऑटोमेटेड पाइपलाइन किसी स्टेप पर फेल हो जाती है — तो आप प्रत्येक स्टेज को मैन्युअली रन कर सकते हैं। यह ClaudeOS-Core के इंटर्नल वर्किंग को समझने के लिए भी उपयोगी है।
+
+#### Step 1: क्लोन करें और डिपेंडेंसी इंस्टॉल करें
+
+```bash
+cd /your/project/root
+
+git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+cd claudeos-core-tools && npm install && cd ..
+```
+
+#### Step 2: डायरेक्टरी स्ट्रक्चर बनाएं
+
+```bash
+# Rules
+mkdir -p .claude/rules/{00.core,10.backend,20.frontend,30.security-db,40.infra,50.sync}
+
+# Standards
+mkdir -p claudeos-core/standard/{00.core,10.backend-api,20.frontend-ui,30.security-db,40.infra,50.verification,90.optional}
+
+# Skills
+mkdir -p claudeos-core/skills/{00.shared,10.backend-crud/scaffold-crud-feature,20.frontend-page/scaffold-page-feature,50.testing,90.experimental}
+
+# Guide, Plan, Database, MCP, Generated
+mkdir -p claudeos-core/guide/{01.onboarding,02.usage,03.troubleshooting,04.architecture}
+mkdir -p claudeos-core/{plan,database,mcp-guide,generated}
+```
+
+#### Step 3: plan-installer रन करें (प्रोजेक्ट एनालिसिस)
+
+आपके प्रोजेक्ट को स्कैन करता है, स्टैक डिटेक्ट करता है, डोमेन ढूंढता है, ग्रुप में विभाजित करता है, और प्रॉम्प्ट जेनरेट करता है।
+
+```bash
+node claudeos-core-tools/plan-installer/index.js
+```
+
+**आउटपुट (`claudeos-core/generated/`):**
+- `project-analysis.json` — डिटेक्टेड स्टैक, डोमेन, फ्रंटएंड इन्फो
+- `domain-groups.json` — Pass 1 के लिए डोमेन ग्रुप
+- `pass1-backend-prompt.md` / `pass1-frontend-prompt.md` — एनालिसिस प्रॉम्प्ट
+- `pass2-prompt.md` — मर्ज प्रॉम्प्ट
+- `pass3-prompt.md` — जेनरेशन प्रॉम्प्ट
+
+आगे बढ़ने से पहले आप इन फाइलों की जांच करके डिटेक्शन सटीकता सत्यापित कर सकते हैं।
+
+#### Step 4: Pass 1 — डोमेन ग्रुप के अनुसार डीप कोड एनालिसिस
+
+प्रत्येक डोमेन ग्रुप के लिए Pass 1 रन करें। ग्रुप की संख्या के लिए `domain-groups.json` चेक करें।
+
+```bash
+# Check groups
+cat claudeos-core/generated/domain-groups.json | node -e "
+  const g = JSON.parse(require('fs').readFileSync('/dev/stdin','utf-8'));
+  g.groups.forEach((g,i) => console.log('Group '+(i+1)+': ['+g.domains.join(', ')+'] ('+g.type+', ~'+g.estimatedFiles+' files)'));
+"
+
+# 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
+
+# For frontend groups, use pass1-frontend-prompt.md instead
+```
+
+**सत्यापित करें:** `ls claudeos-core/generated/pass1-*.json` में प्रति ग्रुप एक JSON दिखना चाहिए।
+
+#### Step 5: Pass 2 — एनालिसिस रिज़ल्ट मर्ज करें
+
+```bash
+cat claudeos-core/generated/pass2-prompt.md \
+  | claude -p --dangerously-skip-permissions
+```
+
+**सत्यापित करें:** `claudeos-core/generated/pass2-merged.json` मौजूद होना चाहिए जिसमें 9+ टॉप-लेवल कीज़ हों।
+
+#### Step 6: Pass 3 — सभी डॉक्यूमेंटेशन जेनरेट करें
+
+```bash
+cat claudeos-core/generated/pass3-prompt.md \
+  | claude -p --dangerously-skip-permissions
+```
+
+**सत्यापित करें:** प्रोजेक्ट रूट में `CLAUDE.md` मौजूद होना चाहिए।
+
+#### Step 7: वेरिफिकेशन टूल्स रन करें
+
+```bash
+# मेटाडेटा जेनरेट करें (अन्य चेक से पहले आवश्यक)
+node claudeos-core-tools/manifest-generator/index.js
+
+# सभी चेक रन करें
+node claudeos-core-tools/health-checker/index.js
+
+# या इंडिविजुअल चेक रन करें:
+node claudeos-core-tools/import-linter/index.js        # @import validation
+node claudeos-core-tools/plan-validator/index.js --check # Plan ↔ disk
+node claudeos-core-tools/sync-checker/index.js          # Sync status
+node claudeos-core-tools/content-validator/index.js     # Content quality
+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
+head -30 CLAUDE.md
+ls .claude/rules/*/
+```
+
+> **Tip:** यदि कोई स्टेप फेल हो जाता है, तो आप केवल उस स्टेप को दोबारा रन कर सकते हैं। Pass 1/2 के रिज़ल्ट कैश होते हैं — यदि `pass1-N.json` या `pass2-merged.json` पहले से मौजूद है, तो ऑटोमेटेड पाइपलाइन उन्हें स्किप करती है। री-रन के लिए फाइल डिलीट करें।
+
 ### उपयोग शुरू करें
 
 ```
@@ -108,7 +267,7 @@ npx claudeos-core init
 
 ### 3 Pass क्यों?
 
-**Pass 1** एकमात्र pass है जो सोर्स कोड पढ़ता है। यह प्रति डोमेन रिप्रेज़ेंटेटिव फाइलें सेलेक्ट करता है और 55–59 विश्लेषण कैटेगरी (प्रति स्टैक) में पैटर्न एक्सट्रैक्ट करता है। बड़े प्रोजेक्ट्स के लिए, Pass 1 कई बार रन होता है — प्रति डोमेन ग्रुप एक बार। मल्टी-स्टैक प्रोजेक्ट्स (जैसे: Java बैकएंड + React फ्रंटएंड) में, बैकएंड और फ्रंटएंड **अलग-अलग विश्लेषण प्रॉम्प्ट्स** का उपयोग करते हैं।
+**Pass 1** एकमात्र pass है जो सोर्स कोड पढ़ता है। यह प्रति डोमेन रिप्रेज़ेंटेटिव फाइलें सेलेक्ट करता है और 55–95 विश्लेषण कैटेगरी (प्रति स्टैक) में पैटर्न एक्सट्रैक्ट करता है। बड़े प्रोजेक्ट्स के लिए, Pass 1 कई बार रन होता है — प्रति डोमेन ग्रुप एक बार। मल्टी-स्टैक प्रोजेक्ट्स (जैसे: Java बैकएंड + React फ्रंटएंड) में, बैकएंड और फ्रंटएंड **अलग-अलग विश्लेषण प्रॉम्प्ट्स** का उपयोग करते हैं।
 
 **Pass 2** सभी Pass 1 रिज़ल्ट्स को एकीकृत विश्लेषण में मर्ज करता है: कॉमन पैटर्न (100% शेयर्ड), मेजॉरिटी पैटर्न (50%+ शेयर्ड), डोमेन-स्पेसिफिक पैटर्न, सीवेरिटी के अनुसार एंटी-पैटर्न, और क्रॉस-कटिंग कंसर्न्स (नेमिंग, सिक्योरिटी, DB, टेस्टिंग, लॉगिंग, परफॉर्मेंस)।
 
@@ -134,7 +293,7 @@ your-project/
 │
 ├── claudeos-core/                     ← मुख्य आउटपुट डायरेक्टरी
 │   ├── generated/                     ← एनालिसिस JSON + डायनामिक प्रॉम्प्ट्स
-│   ├── standard/                      ← कोडिंग स्टैंडर्ड्स (15-17 फाइलें)
+│   ├── standard/                      ← कोडिंग स्टैंडर्ड्स (15-19 फाइलें)
 │   ├── skills/                        ← CRUD स्कैफोल्डिंग skills
 │   ├── guide/                         ← ऑनबोर्डिंग, FAQ, ट्रबलशूटिंग (9 फाइलें)
 │   ├── plan/                          ← Master Plans (बैकअप/रीस्टोर)
@@ -228,9 +387,10 @@ npx claudeos-core restore
 
 | | ClaudeOS-Core | SuperClaude | मैन्युअल CLAUDE.md | जेनेरिक Skills |
 |---|---|---|---|---|
-| **कोड पढ़ता है** | ✅ गहन विश्लेषण (55–59 कैटेगरी) | ❌ बिहेवियर इंजेक्शन | ❌ मैन्युअल राइटिंग | ❌ प्री-बिल्ट टेम्पलेट |
+| **कोड पढ़ता है** | ✅ गहन विश्लेषण (55–95 कैटेगरी) | ❌ बिहेवियर इंजेक्शन | ❌ मैन्युअल राइटिंग | ❌ प्री-बिल्ट टेम्पलेट |
 | **प्रोजेक्ट-स्पेसिफिक आउटपुट** | ✅ हर फाइल आपके पैटर्न रिफ्लेक्ट करती है | ❌ जेनेरिक कमांड | आंशिक | ❌ वन-साइज़-फिट्स-ऑल |
 | **मल्टी-स्टैक** | ✅ ऑटो-डिटेक्ट + अलग विश्लेषण | ❌ स्टैक-एग्नॉस्टिक | मैन्युअल | अनिश्चित |
+| **Kotlin + CQRS/BFF** | ✅ मल्टी-मॉड्यूल, Command/Query विभाजन | ❌ | ❌ | ❌ |
 | **सेल्फ-वेरिफाइंग** | ✅ 6 वैलिडेशन टूल्स | ❌ | ❌ | ❌ |
 | **बैकअप / रीस्टोर** | ✅ Master Plan सिस्टम | ❌ | ❌ | ❌ |
 | **सेटअप समय** | ~5–18 मिनट (ऑटोमेटेड) | ~5 मिनट (मैन्युअल कॉन्फ़िग) | घंटे–दिन | ~5 मिनट |
@@ -254,6 +414,15 @@ npx claudeos-core restore
 **प्र: दोबारा रन करने पर क्या होता है?**
 Pass 1/2 स्किप होते हैं अगर उनका JSON पहले से मौजूद है। Pass 3 हमेशा दोबारा रन होता है। पिछले वर्शन Master Plans से रीस्टोर किए जा सकते हैं।
 
+**प्र: क्या यह Kotlin को सपोर्ट करता है?**
+हाँ। ClaudeOS-Core `build.gradle.kts` या `build.gradle` में kotlin plugin से Kotlin को स्वचालित रूप से पहचानता है। यह Kotlin-विशिष्ट विश्लेषण (data class, sealed class, coroutines, extension functions, MockK आदि) के लिए समर्पित `kotlin-spring` टेम्पलेट का उपयोग करता है।
+
+**प्र: CQRS / BFF आर्किटेक्चर के बारे में क्या?**
+Kotlin मल्टी-मॉड्यूल प्रोजेक्ट्स के लिए पूरी तरह सपोर्टेड है। ClaudeOS-Core `settings.gradle.kts` पढ़ता है, मॉड्यूल नामों से मॉड्यूल प्रकार (command, query, bff, integration) का पता लगाता है, और एक ही डोमेन के Command/Query मॉड्यूल को ग्रुप करता है। जनरेट किए गए स्टैंडर्ड में command controller vs query controller के अलग नियम, BFF/Feign पैटर्न और इंटर-मॉड्यूल कम्युनिकेशन कन्वेंशन शामिल हैं।
+
+**प्र: Gradle मल्टी-मॉड्यूल monorepo के बारे में क्या?**
+ClaudeOS-Core नेस्टिंग गहराई की परवाह किए बिना सभी सबमॉड्यूल (`**/src/main/kotlin/**/*.kt`) को स्कैन करता है। मॉड्यूल प्रकार नामकरण परंपराओं से अनुमानित होते हैं (जैसे `reservation-command-server` → डोमेन: `reservation`, प्रकार: `command`)। शेयर्ड लाइब्रेरी (`shared-lib`, `integration-lib`) भी पहचानी जाती हैं।
+
 ---
 
 ## टेम्पलेट स्ट्रक्चर
@@ -262,6 +431,7 @@ Pass 1/2 स्किप होते हैं अगर उनका JSON प
 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)
@@ -313,7 +483,13 @@ my-monorepo/                    ← यहाँ रन न करें (रू
 
 **"npm install failed"** — Node.js वर्शन बहुत पुराना हो सकता है। v18+ आवश्यक है।
 
-**"0 domains detected"** — आपकी प्रोजेक्ट स्ट्रक्चर नॉन-स्टैंडर्ड हो सकती है। अपने स्टैक के डिटेक्शन पैटर्न के लिए [कोरियन डॉक्स](./README.ko.md#-문제-해결--troubleshooting) देखें।
+**"0 domains detected"** — आपकी प्रोजेक्ट स्ट्रक्चर नॉन-स्टैंडर्ड हो सकती है। अपने स्टैक के डिटेक्शन पैटर्न के लिए [कोरियन डॉक्स](./README.ko.md#트러블슈팅) देखें।
+
+**Kotlin प्रोजेक्ट में "0 डोमेन डिटेक्ट"** — सुनिश्चित करें कि प्रोजेक्ट रूट में `build.gradle.kts` (या kotlin plugin वाला `build.gradle`) मौजूद है, और सोर्स फाइलें `**/src/main/kotlin/` के अंतर्गत हैं। मल्टी-मॉड्यूल प्रोजेक्ट्स में `settings.gradle.kts` में `include()` स्टेटमेंट होने चाहिए। सिंगल-मॉड्यूल Kotlin प्रोजेक्ट (`settings.gradle` के बिना) भी सपोर्टेड हैं — डोमेन `src/main/kotlin/` के पैकेज/क्लास स्ट्रक्चर से एक्सट्रैक्ट किए जाते हैं।
+
+**"भाषा kotlin की बजाय java के रूप में डिटेक्ट"** — ClaudeOS-Core पहले रूट `build.gradle(.kts)` चेक करता है, फिर सबमॉड्यूल बिल्ड फाइलें। सुनिश्चित करें कि कम से कम एक `build.gradle.kts` में `kotlin("jvm")` या `org.jetbrains.kotlin` शामिल है।
+
+**"CQRS डिटेक्ट नहीं हुआ"** — आर्किटेक्चर डिटेक्शन मॉड्यूल नामों में `command` और `query` कीवर्ड पर निर्भर करता है। यदि आपके मॉड्यूल अलग नामकरण उपयोग करते हैं, तो plan-installer चलाने के बाद जनरेट किए गए प्रॉम्प्ट्स को मैन्युअली एडजस्ट किया जा सकता है।
 
 ---
 

package/README.ja.md

@@ -8,7 +8,7 @@ npx claudeos-core init
 
 ClaudeOS-Core はコードベースを読み取り、すべてのパターンを抽出し、_あなたの_ プロジェクトに最適化された Standards、Rules、Skills、Guides の完全なセットを生成します。その後、Claude Code に「注文の CRUD を作成して」と伝えると、既存のパターンに完全に一致するコードが生成されます。
 
-[🇺🇸 English](./README.md) · [🇨🇳 中文](./README.zh-CN.md) · [🇪🇸 Español](./README.es.md) · [🇻🇳 Tiếng Việt](./README.vi.md) · [🇮🇳 हिन्दी](./README.hi.md) · [🇷🇺 Русский](./README.ru.md) · [🇫🇷 Français](./README.fr.md) · [🇩🇪 Deutsch](./README.de.md) · [🇰🇷 한국어](./README.ko.md)
+[🇺🇸 English](./README.md) · [🇰🇷 한국어](./README.ko.md) · [🇨🇳 中文](./README.zh-CN.md) · [🇪🇸 Español](./README.es.md) · [🇻🇳 Tiếng Việt](./README.vi.md) · [🇮🇳 हिन्दी](./README.hi.md) · [🇷🇺 Русский](./README.ru.md) · [🇫🇷 Français](./README.fr.md) · [🇩🇪 Deutsch](./README.de.md)
 
 ---
 
@@ -22,7 +22,7 @@ ClaudeOS-Core がプロセス全体を自動化します：
 
 1. **スキャン** — スタック、ドメイン、ORM、DB、パッケージマネージャーを自動検出
 2. **ディープ分析** — コントローラーパターン、サービス層、命名規則、エラーハンドリング、セキュリティ、テストなど 50+ カテゴリ
-3. **生成** — `CLAUDE.md`、Standards（15–17 ファイル）、Rules、Skills、Guides（9 ファイル）、Master Plans、DB ドキュメント、MCP ガイドの完全な文書エコシステム
+3. **生成** — `CLAUDE.md`、Standards（15–19 ファイル）、Rules、Skills、Guides（9 ファイル）、Master Plans、DB ドキュメント、MCP ガイドの完全な文書エコシステム
 4. **検証** — 6 つの組み込み検証ツールが整合性を保証
 
 所要時間：プロジェクト規模に応じて **5–18 分**。手動設定ゼロ。
@@ -33,16 +33,53 @@ ClaudeOS-Core がプロセス全体を自動化します：
 
 | スタック | 検出方法 | 分析深度 |
 |---|---|---|
-| **Java / Spring Boot** | `build.gradle`、`pom.xml` | 10 大分類、59 小項目 |
+| **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、react、vue） | 9 大分類、55 小項目 |
 | **Python / Django** | `requirements.txt`、`pyproject.toml` | 10 大分類、55 小項目 |
 | **Python / FastAPI** | `requirements.txt`、`pyproject.toml` | 10 大分類、58 小項目 |
 
-自動検出対象：言語とバージョン、フレームワークとバージョン、ORM（MyBatis、JPA、Prisma、TypeORM、SQLAlchemy 等）、データベース（PostgreSQL、MySQL、Oracle、MongoDB、SQLite）、パッケージマネージャー（Gradle、Maven、npm、yarn、pnpm、pip、poetry）。
+自動検出対象：言語とバージョン、フレームワークとバージョン、ORM（MyBatis、JPA、Exposed、Prisma、TypeORM、SQLAlchemy 等）、データベース（PostgreSQL、MySQL、Oracle、MongoDB、SQLite）、パッケージマネージャー（Gradle、Maven、npm、yarn、pnpm、pip、poetry）、アーキテクチャ（CQRS、BFF — モジュール名から検出）、マルチモジュール構造（settings.gradleから検出）。
 
 **何も指定する必要はありません。すべて自動検出されます。**
 
+
+### 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` など。
+
+
+### Kotlin マルチモジュールドメイン検出
+
+Gradle マルチモジュール構造の Kotlin プロジェクト（例：CQRS モノレポ）向け：
+
+| ステップ | 動作 | 例 |
+|---|---|---|
+| 1 | `settings.gradle.kts` から `include()` をスキャン | 14 モジュール検出 |
+| 2 | モジュール名からタイプを検出 | `reservation-command-server` → type: `command` |
+| 3 | モジュール名からドメインを抽出 | `reservation-command-server` → domain: `reservation` |
+| 4 | 同じドメインをモジュール間でグループ化 | `reservation-command-server` + `common-query-server` → 1ドメイン |
+| 5 | アーキテクチャを検出 | `command` + `query` モジュールあり → CQRS |
+
+サポートモジュールタイプ：`command`、`query`、`bff`、`integration`、`standalone`、`library`。共有ライブラリ（`shared-lib`、`integration-lib`）は特殊ドメインとして検出されます。
+
+### フロントエンドドメイン検出
+
+- **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対応）
+
 ---
 
 ## クイックスタート
@@ -57,16 +94,138 @@ ClaudeOS-Core がプロセス全体を自動化します：
 ```bash
 cd /your/project/root
 
-# 方法 A：npx（推奨）
+# 方法 A：npx（推奨 — インストール不要）
 npx claudeos-core init
 
-# 方法 B：git clone（開発・コントリビューション用）
+# 方法 B：グローバルインストール
+npm install -g claudeos-core
+claudeos-core init
+
+# 方法 C：プロジェクト devDependency
+npm install --save-dev claudeos-core
+npx claudeos-core init
+
+# 方法 D：git clone（開発・コントリビューション用）
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
 bash claudeos-core-tools/bootstrap.sh
 ```
 
 これだけです。5–18 分後、すべてのドキュメントが生成され、すぐに使えます。
 
+### 手動ステップバイステップインストール
+
+各フェーズを完全に制御したい場合、または自動パイプラインが途中で失敗した場合、各ステージを手動で実行できます。ClaudeOS-Core の内部動作を理解するのにも役立ちます。
+
+#### Step 1：クローンと依存関係のインストール
+
+```bash
+cd /your/project/root
+
+git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+cd claudeos-core-tools && npm install && cd ..
+```
+
+#### Step 2：ディレクトリ構造の作成
+
+```bash
+# Rules
+mkdir -p .claude/rules/{00.core,10.backend,20.frontend,30.security-db,40.infra,50.sync}
+
+# Standards
+mkdir -p claudeos-core/standard/{00.core,10.backend-api,20.frontend-ui,30.security-db,40.infra,50.verification,90.optional}
+
+# Skills
+mkdir -p claudeos-core/skills/{00.shared,10.backend-crud/scaffold-crud-feature,20.frontend-page/scaffold-page-feature,50.testing,90.experimental}
+
+# Guide, Plan, Database, MCP, Generated
+mkdir -p claudeos-core/guide/{01.onboarding,02.usage,03.troubleshooting,04.architecture}
+mkdir -p claudeos-core/{plan,database,mcp-guide,generated}
+```
+
+#### Step 3：plan-installer の実行（プロジェクト分析）
+
+プロジェクトをスキャンし、スタックを検出、ドメインを発見、グループに分割、プロンプトを生成します。
+
+```bash
+node claudeos-core-tools/plan-installer/index.js
+```
+
+**出力（`claudeos-core/generated/`）：**
+- `project-analysis.json` — 検出されたスタック、ドメイン、フロントエンド情報
+- `domain-groups.json` — Pass 1 用ドメイングループ
+- `pass1-backend-prompt.md` / `pass1-frontend-prompt.md` — 分析プロンプト
+- `pass2-prompt.md` — 統合プロンプト
+- `pass3-prompt.md` — 生成プロンプト
+
+続行する前に、これらのファイルを確認して検出精度を検証できます。
+
+#### Step 4：Pass 1 — ドメイングループごとの深層コード分析
+
+各ドメイングループに対して Pass 1 を実行します。`domain-groups.json` でグループ数を確認してください。
+
+```bash
+# Check groups
+cat claudeos-core/generated/domain-groups.json | node -e "
+  const g = JSON.parse(require('fs').readFileSync('/dev/stdin','utf-8'));
+  g.groups.forEach((g,i) => console.log('Group '+(i+1)+': ['+g.domains.join(', ')+'] ('+g.type+', ~'+g.estimatedFiles+' files)'));
+"
+
+# 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
+
+# For frontend groups, use pass1-frontend-prompt.md instead
+```
+
+**確認：** `ls claudeos-core/generated/pass1-*.json` でグループごとに1つの JSON があることを確認。
+
+#### Step 5：Pass 2 — 分析結果の統合
+
+```bash
+cat claudeos-core/generated/pass2-prompt.md \
+  | claude -p --dangerously-skip-permissions
+```
+
+**確認：** `claudeos-core/generated/pass2-merged.json` が存在し、9つ以上のトップレベルキーがあること。
+
+#### Step 6：Pass 3 — 全ドキュメント生成
+
+```bash
+cat claudeos-core/generated/pass3-prompt.md \
+  | claude -p --dangerously-skip-permissions
+```
+
+**確認：** プロジェクトルートに `CLAUDE.md` が存在すること。
+
+#### Step 7：検証ツールの実行
+
+```bash
+# メタデータ生成（他のチェックの前に必須）
+node claudeos-core-tools/manifest-generator/index.js
+
+# 全チェック実行
+node claudeos-core-tools/health-checker/index.js
+
+# または個別チェック：
+node claudeos-core-tools/import-linter/index.js        # @import validation
+node claudeos-core-tools/plan-validator/index.js --check # Plan ↔ disk
+node claudeos-core-tools/sync-checker/index.js          # Sync status
+node claudeos-core-tools/content-validator/index.js     # Content quality
+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
+head -30 CLAUDE.md
+ls .claude/rules/*/
+```
+
+> **ヒント：** 特定のステップで失敗した場合、そのステップだけを再実行できます。Pass 1/2 の結果はキャッシュされます — `pass1-N.json` や `pass2-merged.json` が既に存在する場合、自動パイプラインはスキップします。ファイルを削除すると強制再実行されます。
+
 ### 使い始める
 
 ```
@@ -108,7 +267,7 @@ npx claudeos-core init
 
 ### なぜ 3 Pass なのか？
 
-**Pass 1** はソースコードを読む唯一のパスです。ドメインごとに代表ファイルを選択し、55–59 の分析カテゴリにわたってパターンを抽出します。大規模プロジェクトでは、Pass 1 はドメイングループごとに複数回実行されます。マルチスタックプロジェクト（例：Java バックエンド + React フロントエンド）では、バックエンドとフロントエンドに**それぞれ専用の分析プロンプト**が使用されます。
+**Pass 1** はソースコードを読む唯一のパスです。ドメインごとに代表ファイルを選択し、55–95 の分析カテゴリにわたってパターンを抽出します。大規模プロジェクトでは、Pass 1 はドメイングループごとに複数回実行されます。マルチスタックプロジェクト（例：Java バックエンド + React フロントエンド）では、バックエンドとフロントエンドに**それぞれ専用の分析プロンプト**が使用されます。
 
 **Pass 2** はすべての Pass 1 結果を統合分析に統合します：共通パターン（100% 共有）、多数派パターン（50%+ 共有）、ドメイン固有パターン、重大度別アンチパターン、横断的関心事（命名、セキュリティ、DB、テスト、ロギング、パフォーマンス）。
 
@@ -134,7 +293,7 @@ your-project/
 │
 ├── claudeos-core/                     ← メイン出力ディレクトリ
 │   ├── generated/                     ← 分析 JSON + 動的プロンプト
-│   ├── standard/                      ← コーディング標準（15-17 ファイル）
+│   ├── standard/                      ← コーディング標準（15-19 ファイル）
 │   ├── skills/                        ← CRUD スキャフォールディングスキル
 │   ├── guide/                         ← オンボーディング、FAQ、トラブルシューティング（9 ファイル）
 │   ├── plan/                          ← Master Plans（バックアップ/リストア）
@@ -228,9 +387,10 @@ npx claudeos-core restore
 
 | | ClaudeOS-Core | SuperClaude | 手動 CLAUDE.md | 汎用 Skills |
 |---|---|---|---|---|
-| **コードを読む** | ✅ ディープ分析（55–59 カテゴリ） | ❌ 動作注入 | ❌ 手動作成 | ❌ 既製テンプレート |
+| **コードを読む** | ✅ ディープ分析（55–95 カテゴリ） | ❌ 動作注入 | ❌ 手動作成 | ❌ 既製テンプレート |
 | **プロジェクト固有の出力** | ✅ すべてのファイルがあなたのパターンを反映 | ❌ 汎用コマンド | 部分的 | ❌ 画一的 |
 | **マルチスタック** | ✅ 自動検出 + 個別分析 | ❌ スタック非依存 | 手動 | 不定 |
+| **Kotlin + CQRS/BFF** | ✅ マルチモジュール、Command/Query分離 | ❌ | ❌ | ❌ |
 | **自己検証** | ✅ 6 つの検証ツール | ❌ | ❌ | ❌ |
 | **バックアップ / リストア** | ✅ Master Plan システム | ❌ | ❌ | ❌ |
 | **セットアップ時間** | ~5–18分（自動） | ~5分（手動設定） | 数時間–数日 | ~5分 |
@@ -254,6 +414,15 @@ npx claudeos-core restore
 **Q：再実行するとどうなりますか？**
 Pass 1/2 の JSON が既に存在する場合はスキップされます。Pass 3 は常に再実行されます。以前のバージョンは Master Plans から復元できます。
 
+**Q：Kotlinはサポートしていますか？**
+はい。ClaudeOS-Coreは`build.gradle.kts`またはkotlinプラグインのある`build.gradle`からKotlinを自動検出します。Kotlin専用の`kotlin-spring`テンプレートを使用して、data class、sealed class、コルーチン、拡張関数、MockKなどKotlin固有のパターンを分析します。
+
+**Q：CQRS / BFFアーキテクチャは？**
+Kotlinマルチモジュールプロジェクトで完全にサポートされています。`settings.gradle.kts`を読み取り、モジュール名からモジュールタイプ（command、query、bff、integration）を検出し、同じドメインのCommand/Queryモジュールをグループ化します。生成される標準には、commandコントローラーとqueryコントローラーの個別ルール、BFF/Feignパターン、モジュール間通信規約が含まれます。
+
+**Q：Gradleマルチモジュールmonorepoは？**
+ClaudeOS-Coreはネストの深さに関係なく、すべてのサブモジュール（`**/src/main/kotlin/**/*.kt`）をスキャンします。モジュールタイプは命名規則から推測されます（例：`reservation-command-server` → ドメイン：`reservation`、タイプ：`command`）。共有ライブラリ（`shared-lib`、`integration-lib`）も検出されます。
+
 ---
 
 ## テンプレート構造
@@ -262,6 +431,7 @@ Pass 1/2 の JSON が既に存在する場合はスキップされます。Pass
 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)
@@ -313,7 +483,13 @@ my-monorepo/                    ← ここでは実行しないでください
 
 **"npm install failed"** — Node.js のバージョンが低い可能性があります。v18+ が必要です。
 
-**"0 domains detected"** — プロジェクト構造が非標準の可能性があります。[韓国語ドキュメント](./README.ko.md#-문제-해결--troubleshooting)であなたのスタックの検出パターンを確認してください。
+**"0 domains detected"** — プロジェクト構造が非標準の可能性があります。[韓国語ドキュメント](./README.ko.md#트러블슈팅)であなたのスタックの検出パターンを確認してください。
+
+**Kotlin プロジェクトで「0 ドメイン検出」** — プロジェクトルートに `build.gradle.kts`（または kotlin プラグインのある `build.gradle`）が存在し、ソースファイルが `**/src/main/kotlin/` 配下にあることを確認してください。マルチモジュールプロジェクトの場合、`settings.gradle.kts` に `include()` 文が含まれている必要があります。単一モジュールの Kotlin プロジェクト（`settings.gradle` なし）もサポートされます — `src/main/kotlin/` 配下のパッケージ/クラス構造からドメインを抽出します。
+
+**「言語が kotlin ではなく java として検出される」** — ClaudeOS-Core はまずルートの `build.gradle(.kts)` を確認し、次にサブモジュールのビルドファイルを確認します。少なくとも1つの `build.gradle.kts` に `kotlin("jvm")` または `org.jetbrains.kotlin` が含まれていることを確認してください。
+
+**「CQRS が検出されない」** — アーキテクチャ検出はモジュール名に `command` と `query` キーワードが含まれている必要があります。モジュールが異なる命名を使用している場合、plan-installer 実行後に生成されたプロンプトを手動で調整できます。
 
 ---