claudeos-core 1.0.7 → 1.2.0

package/README.ko.md

@@ -1,240 +1,289 @@
-# ClaudeOS-Core — 도구
+# ClaudeOS-Core
+
+**명령어 하나로. 실제 소스코드에서 Claude Code 문서 전체를 자동 생성합니다.**
+
+```bash
+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.hi.md) · [🇷🇺 Русский](./README.ru.md) · [🇫🇷 Français](./README.fr.md) · [🇩🇪 Deutsch](./README.de.md)
 
-> **한 줄 요약**
->
-> `npx claudeos-core init` (또는 `bash claudeos-core-tools/bootstrap.sh`) 하나만 실행하면,
-> Claude Code가 프로젝트를 완벽하게 이해하는 데 필요한 모든 문서가 자동 생성됩니다.
 
 ---
 
-## 📖 목차 / Table of Contents
+## 문제
 
-- [ClaudeOS-Core란? / What is ClaudeOS-Core?](#-claudeos-core란--what-is-claudeos-core)
-- [지원 스택 / Supported Stacks](#-지원-스택--supported-stacks)
-- [사전 요구사항 / Prerequisites](#-사전-요구사항--prerequisites)
-- [설치 및 실행 / Installation & Usage](#-설치-및-실행--installation--usage)
-- [작동 원리 / How It Works](#-작동-원리--how-it-works)
-- [생성되는 파일 구조 / Generated File Structure](#-생성되는-파일-구조--generated-file-structure)
-- [규모별 자동 조절 / Auto-scaling by Project Size](#-규모별-자동-조절--auto-scaling-by-project-size)
-- [도구 상세 / Tool Reference](#-도구-상세--tool-reference)
-- [일상 사용법 / Daily Usage](#-일상-사용법--daily-usage)
-- [문제 해결 / Troubleshooting](#-문제-해결--troubleshooting)
-- [FAQ](#-faq)
+Claude Code는 강력하지만, _여러분_ 프로젝트의 컨벤션을 모릅니다. `CLAUDE.md`, 수십 개의 규칙, 스캐폴딩 스킬을 수동으로 작성하려면 몇 시간이 걸리고 — 코드베이스가 발전하는 순간 낡아버립니다.
 
----
+## 해결책
 
-## 🤔 ClaudeOS-Core란? / What is ClaudeOS-Core?
+ClaudeOS-Core가 전체 프로세스를 자동화합니다:
 
-### 한국어
+1. **스캔** — 스택, 도메인, ORM, DB, 패키지 매니저를 자동 감지
+2. **분석** — 컨트롤러 패턴, 서비스 레이어, 명명 규칙, 에러 처리, 보안, 테스트 등 50개+ 카테고리 심층 분석
+3. **생성** — `CLAUDE.md`, Standards (15–19개 파일), Rules, Skills, Guides (9개 파일), Master Plans, DB 문서, MCP 가이드 완전 생성
+4. **검증** — 6개 내장 검증 도구로 일관성 자동 확인
 
-ClaudeOS-Core는 **Claude Code CLI**가 여러분의 프로젝트를 깊이 이해하도록 돕는 자동화 도구입니다.
+총 소요 시간: 프로젝트 규모에 따라 **5–18분**. 수동 설정 불필요.
 
-프로젝트의 코딩 패턴, 아키텍처, 명명 규칙, 보안 정책 등을 자동으로 분석하고,
-Claude Code가 참조할 수 있는 표준 문서(Standards), 규칙(Rules), 스킬(Skills), 가이드(Guides)를 생성합니다.
+---
 
-이렇게 하면 Claude Code에게 "CRUD 만들어줘"라고만 말해도,
-**프로젝트의 기존 패턴과 100% 일치하는 코드**를 생성합니다.
+## 지원 스택
 
-### English
+| 스택 | 감지 기준 | 분석 깊이 |
+|---|---|---|
+| **Java / Spring Boot** | `build.gradle`, `pom.xml`, 5가지 패키지 패턴 | 10개 대분류, 59개 소분류 |
+| **Kotlin / Spring Boot** | `build.gradle.kts`, kotlin 플러그인, `settings.gradle.kts`, CQRS/BFF 자동감지 | 12개 대분류, 95개 소분류 |
+| **Node.js / Express / NestJS** | `package.json` | 9개 대분류, 57개 소분류 |
+| **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개 소분류 |
 
-ClaudeOS-Core is an automation tool that helps **Claude Code CLI** deeply understand your project.
+자동 감지 항목: 언어 & 버전, 프레임워크 & 버전, ORM (MyBatis, JPA, Exposed, Prisma, TypeORM, SQLAlchemy 등), 데이터베이스 (PostgreSQL, MySQL, Oracle, MongoDB, SQLite), 패키지 매니저 (Gradle, Maven, npm, yarn, pnpm, pip, poetry), 아키텍처 (CQRS, BFF — 모듈명에서 감지), 멀티모듈 구조 (settings.gradle에서 감지).
 
-It automatically analyzes your project's coding patterns, architecture, naming conventions, and security policies,
-then generates Standards, Rules, Skills, and Guides that Claude Code can reference.
+**직접 지정할 필요 없습니다. 전부 자동으로 감지합니다.**
 
-This means when you say "Create a CRUD for orders",
-Claude Code generates code that **matches your existing patterns 100%**.
+### 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` 등.
 
-## 🛠 지원 스택 / Supported Stacks
 
-| 스택 / Stack | 감지 기준 / Detection | 분석 대상 / Analysis Targets |
+### Kotlin 멀티모듈 도메인 감지
+
+Gradle 멀티모듈 구조의 Kotlin 프로젝트(예: CQRS 모노레포)용:
+
+| 단계 | 동작 | 예시 |
 |---|---|---|
-| **Java / Spring Boot** | `build.gradle`, `pom.xml` | 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 |
-| **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 |
+| 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 |
 
-### 자동 감지 항목 / Auto-detected Items
+지원 모듈 타입: `command`, `query`, `bff`, `integration`, `standalone`, `library`. 공유 라이브러리(`shared-lib`, `integration-lib`)는 특수 도메인으로 감지됩니다.
 
-- **언어 & 버전**: Java 17/21, TypeScript 5.x, Python 3.11+ 등
-- **프레임워크 & 버전**: Spring Boot 3.x, NestJS 10.x, Next.js 14/15, Django 5.x, FastAPI 0.100+
-- **ORM**: MyBatis, JPA/Hibernate, QueryDSL, Prisma, TypeORM, Sequelize, Drizzle, SQLAlchemy, Tortoise
-- **DB**: PostgreSQL, MySQL, Oracle, MongoDB, SQLite
-- **패키지 매니저**: Gradle, Maven, npm, yarn, pnpm, pip, poetry, pdm, pipenv
+### 프론트엔드 도메인 감지
 
-**스택을 직접 지정할 필요 없습니다. 자동으로 감지합니다.**
-**You don't need to specify the stack. It's detected automatically.**
+- **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
-
-### 필수 / Required
+## 빠른 시작
 
-1. **Node.js** (v18 이상 / v18 or above)
-   ```bash
-   node --version   # v18.0.0 이상 확인
-   ```
+### 사전 요구사항
 
-2. **Claude Code CLI** (설치 + 인증 완료 / installed & authenticated)
-   ```bash
-   claude -p "hello"   # 정상 응답 확인
-   ```
+- **Node.js** v18+
+- **Claude Code CLI** (설치 & 인증 완료)
 
-### 확인 방법 / How to Check
+### 설치
 
 ```bash
-# 두 명령 모두 정상 동작하면 준비 완료
-node --version        # v18.x.x 이상
-claude -p "hello"     # Claude가 응답하면 OK
+cd /your/project/root
+
+# 방법 A: npx (권장 — 설치 불필요)
+npx claudeos-core init
+
+# 방법 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분 후 모든 문서가 생성되어 바로 사용 가능합니다.
+
+### 수동 단계별 설치
 
-## 🚀 설치 및 실행 / Installation & Usage
+각 단계를 직접 제어하거나, 자동 파이프라인이 특정 단계에서 실패한 경우 수동으로 실행할 수 있습니다. ClaudeOS-Core의 내부 동작을 이해하는 데에도 유용합니다.
 
-### Step 1: 프로젝트에 도구 추가 / Add Tools to Your Project
+#### Step 1: 클론 및 의존성 설치
 
 ```bash
 cd /your/project/root
 
-# 방법 1: git clone (권장)
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+cd claudeos-core-tools && npm install && cd ..
+```
+
+#### Step 2: 디렉토리 구조 생성
 
-# 방법 2: zip 다운로드 후 압축 해제
-# claudeos-core-tools/ 폴더가 프로젝트 루트에 있어야 합니다
+```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 2: 실행 / Run
+#### Step 3: plan-installer 실행 (프로젝트 분석)
+
+프로젝트를 스캔하여 스택을 감지하고, 도메인을 찾고, 그룹으로 분할하고, 프롬프트를 생성합니다.
 
 ```bash
-# 방법 A: Node.js CLI (권장 / recommended)
-node claudeos-core-tools/bin/cli.js init
+node claudeos-core-tools/plan-installer/index.js
+```
 
-# 방법 B: bash (레거시 / legacy)
-bash claudeos-core-tools/bootstrap.sh
+**출력 (`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` — 생성 프롬프트
 
-# 방법 C: npx (npm publish 후 / after npm publish)
-npx claudeos-core init
+진행하기 전에 이 파일들을 검토하여 감지 정확도를 확인할 수 있습니다.
+
+#### 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
 ```
 
-**이게 전부입니다. / That's all.**
+**확인:** `ls claudeos-core/generated/pass1-*.json`으로 그룹당 하나의 JSON이 있는지 확인합니다.
+
+#### Step 5: Pass 2 — 분석 결과 통합
+
+```bash
+cat claudeos-core/generated/pass2-prompt.md \
+  | claude -p --dangerously-skip-permissions
+```
 
-실행하면 약 5~18분 후 모든 문서가 자동 생성됩니다.
-After running, all documentation is auto-generated in about 5-18 minutes.
+**확인:** `claudeos-core/generated/pass2-merged.json`이 존재하고 9개 이상의 최상위 키가 있어야 합니다.
 
-### Step 3: 사용 시작 / Start Using
+#### Step 6: Pass 3 — 전체 문서 생성
 
+```bash
+cat claudeos-core/generated/pass3-prompt.md \
+  | claude -p --dangerously-skip-permissions
 ```
-Claude Code에서 바로 사용:
-"주문(order) 도메인 CRUD 만들어줘"
+
+**확인:** 프로젝트 루트에 `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`이 이미 존재하면 자동 파이프라인이 건너뜁니다. 파일을 삭제하면 강제로 다시 실행됩니다.
+
+### 사용 시작
+
+```
+# Claude Code에서 자연스럽게 요청하면 됩니다:
+"주문 도메인 CRUD 만들어줘"
 "사용자 인증 API 추가해줘"
-"이 코드 리팩토링해줘"
+"이 코드를 프로젝트 패턴에 맞게 리팩토링해줘"
 
-Claude Code will reference the generated standards automatically:
-"Create a CRUD for the order domain"
-"Add user authentication API"
-"Refactor this code"
+# Claude Code가 생성된 Standards, Rules, Skills를 자동으로 참조합니다.
 ```
 
 ---
 
-## ⚙️ 작동 원리 / How It Works
-
-### 전체 흐름도 / Flow Diagram
+## 작동 원리 — 3-Pass 파이프라인
 
 ```
-bash claudeos-core-tools/bootstrap.sh
+npx claudeos-core init
     │
     ├── [1] npm install                    ← 의존성 설치 (~10초)
-    ├── [2] 디렉토리 구조 생성              ← 빈 폴더 생성 (~1초)
+    ├── [2] 디렉토리 구조 생성              ← 폴더 생성 (~1초)
     ├── [3] plan-installer (Node.js)       ← 프로젝트 스캔 (~5초)
     │       ├── 스택 자동 감지 (멀티스택 지원)
-    │       ├── 도메인(모듈) 목록 추출 (backend/frontend 태깅)
+    │       ├── 도메인 목록 추출 (backend/frontend 태깅)
     │       ├── 도메인 그룹 자동 분할 (타입별)
-    │       └── 스택에 맞는 프롬프트 선택 & 생성 (타입별)
+    │       └── 스택별 프롬프트 선택 (타입별)
     │
-    ├── [4] Pass 1 × N회 (claude -p)       ← 코드 깊이 분석 (~2-8분)
+    ├── [4] Pass 1 × N  (claude -p)       ← 코드 심층 분석 (~2-8분)
     │       ├── ⚙️ 백엔드 그룹 → 백엔드 분석 프롬프트
     │       └── 🎨 프론트엔드 그룹 → 프론트엔드 분석 프롬프트
     │
-    ├── [5] Pass 2 × 1회 (claude -p)       ← 분석 결과 통합 (~1분)
-    │       └── Pass 1 결과를 하나로 머지
+    ├── [5] Pass 2 × 1  (claude -p)       ← 분석 결과 통합 (~1분)
+    │       └── 전체 Pass 1 결과 통합 (백엔드 + 프론트엔드)
+    │
+    ├── [6] Pass 3 × 1  (claude -p)       ← 전체 생성 (~3-5분)
+    │       └── 결합 프롬프트 (백엔드 + 프론트엔드 대상)
     │
-    └── [6] Pass 3 × 1회 (claude -p)       ← 전체 파일 생성 (~3-5분)
-            └── Standards, Rules, Skills, Guides, Plans 생성
+    └── [7] 검증                           ← health checker 자동 실행
 ```
 
-### 3-Pass 파이프라인 상세 / 3-Pass Pipeline Details
-
-#### Pass 1 — 깊이 분석 / Deep Analysis (`claude -p` × N회)
-
-**유일하게 소스 코드를 직접 읽는 Pass입니다.**
-**The only pass that actually reads source code.**
-
-`project-analysis.json`을 참조하여 도메인 그룹별로 대표 파일을 선정하고 코드 패턴을 추출합니다.
-스택별로 분석 항목이 다릅니다:
-
-| 스택 | 분석 항목 수 | 주요 분석 대상 |
-|---|---|---|
-| Java/Spring | 10개 대분류, 59개 소분류 | Controller, Service, Repository, DTO, AOP, 트랜잭션 |
-| Node Express/NestJS | 9개 대분류, 57개 소분류 | Router, Service, ORM, DTO, Middleware, DI |
-| Next.js/React/Vue | 9개 대분류, 55개 소분류 | Page, Component, Data Fetching, State, Styling |
-| Python/Django | 10개 대분류, 55개 소분류 | View, Serializer, Model, Admin, Celery |
-| Python/FastAPI | 10개 대분류, 58개 소분류 | Router, Pydantic, SQLAlchemy, Depends, Middleware |
-
-모든 스택 공통 분석:
-- 설정/환경 패턴, 로깅 패턴, 테스트 패턴
-- 도메인 특화 패턴 (파일 업로드, WebSocket, 캐싱, 메시징 등)
-- 안티패턴 / 비일관성 / 보안 / 성능 문제
-
-**입력**: `project-analysis.json`
-**출력**: `pass1-1.json`, `pass1-2.json`, ... (도메인 그룹 수만큼)
-
-#### Pass 2 — 통합 / Merge (`claude -p` × 1회)
-
-**코드를 읽지 않습니다. JSON만 처리합니다.**
-**Does not read code. Only processes JSON.**
+### 왜 3 Pass인가?
 
-Pass 1 결과들을 하나로 통합합니다:
-- 전체 공통 패턴 (100% 공유)
-- 다수 공유 패턴 (50%+ 공유)
-- 도메인 특화 패턴
-- 안티패턴 심각도 분류 (CRITICAL/HIGH/MEDIUM/LOW)
-- 명명 규칙, 보안/인증, DB 패턴, 테스트 전략, 로깅, 성능, 코드 품질
+**Pass 1**은 소스코드를 직접 읽는 유일한 Pass입니다. 도메인 그룹별 대표 파일을 선정하고 55–95개 분석 카테고리(스택별)에서 패턴을 추출합니다. 대규모 프로젝트에서는 도메인 그룹당 한 번씩 여러 번 실행됩니다. 멀티스택 프로젝트(예: Java 백엔드 + React 프론트엔드)에서는 백엔드와 프론트엔드 도메인이 각 스택에 맞는 **별도의 분석 프롬프트**를 사용합니다.
 
-**입력**: `pass1-*.json`
-**출력**: `pass2-merged.json`
+**Pass 2**는 모든 Pass 1 결과를 통합 분석으로 병합합니다: 공통 패턴 (100% 공유), 다수 패턴 (50%+ 공유), 도메인 특화 패턴, 심각도별 안티패턴, 횡단 관심사 (명명, 보안, DB, 테스트, 로깅, 성능). 백엔드와 프론트엔드 결과가 함께 병합됩니다.
 
-#### Pass 3 — 생성 / Generate (`claude -p` × 1회)
-
-**코드를 읽지 않습니다. 분석 JSON만 참조합니다.**
-**Does not read code. Only references analysis JSON.**
-
-분석 결과를 기반으로 전체 ClaudeOS-Core 파일을 생성합니다:
-- CLAUDE.md, Standards, Rules, Skills, Guides, Plans, Database docs, MCP Guide
-- 모든 standard 파일에 ✅ 올바른 예시 / ❌ 잘못된 예시 포함
-- 마스터 플랜에 전체 파일 백업 (`<file>` 블록)
-
-**입력**: `project-analysis.json` + `pass2-merged.json`
-**출력**: 전체 파일 생성 + 검증 도구 실행 (manifest-generator → health-checker)
+**Pass 3**는 병합된 분석을 기반으로 전체 파일 생성을 수행합니다. 소스코드를 읽지 않고 분석 JSON만 참조합니다. 멀티스택 모드에서는 생성 프롬프트가 백엔드와 프론트엔드 대상을 결합하여 두 세트의 표준을 한 번에 생성합니다.
 
 ---
 
-## 📁 생성되는 파일 구조 / Generated File Structure
+## 생성되는 파일 구조
 
 ```
-프로젝트 루트 / Project Root
+your-project/
 │
 ├── CLAUDE.md                          ← Claude Code 진입점
 │
 ├── .claude/
-│   └── rules/                         ← glob 트리거 규칙 (⚠️ 최초 수동 승인 1회)
+│   └── rules/                         ← Glob 트리거 규칙
 │       ├── 00.core/
 │       ├── 10.backend/
 │       ├── 20.frontend/
@@ -244,166 +293,177 @@ Pass 1 결과들을 하나로 통합합니다:
 │
 ├── claudeos-core/                     ← 메인 출력 디렉토리
 │   ├── generated/                     ← 분석 JSON + 동적 프롬프트
-│   │   ├── project-analysis.json
-│   │   ├── domain-groups.json
-│   │   ├── pass1-{N}.json
-│   │   ├── pass2-merged.json
-│   │   ├── pass1-backend-prompt.md     ← 백엔드 분석 프롬프트
+│   │   ├── project-analysis.json      ← 스택 정보 (멀티스택 포함)
+│   │   ├── domain-groups.json         ← type: backend/frontend 태깅된 그룹
+│   │   ├── pass1-backend-prompt.md    ← 백엔드 분석 프롬프트
 │   │   ├── pass1-frontend-prompt.md   ← 프론트엔드 분석 프롬프트 (감지 시)
-│   │   ├── pass1-prompt.md            ← 단일스택 하위 호환
-│   │   ├── pass2-prompt.md
-│   │   ├── pass3-prompt.md
-│   │   └── (메타데이터 JSON 5종)
-│   │
-│   ├── standard/                      ← 코딩 표준 (15~17개 파일)
-│   │   ├── 00.core/                   ← 프로젝트 개요, 아키텍처, 명명규칙
-│   │   ├── 10.backend-api/            ← API 패턴 (스택별 맞춤)
+│   │   ├── pass2-prompt.md            ← 통합 프롬프트
+│   │   └── pass3-prompt.md            ← 생성 프롬프트 (결합)
+│   ├── standard/                      ← 코딩 표준 (15-19개 파일)
+│   │   ├── 00.core/                   ← 개요, 아키텍처, 명명 규칙
+│   │   ├── 10.backend-api/            ← API 패턴 (스택별)
 │   │   ├── 20.frontend-ui/            ← 프론트엔드 패턴 (감지 시)
-│   │   ├── 30.security-db/            ← 보안, DB 스키마, 공통 유틸
-│   │   ├── 40.infra/                  ← 환경설정, 로깅, CI/CD
-│   │   └── 50.verification/           ← 빌드 검증, 테스트 전략
-│   │
+│   │   ├── 30.security-db/            ← 보안, DB 스키마, 유틸리티
+│   │   ├── 40.infra/                  ← 설정, 로깅, CI/CD
+│   │   └── 50.verification/           ← 빌드 검증, 테스트
 │   ├── skills/                        ← CRUD 스캐폴딩 스킬
-│   │   ├── 10.backend-crud/           ← 백엔드 CRUD (스택별 맞춤)
-│   │   ├── 20.frontend-page/          ← 프론트엔드 페이지 (감지 시)
-│   │   └── 00.shared/MANIFEST.md      ← 스킬 레지스트리
-│   │
 │   ├── guide/                         ← 온보딩, FAQ, 트러블슈팅 (9개 파일)
 │   ├── plan/                          ← 마스터 플랜 (백업/복원)
 │   ├── database/                      ← DB 스키마, 마이그레이션 가이드
 │   └── mcp-guide/                     ← MCP 서버 연동 가이드
 │
-└── claudeos-core-tools/               ← 이 도구 (건드리지 않아도 됨)
+└── claudeos-core-tools/               ← 이 도구 (수정 불필요)
 ```
 
----
+모든 standard 파일은 ✅ 올바른 예시, ❌ 잘못된 예시, 규칙 요약 테이블을 포함합니다 — 제네릭 템플릿이 아닌 실제 코드 패턴에서 추출됩니다.
 
-## 📊 규모별 자동 조절 / Auto-scaling by Project Size
+---
 
-프로젝트 크기에 따라 Pass 1 횟수가 자동으로 조절됩니다.
-Pass 1 count auto-adjusts based on project size.
+## 규모별 자동 조절
 
-| 규모 / Size | 도메인 수 / Domains | Pass 1 횟수 / Pass 1 Runs | 총 claude -p | 예상 시간 / Est. Time |
+| 규모 | 도메인 수 | Pass 1 횟수 | 총 `claude -p` | 예상 시간 |
 |---|---|---|---|---|
-| 소규모 / Small | 1~4 | 1회 | 3회 | ~5분 |
-| 중규모 / Medium | 5~8 | 2회 | 4회 | ~8분 |
-| 대규모 / Large | 9~16 | 3~4회 | 5~6회 | ~12분 |
-| 초대규모 / XLarge | 17+ | 5회+ | 7회+ | ~18분+ |
+| 소규모 | 1–4 | 1 | 3 | ~5분 |
+| 중규모 | 5–8 | 2 | 4 | ~8분 |
+| 대규모 | 9–16 | 3–4 | 5–6 | ~12분 |
+| 초대규모 | 17+ | 5+ | 7+ | ~18분+ |
+
+멀티스택 프로젝트(예: Java + React)에서는 백엔드와 프론트엔드 도메인이 합산됩니다. 백엔드 6개 + 프론트엔드 4개 = 총 10개로 "대규모"로 스케일링됩니다.
 
 ---
 
-## 🔧 도구 상세 / Tool Reference
+## 검증 도구
 
-### bin/cli.js — Node.js CLI (권장 / Recommended)
+ClaudeOS-Core에는 생성 후 자동으로 실행되는 6개의 내장 검증 도구가 포함되어 있습니다:
 
 ```bash
-node claudeos-core-tools/bin/cli.js init       # 3-Pass 전체 실행
-node claudeos-core-tools/bin/cli.js health     # 종합 상태 확인
-node claudeos-core-tools/bin/cli.js validate   # Plan ↔ 디스크 비교
-node claudeos-core-tools/bin/cli.js refresh    # 디스크 → Plan 갱신
-node claudeos-core-tools/bin/cli.js restore    # Plan → 디스크 복원
-node claudeos-core-tools/bin/cli.js --help     # 도움말
-node claudeos-core-tools/bin/cli.js --version  # 버전 확인
-```
-
-`init` 실행 시 Node 18+ 및 Claude Code CLI 사전 조건을 자동 체크합니다.
-7단계를 자동으로 실행합니다 (의존성 → 구조 → 분석 → Pass 1~3 → 검증).
+# 한 번에 전체 확인 (권장)
+npx claudeos-core health
 
-### bootstrap.sh — 레거시 실행기 / Legacy Runner
+# 개별 명령어
+npx claudeos-core validate     # Plan ↔ 디스크 비교
+npx claudeos-core refresh      # 디스크 → Plan 동기화
+npx claudeos-core restore      # Plan → 디스크 복원
 
-```bash
-bash claudeos-core-tools/bootstrap.sh
+# node 직접 실행 (git clone 사용자)
+node claudeos-core-tools/health-checker/index.js
+node claudeos-core-tools/manifest-generator/index.js
+node claudeos-core-tools/import-linter/index.js
+node claudeos-core-tools/plan-validator/index.js --check
+node claudeos-core-tools/sync-checker/index.js
 ```
 
-6단계를 자동으로 실행합니다. `bin/cli.js init`과 동일한 결과입니다.
-
-### plan-installer/index.js — 프로젝트 분석기 / Project Analyzer
-
-프로젝트를 스캔하고 스택에 맞는 프롬프트를 생성합니다.
-
-| 출력 파일 | 설명 |
+| 도구 | 역할 |
 |---|---|
-| `project-analysis.json` | 스택, 도메인, 프론트엔드 정보 (멀티스택 포함) |
-| `domain-groups.json` | 도메인 그룹 분할 정보 (타입별 태깅) |
-| `pass1-{backend,frontend}-prompt.md` | 타입별 분석 프롬프트 |
-
-### 검증 도구 / Verification Tools
-
-설치 후 수동으로 실행하여 상태를 확인할 수 있습니다.
-You can run these manually after installation to check status.
-
-```bash
-# 종합 상태 확인 (이것 하나면 됨)
-node claudeos-core-tools/health-checker/index.js
-
-# 개별 실행
-node claudeos-core-tools/manifest-generator/index.js      # 메타데이터 재생성
-node claudeos-core-tools/import-linter/index.js            # @import 경로 검증
-node claudeos-core-tools/plan-validator/index.js --check   # Plan ↔ 디스크 비교
-node claudeos-core-tools/plan-validator/index.js --refresh # 디스크 → Plan 갱신
-node claudeos-core-tools/plan-validator/index.js --execute # Plan → 디스크 복원
-node claudeos-core-tools/sync-checker/index.js             # 동기화 확인
-```
+| **manifest-generator** | 메타데이터 JSON 생성 (rule-manifest, import-graph, sync-map, plan-manifest) |
+| **import-linter** | `@import` 경로 검증 — 깨진 경로, 중복, 순환 참조 탐지 (DFS) |
+| **plan-validator** | Master Plan `<file>` 블록과 디스크 비교 — check, refresh, restore 3가지 모드 |
+| **sync-checker** | 미등록 파일 (디스크에 있지만 Plan에 없는) 및 고아 항목 탐지 |
+| **content-validator** | 파일 품질 검증 — 빈 파일, ✅/❌ 예시 누락, 필수 섹션 확인 |
+| **pass-json-validator** | Pass 1–3 JSON 구조, 필수 키, 섹션 완성도 검증 |
 
 ---
 
-## 💡 일상 사용법 / Daily Usage
+## 일상 워크플로우
 
-### 설치 후 바로 사용 / Use Right After Installation
+### 설치 후
 
 ```
-# Claude Code에서 이렇게 말하면 됩니다:
+# Claude Code를 평소처럼 사용하면 됩니다 — 표준을 자동으로 참조합니다:
 "주문 도메인 CRUD 만들어줘"
 "사용자 프로필 수정 API 추가해줘"
 "이 코드를 프로젝트 패턴에 맞게 리팩토링해줘"
-
-# Claude Code는 자동으로:
-# 1. .claude/rules/ 규칙을 참조
-# 2. claudeos-core/standard/ 표준을 참조
-# 3. claudeos-core/skills/ 스킬을 실행
-# → 프로젝트 패턴에 맞는 코드를 생성합니다
 ```
 
-### 문서 수정 후 동기화 / Sync After Editing Docs
-
-standard 파일을 직접 수정했다면:
+### 표준을 직접 편집한 후
 
 ```bash
-# CLI 사용 (권장)
-node claudeos-core-tools/bin/cli.js refresh    # 마스터 플랜에 변경 사항 반영
-node claudeos-core-tools/bin/cli.js health     # 전체 상태 확인
+# 변경 사항을 Master Plan에 동기화
+npx claudeos-core refresh
 
-# 또는 직접 실행
-node claudeos-core-tools/plan-validator/index.js --refresh
-node claudeos-core-tools/health-checker/index.js
+# 전체 일관성 확인
+npx claudeos-core health
 ```
 
-### 문서가 깨졌을 때 복원 / Restore When Docs Are Broken
+### 문서가 깨졌을 때
 
 ```bash
-# CLI 사용 (권장)
-node claudeos-core-tools/bin/cli.js restore
-
-# 또는 직접 실행
-node claudeos-core-tools/plan-validator/index.js --execute
+# Master Plan에서 전체 복원
+npx claudeos-core restore
 ```
 
-### CI/CD 연동 / CI/CD Integration
+### CI/CD 연동
 
 ```yaml
 # GitHub Actions 예시
-- run: node claudeos-core-tools/bin/cli.js validate
-# exit code 1이면 PR 블록
+- run: npx claudeos-core validate
+# Exit code 1이면 PR 블록
 ```
 
 ---
 
+## 무엇이 다른가?
+
+| | ClaudeOS-Core | SuperClaude | 수동 CLAUDE.md | 제네릭 스킬 |
+|---|---|---|---|---|
+| **코드 분석** | ✅ 심층 분석 (55–95 카테고리) | ❌ 행동 주입 | ❌ 수동 작성 | ❌ 사전 제작 템플릿 |
+| **프로젝트 특화 출력** | ✅ 모든 파일이 실제 패턴 반영 | ❌ 제네릭 명령어 | 부분적 | ❌ 획일적 |
+| **멀티스택** | ✅ 자동 감지 + 별도 분석 | ❌ 스택 무관 | 수동 | 다양 |
+| **Kotlin + CQRS/BFF** | ✅ 멀티모듈, Command/Query 분리 | ❌ | ❌ | ❌ |
+| **자체 검증** | ✅ 6개 검증 도구 | ❌ | ❌ | ❌ |
+| **백업 / 복원** | ✅ Master Plan 시스템 | ❌ | ❌ | ❌ |
+| **설정 시간** | ~5–18분 (자동화) | ~5분 (수동 설정) | 수 시간–며칠 | ~5분 |
 
 ---
 
-## 모노레포 지원 / Monorepo Support
+## FAQ
+
+**Q: 소스코드를 수정하나요?**
+아니요. `CLAUDE.md`, `.claude/rules/`, `claudeos-core/`만 생성합니다. 기존 코드는 절대 수정하지 않습니다.
+
+**Q: 비용이 얼마나 드나요?**
+`claude -p`를 3–7회 호출합니다. 일반적인 Claude Code 사용량 내에서 처리됩니다.
+
+**Q: 생성된 파일을 Git에 커밋해야 하나요?**
+네, 권장합니다. 팀원 전체가 동일한 Claude Code 표준을 공유할 수 있습니다. `claudeos-core/generated/`는 `.gitignore`에 추가하는 것을 권장합니다 (분석 JSON은 재생성 가능).
+
+**Q: 멀티스택 프로젝트(예: Java 백엔드 + React 프론트엔드)는?**
+완전 지원됩니다. ClaudeOS-Core가 두 스택을 자동 감지하고, 도메인을 `backend`/`frontend`로 태깅하여 각각 스택별 분석 프롬프트를 사용합니다. Pass 2에서 통합하고, Pass 3에서 백엔드와 프론트엔드 표준을 한 번에 생성합니다.
+
+**Q: 재실행하면 어떻게 되나요?**
+Pass 1/2 JSON이 이미 존재하면 해당 단계를 건너뜁니다. Pass 3는 항상 재실행됩니다. 이전 버전은 Master Plans에서 복원할 수 있습니다.
 
-ClaudeOS-Core는 **현재 디렉토리**의 `package.json`을 읽습니다. 모노레포(Turborepo, Nx, Lerna, pnpm workspaces) 환경에서는 루트 `package.json`에 `next`, `express`, `react` 같은 프레임워크 의존성이 없는 경우가 많습니다 — 개별 앱 디렉토리에 있기 때문입니다.
+**Q: Kotlin을 지원하나요?**
+네. ClaudeOS-Core는 `build.gradle.kts` 또는 `build.gradle`의 kotlin 플러그인에서 Kotlin을 자동 감지합니다. Kotlin 전용 `kotlin-spring` 템플릿을 사용하여 data class, sealed class, 코루틴, 확장 함수, MockK 등 Kotlin 고유 패턴을 분석합니다.
+
+**Q: CQRS / BFF 아키텍처는?**
+Kotlin 멀티모듈 프로젝트에서 완전 지원됩니다. `settings.gradle.kts`를 읽어 모듈명에서 타입(command, query, bff, integration)을 감지하고, 같은 도메인의 Command/Query 모듈을 그룹핑합니다. 생성되는 표준에는 command controller vs query controller 별도 규칙, BFF/Feign 패턴, 모듈 간 통신 규칙이 포함됩니다.
+
+**Q: Gradle 멀티모듈 모노레포는?**
+ClaudeOS-Core는 중첩 깊이에 관계없이 모든 서브모듈(`**/src/main/kotlin/**/*.kt`)을 스캔합니다. 모듈 타입은 이름 규칙으로 추론됩니다 (예: `reservation-command-server` → 도메인: `reservation`, 타입: `command`). 공유 라이브러리(`shared-lib`, `integration-lib`)도 감지됩니다.
+
+---
+
+## 템플릿 구조
+
+```
+pass-prompts/templates/
+├── common/                  # 공통 헤더/푸터
+├── java-spring/             # Java / Spring Boot
+├── kotlin-spring/           # Kotlin / Spring Boot (CQRS, BFF, 멀티모듈)
+├── node-express/            # Node.js / Express / NestJS
+├── node-nextjs/             # Next.js / React / Vue
+├── python-django/           # Python / Django (DRF)
+└── python-fastapi/          # Python / FastAPI
+```
+
+`plan-installer`가 스택을 자동 감지한 후 타입별 프롬프트를 조합합니다. 멀티스택 프로젝트에서는 `pass1-backend-prompt.md`와 `pass1-frontend-prompt.md`가 별도로 생성되고, `pass3-prompt.md`는 두 스택의 생성 대상을 결합합니다.
+
+---
+
+## 모노레포 지원
+
+ClaudeOS-Core는 **현재 디렉토리**의 `package.json`을 읽습니다. 모노레포 환경(Turborepo, Nx, Lerna, pnpm workspaces)에서는 루트 `package.json`에 `next`, `express`, `react` 같은 프레임워크 의존성이 없는 경우가 많습니다 — 개별 앱 디렉토리에 있기 때문입니다.
 
 **모노레포 루트가 아닌 앱 디렉토리에서 실행하세요:**
 
@@ -417,7 +477,7 @@ cd apps/frontend
 npx claudeos-core init
 ```
 
-각 앱이 해당 앱의 스택과 패턴에 맞는 독립적인 Standards, Rules, Skills, Guides를 갖게 됩니다.
+각 앱은 해당 스택과 패턴에 맞는 독립적인 Standards, Rules, Skills, Guides를 갖게 됩니다.
 
 **일반적인 모노레포 구조:**
 
@@ -433,129 +493,36 @@ my-monorepo/                    ← 여기서 실행하지 마세요 (루트에
 └── package.json                ← devDependencies만 (turbo, eslint 등)
 ```
 
-## 🔍 문제 해결 / Troubleshooting
+## 트러블슈팅
 
-### "claude: command not found"
+**"claude: command not found"** — Claude Code CLI가 설치되지 않았거나 PATH에 없습니다. [Claude Code 공식 문서](https://code.claude.com/docs/en/overview)를 참조하세요.
 
-Claude Code CLI가 설치되지 않았거나 PATH에 없습니다.
-Claude Code CLI is not installed or not in PATH.
+**"npm install 실패"** — Node.js 버전이 낮을 수 있습니다. v18+ 필요.
 
-```bash
-# 설치 확인
-which claude
-claude --version
+**"도메인 0개 감지됨"** — 프로젝트 구조가 비표준일 수 있습니다. 스택별 감지 패턴은 위의 [지원 스택](#지원-스택) 섹션을 참조하세요.
 
-# 설치 방법: https://code.claude.com/docs/en/overview
-```
+**Kotlin 프로젝트에서 "도메인 0개 감지됨"** — 프로젝트 루트에 `build.gradle.kts` (또는 kotlin 플러그인이 있는 `build.gradle`)가 있고, 소스 파일이 `**/src/main/kotlin/` 아래에 있는지 확인하세요. 멀티모듈 프로젝트는 `settings.gradle.kts`에 `include()` 문이 포함되어 있어야 합니다. 단일 모듈 Kotlin 프로젝트(`settings.gradle` 없음)도 지원됩니다 — `src/main/kotlin/` 하위 패키지/클래스 구조에서 도메인을 추출합니다.
 
-### "npm install 실패"
+**"언어가 kotlin 대신 java로 감지됨"** — ClaudeOS-Core는 루트 `build.gradle(.kts)`를 먼저 확인한 후 서브모듈 빌드 파일을 확인합니다. 루트 빌드 파일이 `kotlin` 없이 `java` 플러그인만 사용하는 경우, 최대 5개 서브모듈 빌드 파일을 폴백으로 검사합니다. 그래도 감지되지 않으면 최소 하나의 `build.gradle.kts`에 `kotlin("jvm")` 또는 `org.jetbrains.kotlin`이 포함되어 있는지 확인하세요.
 
-Node.js 버전이 낮을 수 있습니다.
-Node.js version might be too low.
-
-```bash
-node --version   # v18 이상 필요
-```
-
-### "파일 쓰기 권한 프롬프트 / File write permission prompt"
-
-`bootstrap.sh`는 `--dangerously-skip-permissions` 플래그를 사용하므로 권한 확인 없이 자동으로 처리됩니다.
-별도 승인이 필요하지 않습니다.
-
-`bootstrap.sh` uses the `--dangerously-skip-permissions` flag, so file write permissions are handled automatically.
-No manual approval is required.
-
-### "도메인이 0개로 감지됨"
-
-프로젝트 구조가 비표준일 수 있습니다. plan-installer가 다음 패턴을 찾습니다:
-
-| 스택 | 찾는 패턴 |
-|---|---|
-| Java | `src/main/java/**/controller/*/` |
-| NestJS | `src/modules/*/` 또는 `src/*/` |
-| Next.js | `app/*/`, `pages/*/`, `components/*/` |
-| Django | `**/models.py`가 있는 디렉토리 |
-| FastAPI | `**/{router,routes,endpoints}*.py`가 있는 디렉토리 |
+**"CQRS가 감지되지 않음"** — 아키텍처 감지는 모듈명에 `command`와 `query` 키워드가 포함되어야 합니다. 다른 이름을 사용하는 경우(예: `write-server`, `read-server`) CQRS가 자동 감지되지 않습니다. plan-installer 실행 후 생성된 프롬프트를 수동으로 조정할 수 있습니다.
 
 ---
 
-## ❓ FAQ
-
-### Q: 실행 비용이 얼마나 드나요? / How much does it cost?
-
-`claude -p`를 3~7회 호출합니다. Claude Code의 일반 사용량 내에서 처리됩니다.
-Calls `claude -p` 3-7 times. This is within normal Claude Code usage.
-
-### Q: 기존 프로젝트 파일을 수정하나요? / Does it modify existing project files?
-
-아니요. `CLAUDE.md`, `.claude/rules/`, `claudeos-core/` 만 생성합니다.
-기존 소스 코드는 **절대 수정하지 않습니다.**
-
-No. Only creates `CLAUDE.md`, `.claude/rules/`, and `claudeos-core/`.
-It **never modifies** existing source code.
-
-### Q: Git에 커밋해야 하나요? / Should I commit to Git?
-
-**네, 권장합니다.** 팀원도 같은 Claude Code 표준을 사용할 수 있습니다.
-`.gitignore`에 `claudeos-core/generated/` 를 추가하는 것을 권장합니다 (분석 JSON은 재생성 가능).
-
-**Yes, recommended.** Team members can use the same Claude Code standards.
-Consider adding `claudeos-core/generated/` to `.gitignore` (analysis JSON is regeneratable).
-
-### Q: 여러 스택이 섞인 프로젝트는? / Mixed-stack projects?
-
-Java 백엔드 + React 프론트엔드 같은 모노레포를 완전 지원합니다.
-양쪽 스택을 자동 감지하고, 도메인을 backend/frontend로 태깅하여,
-각각에 맞는 분석 프롬프트로 Pass 1을 실행합니다.
-Pass 2에서 통합, Pass 3에서 양쪽 표준을 한 번에 생성합니다.
-
-For monorepos like Java backend + React frontend, both stacks are fully supported.
-Domains are tagged as backend/frontend and analyzed with stack-specific prompts.
+## 기여
 
-### Q: 재실행하면 어떻게 되나요? / What happens if I re-run?
+기여를 환영합니다! 도움이 가장 필요한 영역:
 
-이미 완료된 Pass 1/2의 JSON이 존재하면 해당 단계를 건너뜁니다 (skip).
-Pass 3은 항상 재실행되며 `claudeos-core/` 파일이 덮어써집니다.
-마스터 플랜(`claudeos-core/plan/`)으로 이전 버전을 복원할 수 있습니다.
-
-If pass1/2 JSON files already exist, those steps are skipped automatically.
-Pass 3 always re-runs and overwrites `claudeos-core/` files.
-Previous versions can be restored from master plans (`claudeos-core/plan/`).
+- **새 스택 템플릿** — Ruby/Rails, Go/Gin, PHP/Laravel, Rust/Axum
+- **모노레포 심화 지원** — 서브프로젝트 루트 분리, 워크스페이스 감지
+- **테스트 커버리지** — 전체 검증 도구 단위 테스트
 
 ---
 
-## 📂 템플릿 구조 / Template Structure
-
-```
-pass-prompts/templates/
-├── common/                  # 공통 헤더/푸터 / Common header/footer
-├── java-spring/             # Java / Spring Boot
-│   ├── pass1.md             # 깊이 분석 프롬프트 / Deep analysis prompt
-│   ├── pass2.md             # 통합 프롬프트 / Merge prompt
-│   └── pass3.md             # 생성 프롬프트 / Generate prompt
-├── node-express/            # Node.js / Express / NestJS
-├── node-nextjs/             # Next.js / React / Vue
-├── python-django/           # Python / Django (DRF)
-└── python-fastapi/          # Python / FastAPI
-```
-
-plan-installer가 프로젝트 스택을 자동 감지한 후,
-`common/header.md` + 스택 본문 + `common/pass3-footer.md`를 조합하여
-타입별 프롬프트를 생성합니다. 멀티스택 프로젝트에서는 백엔드/프론트엔드
-각각의 pass1 프롬프트가 생성되고, pass3는 양쪽이 결합됩니다.
-
-After auto-detecting the project stack, plan-installer assembles
-type-specific prompts. For multi-stack projects, separate pass1 prompts
-are generated for backend and frontend, while pass3 combines both.
+## 만든 사람
 
----
+**claudeos-core** — [GitHub](https://github.com/claudeos-core) · [Email](mailto:claudeoscore@gmail.com)
 
-## 📜 라이선스 / License
+## 라이선스
 
 ISC
-
----
-
-## 만든 사람
-
-**claudeos-core** — [GitHub](https://github.com/claudeos-core) · [Email](mailto:claudeoscore@gmail.com)