claudeos-core 1.0.7 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of claudeos-core might be problematic. Click here for more details.

Files changed (44) hide show
  1. package/CHANGELOG.md +84 -1
  2. package/CONTRIBUTING.md +15 -4
  3. package/README.de.md +187 -11
  4. package/README.es.md +187 -11
  5. package/README.fr.md +187 -11
  6. package/README.hi.md +187 -11
  7. package/README.ja.md +186 -10
  8. package/README.ko.md +331 -364
  9. package/README.md +200 -11
  10. package/README.ru.md +187 -11
  11. package/README.vi.md +188 -12
  12. package/README.zh-CN.md +186 -10
  13. package/bin/cli.js +183 -61
  14. package/bootstrap.sh +128 -21
  15. package/content-validator/index.js +131 -60
  16. package/health-checker/index.js +29 -23
  17. package/import-linter/index.js +14 -8
  18. package/manifest-generator/index.js +26 -20
  19. package/package.json +84 -75
  20. package/pass-json-validator/index.js +92 -70
  21. package/pass-prompts/templates/common/header.md +4 -4
  22. package/pass-prompts/templates/common/lang-instructions.json +27 -0
  23. package/pass-prompts/templates/common/pass3-footer.md +2 -3
  24. package/pass-prompts/templates/java-spring/pass1.md +84 -81
  25. package/pass-prompts/templates/java-spring/pass2.md +66 -66
  26. package/pass-prompts/templates/java-spring/pass3.md +60 -60
  27. package/pass-prompts/templates/kotlin-spring/pass1.md +172 -0
  28. package/pass-prompts/templates/kotlin-spring/pass2.md +109 -0
  29. package/pass-prompts/templates/kotlin-spring/pass3.md +98 -0
  30. package/pass-prompts/templates/node-express/pass1.md +73 -73
  31. package/pass-prompts/templates/node-express/pass2.md +66 -66
  32. package/pass-prompts/templates/node-express/pass3.md +53 -53
  33. package/pass-prompts/templates/node-nextjs/pass1.md +68 -68
  34. package/pass-prompts/templates/node-nextjs/pass2.md +61 -61
  35. package/pass-prompts/templates/node-nextjs/pass3.md +48 -48
  36. package/pass-prompts/templates/python-django/pass1.md +78 -78
  37. package/pass-prompts/templates/python-django/pass2.md +69 -69
  38. package/pass-prompts/templates/python-django/pass3.md +45 -45
  39. package/pass-prompts/templates/python-fastapi/pass1.md +76 -76
  40. package/pass-prompts/templates/python-fastapi/pass2.md +67 -67
  41. package/pass-prompts/templates/python-fastapi/pass3.md +45 -45
  42. package/plan-installer/index.js +623 -97
  43. package/plan-validator/index.js +54 -23
  44. package/sync-checker/index.js +25 -14
@@ -0,0 +1,98 @@
1
+ Read claudeos-core/generated/project-analysis.json and
2
+ claudeos-core/generated/pass2-merged.json, then
3
+ generate all ClaudeOS-Core files based on the analysis results.
4
+
5
+ Do not read the original source code again. Reference only the analysis results.
6
+
7
+ Generation targets:
8
+
9
+ 1. CLAUDE.md (project root)
10
+ - Role definition (Kotlin + Spring Boot + multi-module, mention CQRS if detected)
11
+ - Build & Run Commands (Gradle tasks per module, e.g., :servers:command:reservation-command-server:bootRun)
12
+ - Multi-module architecture diagram (BFF → Feign → Command/Query → DB)
13
+ - Module list with ports and roles
14
+ - DB table naming conventions
15
+ - Standard/Skills/Guide reference table
16
+
17
+ 2. claudeos-core/standard/ (active domains only)
18
+ - 00.core/01.project-overview.md — Stack (Kotlin version, Spring Boot version), module list, server ports
19
+ - 00.core/02.architecture.md — CQRS architecture, BFF layer, request flow (Client → BFF → Feign → Command/Query → DB), module dependency diagram
20
+ - 00.core/03.naming-conventions.md — Kotlin class/file/package naming, DTO naming (Command vs Query DTOs), module naming
21
+ - 10.backend-api/01.controller-patterns.md — Command controller vs Query controller rules + examples
22
+ - 10.backend-api/02.service-patterns.md — Transactions, DI, Kotlin idioms, command/query service separation
23
+ - 10.backend-api/03.data-access-patterns.md — ORM patterns (tailored to detected JPA/MyBatis/Exposed), read/write DB config
24
+ - 10.backend-api/04.response-exception.md — Response/error handling patterns, sealed class exceptions
25
+ - 10.backend-api/05.dto-vo-validation.md — Kotlin data class DTO rules, VO patterns (value class, immutability, equality by value), DTO vs VO usage guide, validation, nullable rules
26
+ - 10.backend-api/06.aggregate-patterns.md — Aggregate boundary definition, Aggregate Root rules, repository-per-aggregate, inter-aggregate references (by ID only), domain event publishing, Aggregator service patterns (SKIP if no DDD/Aggregate patterns detected in pass2-merged.json)
27
+ - 10.backend-api/07.bff-feign-patterns.md — BFF controller patterns, Feign Client conventions, response composition, error propagation (SKIP if project-analysis.json shows no BFF/CQRS architecture)
28
+ - 10.backend-api/08.inter-module-communication.md — Feign contracts, Pub/Sub events, shared library usage rules (SKIP if single-module project without multi-module in project-analysis.json)
29
+ - 20.frontend-ui/* — (generate only if frontend detected)
30
+ - 30.security-db/01.security-auth.md — Authentication, authorization, CORS, inter-module auth
31
+ - 30.security-db/02.database-schema.md — DDL, migrations, audit columns, read/write DB separation
32
+ - 30.security-db/03.common-utilities.md — Shared-lib utilities, extension functions, constants, Base classes
33
+ - 40.infra/01.environment-config.md — Profiles, multi-module config, Gradle Kotlin DSL, environment variables
34
+ - 40.infra/02.logging-monitoring.md — kotlin-logging standards, structured logging, distributed tracing
35
+ - 40.infra/03.cicd-deployment.md — CI/CD pipeline, Docker/K8s per module, deployment strategy
36
+ - 50.verification/01.development-verification.md — Build, startup (per module), API testing
37
+ - 50.verification/02.testing-strategy.md — Testing strategy (MockK, Kotest), per-module test approach
38
+
39
+ Each file MUST include:
40
+ - Correct examples (✅ code blocks in Kotlin)
41
+ - Incorrect examples (❌ code blocks showing common mistakes)
42
+ - Key rules summary table
43
+
44
+ 3. .claude/rules/ (active domains only)
45
+ - Each rule file must include paths: frontmatter (matching this project's module paths, e.g., servers/command/**/*)
46
+ - Write 5-10 lines of key rules directly
47
+ - Reference detailed standards via @import (path: @../../claudeos-core/standard/...)
48
+ - Reference skills orchestrator via @import
49
+ - CQRS-specific rules: separate rule files for command/* and query/* paths
50
+
51
+ 4. .claude/rules/50.sync/ (3 sync rules)
52
+ - 01.standard-sync.md — Auto-update plan/10 when standard is modified
53
+ - 02.rules-sync.md — Auto-update plan/20 when rules is modified
54
+ - 03.skills-sync.md — Auto-update plan/30 when skills is modified
55
+
56
+ 5. claudeos-core/skills/ (active domains only)
57
+ - 10.backend-crud/01.scaffold-crud-feature.md (orchestrator — CQRS-aware: creates both command and query modules)
58
+ - 10.backend-crud/scaffold-crud-feature/01.command-controller.md
59
+ - 10.backend-crud/scaffold-crud-feature/02.command-service.md
60
+ - 10.backend-crud/scaffold-crud-feature/03.query-controller.md
61
+ - 10.backend-crud/scaffold-crud-feature/04.query-service.md
62
+ - 10.backend-crud/scaffold-crud-feature/05.repository.md
63
+ - 10.backend-crud/scaffold-crud-feature/06.entity.md
64
+ - 10.backend-crud/scaffold-crud-feature/07.dto-vo.md (DTO and VO scaffolding — includes value class VO template)
65
+ - 10.backend-crud/scaffold-crud-feature/08.bff-endpoint.md (SKIP if no BFF architecture detected)
66
+ - 10.backend-crud/scaffold-crud-feature/09.feign-client.md (SKIP if no BFF/multi-module detected)
67
+ - 10.backend-crud/scaffold-crud-feature/10.migration.md
68
+ - 10.backend-crud/scaffold-crud-feature/11.test.md
69
+ - 10.backend-crud/scaffold-crud-feature/12.aggregate.md (Aggregate Root template — SKIP if no DDD/Aggregate patterns detected)
70
+ - 10.backend-crud/scaffold-crud-feature/13.index.md
71
+ - 20.frontend-page/* (only if frontend detected)
72
+ - 00.shared/MANIFEST.md (skill registry)
73
+
74
+ 6. claudeos-core/guide/ (all)
75
+ - 01.onboarding/01.overview.md
76
+ - 01.onboarding/02.quickstart.md
77
+ - 01.onboarding/03.glossary.md (include CQRS/BFF/Feign/Aggregate/AggregateRoot/VO terminology)
78
+ - 02.usage/01.faq.md
79
+ - 02.usage/02.real-world-examples.md (include multi-module CRUD example)
80
+ - 02.usage/03.do-and-dont.md (include CQRS boundary rules)
81
+ - 03.troubleshooting/01.troubleshooting.md
82
+ - 04.architecture/01.file-map.md (show all modules and their relationships)
83
+ - 04.architecture/02.pros-and-cons.md
84
+
85
+ 7. claudeos-core/plan/ (Master Plan — insert full file content in <file> blocks)
86
+ - 10.standard-master.md — CLAUDE.md + all standard/ files as <file> blocks
87
+ - 20.rules-master.md — All rules/ (except sync) as <file> blocks
88
+ - 21.sync-rules-master.md — All sync rules (code block format)
89
+ - 30.backend-skills-master.md — All backend skills as <file> blocks
90
+ - 31.frontend-skills-master.md — All frontend skills as <file> blocks (if frontend detected)
91
+ - 40.guides-master.md — All guide/ files as <file> blocks
92
+
93
+ 8. claudeos-core/database/ (DB documentation)
94
+ - 01.schema-overview.md — Table list, ER diagram description, read/write DB separation
95
+ - 02.migration-guide.md — Migration procedure, rollback methods
96
+
97
+ 9. claudeos-core/mcp-guide/ (MCP server integration guide)
98
+ - 01.mcp-overview.md — List of MCP servers in use, integration methods
@@ -1,88 +1,88 @@
1
- claudeos-core/generated/project-analysis.json 읽고,
2
- 다음 도메인만 깊이 분석해줘: {{DOMAIN_GROUP}}
1
+ Read claudeos-core/generated/project-analysis.json and
2
+ perform a deep analysis of the following domains only: {{DOMAIN_GROUP}}
3
3
 
4
- 도메인에서 레이어별 대표 파일을 1개씩 선정하여 코드를 읽고 분석해줘.
5
- 가장 패턴이 풍부한 파일을 우선 선정할 것.
4
+ For each domain, select one representative file per layer, read its code, and analyze it.
5
+ Prioritize files with the richest patterns.
6
6
 
7
- 분석 항목 (도메인별로):
7
+ Analysis items (per domain):
8
8
 
9
- 1. Router/Controller 패턴
10
- - 라우팅 방식 (Express Router vs NestJS @Controller)
11
- - 미들웨어 체인 (auth, validation, error handler, 등록 순서)
12
- - URL 패턴 (RESTful 규칙, 네이밍, 버저닝)
13
- - 파라미터 처리 (req.body, req.params, req.query, @Body(), @Param(), @Query())
14
- - 응답 형식 (res.json, interceptor, class-transformer, 커스텀 래퍼)
15
- - 에러 핸들링 (try-catch, HttpException, ExceptionFilter, error middleware)
16
- - 인증 (Passport, JWT Guard, 커스텀 미들웨어)
17
- - API 문서화 (Swagger @ApiTags, @ApiOperation, JSDoc)
18
- - 페이지네이션 (offset/limit, cursor, 커스텀)
9
+ 1. Router/Controller Patterns
10
+ - Routing approach (Express Router vs NestJS @Controller)
11
+ - Middleware chain (auth, validation, error handler, registration order)
12
+ - URL patterns (RESTful conventions, naming, versioning)
13
+ - Parameter handling (req.body, req.params, req.query, @Body(), @Param(), @Query())
14
+ - Response format (res.json, interceptor, class-transformer, custom wrapper)
15
+ - Error handling (try-catch, HttpException, ExceptionFilter, error middleware)
16
+ - Authentication (Passport, JWT Guard, custom middleware)
17
+ - API documentation (Swagger @ApiTags, @ApiOperation, JSDoc)
18
+ - Pagination (offset/limit, cursor, custom)
19
19
 
20
- 2. Service 패턴
21
- - 의존성 주입 (NestJS @Injectable vs 수동 주입 vs factory)
22
- - 트랜잭션 전략 (Prisma.$transaction, TypeORM QueryRunner, Sequelize.transaction, Knex transaction)
23
- - 비즈니스 예외 처리 (커스텀 Exception 계층, HttpException)
24
- - 검증 (class-validator, Joi, Zod)
25
- - 이벤트 처리 (EventEmitter, NestJS @OnEvent)
20
+ 2. Service Patterns
21
+ - Dependency injection (NestJS @Injectable vs manual injection vs factory)
22
+ - Transaction strategy (Prisma.$transaction, TypeORM QueryRunner, Sequelize.transaction, Knex transaction)
23
+ - Business exception handling (custom Exception hierarchy, HttpException)
24
+ - Validation (class-validator, Joi, Zod)
25
+ - Event handling (EventEmitter, NestJS @OnEvent)
26
26
 
27
- 3. 데이터 접근 패턴
28
- - ORM/쿼리빌더 (Prisma, TypeORM, Sequelize, Knex, Drizzle, Mongoose)
29
- - Repository 패턴 사용 여부
30
- - 쿼리 최적화 (N+1 방지, include/join/populate 전략)
31
- - 마이그레이션 도구 (Prisma Migrate, TypeORM Migration, Knex Migration, Mongoose versioning)
32
- - 시드 데이터 관리
33
- - 커넥션 관리 (풀, 재시도)
34
- - 동적 쿼리 패턴
27
+ 3. Data Access Patterns
28
+ - ORM/query builder (Prisma, TypeORM, Sequelize, Knex, Drizzle, Mongoose)
29
+ - Repository pattern usage
30
+ - Query optimization (N+1 prevention, include/join/populate strategy)
31
+ - Migration tools (Prisma Migrate, TypeORM Migration, Knex Migration, Mongoose versioning)
32
+ - Seed data management
33
+ - Connection management (pool, retry)
34
+ - Dynamic query patterns
35
35
 
36
- 4. DTO/타입 패턴
37
- - 유효성 검증 데코레이터 (class-validator)
38
- - 스키마 정의 (Zod, Joi, JSON Schema, Yup)
39
- - Request/Response 타입 분리
40
- - TypeScript 활용도 (interface vs type vs class, Generic 활용)
41
- - 직렬화/역직렬화 (class-transformer, custom serializer)
42
- - Enum/상수 관리
36
+ 4. DTO/Type Patterns
37
+ - Validation decorators (class-validator)
38
+ - Schema definition (Zod, Joi, JSON Schema, Yup)
39
+ - Request/Response type separation
40
+ - TypeScript usage level (interface vs type vs class, Generic usage)
41
+ - Serialization/deserialization (class-transformer, custom serializer)
42
+ - Enum/constants management
43
43
 
44
- 5. 설정/환경 패턴
45
- - 환경변수 관리 (@nestjs/config, dotenv, envalid)
46
- - 환경별 분기 (development/staging/production)
47
- - 설정 검증 (Joi schema, Zod)
48
- - 외부 설정 파일 구조
44
+ 5. Configuration/Environment Patterns
45
+ - Environment variable management (@nestjs/config, dotenv, envalid)
46
+ - Per-environment branching (development/staging/production)
47
+ - Configuration validation (Joi schema, Zod)
48
+ - External config file structure
49
49
 
50
- 6. 로깅 패턴
51
- - 로거 사용 (winston, pino, NestJS Logger, morgan)
52
- - 로그 레벨 정책
53
- - 구조화 로깅 (JSON 포맷, correlation ID)
54
- - 요청/응답 로깅 (미들웨어/인터셉터)
50
+ 6. Logging Patterns
51
+ - Logger usage (winston, pino, NestJS Logger, morgan)
52
+ - Log level policy
53
+ - Structured logging (JSON format, correlation ID)
54
+ - Request/response logging (middleware/interceptor)
55
55
 
56
- 7. 테스트 패턴
57
- - 테스트 프레임워크 (Jest, Vitest, Mocha)
58
- - 테스트 분류 (단위/통합/E2E)
59
- - 모킹 전략 (jest.mock, jest.spyOn, Test Module)
60
- - 테스트 데이터 관리 (Factory, Fixture, Faker)
61
- - 테스트 네이밍 규칙
62
- - DB 테스트 전략 (in-memory, test container, 별도 DB)
56
+ 7. Testing Patterns
57
+ - Test framework (Jest, Vitest, Mocha)
58
+ - Test classification (unit/integration/E2E)
59
+ - Mocking strategy (jest.mock, jest.spyOn, Test Module)
60
+ - Test data management (Factory, Fixture, Faker)
61
+ - Test naming conventions
62
+ - DB test strategy (in-memory, test container, separate DB)
63
63
 
64
- 8. 도메인만의 특화 패턴
65
- - 파일 업로드 (Multer, S3, presigned URL)
66
- - WebSocket/실시간 통신 (Socket.io, ws)
67
- - 큐/배치 처리 (Bull, BullMQ, Agenda)
68
- - 외부 API 연동 (Axios, fetch, HttpService, got)
69
- - 캐싱 (Redis, in-memory, cache-manager)
70
- - 이벤트 기반 (EventEmitter, CQRS, Saga)
71
- - 메시징 (Kafka, RabbitMQ, SQS)
72
- - 국제화 (i18next, nestjs-i18n)
73
- - API 버저닝 전략
64
+ 8. Domain-Specific Patterns
65
+ - File upload (Multer, S3, presigned URL)
66
+ - WebSocket/real-time (Socket.io, ws)
67
+ - Queue/batch processing (Bull, BullMQ, Agenda)
68
+ - External API integration (Axios, fetch, HttpService, got)
69
+ - Caching (Redis, in-memory, cache-manager)
70
+ - Event-driven (EventEmitter, CQRS, Saga)
71
+ - Messaging (Kafka, RabbitMQ, SQS)
72
+ - Internationalization (i18next, nestjs-i18n)
73
+ - API versioning strategy
74
74
  - Rate Limiting
75
75
 
76
- 9. 안티패턴 / 비일관성
77
- - 도메인 내에서 스타일이 다른 코드
78
- - 다른 도메인과 불일치하는 패턴
79
- - 레거시로 보이는 패턴
80
- - 타입 안정성 문제 (any 남용, 타입 누락)
81
- - 성능 문제 (메모리 누수, 블로킹 I/O)
82
- - 보안 문제 (인젝션, 권한 누락)
76
+ 9. Anti-patterns / Inconsistencies
77
+ - Code with differing styles within the domain
78
+ - Patterns inconsistent with other domains
79
+ - Legacy-looking patterns
80
+ - Type safety issues (any abuse, missing types)
81
+ - Performance issues (memory leaks, blocking I/O)
82
+ - Security issues (injection, missing authorization)
83
83
 
84
- 파일 생성은 하지 마. 분석만.
85
- 결과를 claudeos-core/generated/pass1-{{PASS_NUM}}.json 아래 형식으로 저장:
84
+ Do not create files. Analysis only.
85
+ Save results to claudeos-core/generated/pass1-{{PASS_NUM}}.json in the following format:
86
86
 
87
87
  {
88
88
  "analyzedAt": "ISO timestamp",
@@ -111,7 +111,7 @@ claudeos-core/generated/project-analysis.json을 읽고,
111
111
  }
112
112
  },
113
113
  "crossDomainCommon": {
114
- "description": " 그룹의 도메인들이 공통으로 사용하는 패턴",
114
+ "description": "Patterns commonly used across domains in this group",
115
115
  "patterns": []
116
116
  }
117
117
  }
@@ -1,81 +1,81 @@
1
- claudeos-core/generated/ 디렉토리에서 pass1-*.json 파일을 전부 읽고,
2
- 모든 도메인의 분석 결과를 하나로 통합해줘.
1
+ Read all pass1-*.json files from the claudeos-core/generated/ directory and
2
+ merge all domain analysis results into a single unified report.
3
3
 
4
- 통합 항목:
4
+ Merge items:
5
5
 
6
- 1. 전체 공통 패턴 (모든 도메인이 100% 공유하는 )
7
- - Router/Controller 스타일 (라우팅, 미들웨어, 응답 형식)
8
- - Service 의존성 주입 전략
9
- - 데이터 접근 패턴 (ORM, Repository)
10
- - DTO/타입 정의 규칙
11
- - 에러 핸들링 패턴
12
- - 미들웨어 체인 순서
6
+ 1. Universal Patterns (shared by 100% of all domains)
7
+ - Router/Controller style (routing, middleware, response format)
8
+ - Service dependency injection strategy
9
+ - Data access patterns (ORM, Repository)
10
+ - DTO/type definition rules
11
+ - Error handling patterns
12
+ - Middleware chain order
13
13
 
14
- 2. 다수 공유 패턴 (50% 이상 도메인이 공유)
15
- - 어떤 도메인들이 공유하는지 명시
14
+ 2. Majority Patterns (shared by 50%+ of domains)
15
+ - Specify which domains share them
16
16
 
17
- 3. 도메인 특화 패턴 (해당 도메인만 가진 )
18
- - 파일 업로드: 어느 도메인
19
- - WebSocket: 어느 도메인
20
- - 큐/배치: 어느 도메인
21
- - 외부 API 연동: 어느 도메인
22
- - 캐싱: 어느 도메인
23
- - 이벤트/CQRS: 어느 도메인
24
- - 메시징: 어느 도메인
17
+ 3. Domain-Specific Patterns (unique to a single domain)
18
+ - File upload: which domain
19
+ - WebSocket: which domain
20
+ - Queue/batch: which domain
21
+ - External API integration: which domain
22
+ - Caching: which domain
23
+ - Event/CQRS: which domain
24
+ - Messaging: which domain
25
25
 
26
- 4. 안티패턴 종합
27
- - 모든 도메인에서 발견된 비일관성 통합
28
- - 심각도별 분류 (CRITICAL / HIGH / MEDIUM / LOW)
26
+ 4. Anti-pattern Summary
27
+ - Consolidate all inconsistencies found across domains
28
+ - Classify by severity (CRITICAL / HIGH / MEDIUM / LOW)
29
29
 
30
- 5. 명명 규칙 종합
31
- - 파일/디렉토리 네이밍 (kebab-case, camelCase, PascalCase)
32
- - DTO/타입 네이밍 규칙
33
- - 라우트 URL 패턴
34
- - 모듈/패키지 구조 규칙
30
+ 5. Naming Conventions Summary
31
+ - File/directory naming (kebab-case, camelCase, PascalCase)
32
+ - DTO/type naming conventions
33
+ - Route URL patterns
34
+ - Module/package structure conventions
35
35
 
36
- 6. 공통 타입/인터페이스 목록
37
- - 공유 타입 정의 파일
38
- - 유틸리티 타입
39
- - 환경변수 타입
40
- - 상수/Enum 관리
36
+ 6. Common Types/Interfaces List
37
+ - Shared type definition files
38
+ - Utility types
39
+ - Environment variable types
40
+ - Constants/Enum management
41
41
 
42
- 7. 보안/인증 패턴
43
- - JWT/세션 사용 방식
44
- - Guard/미들웨어 인증 전략
45
- - CORS 설정
42
+ 7. Security/Authentication Patterns
43
+ - JWT/session approach
44
+ - Guard/middleware authentication strategy
45
+ - CORS configuration
46
46
  - Rate Limiting
47
- - 환경별 보안 설정
47
+ - Per-environment security settings
48
48
 
49
- 8. DB 패턴
50
- - 테이블/컬렉션 네이밍 규칙
51
- - 마이그레이션 전략
52
- - 시드 데이터 관리
53
- - 감사 컬럼 (createdAt, updatedAt, deletedAt)
54
- - 인덱스/제약 조건
49
+ 8. Database Patterns
50
+ - Table/collection naming conventions
51
+ - Migration strategy
52
+ - Seed data management
53
+ - Audit columns (createdAt, updatedAt, deletedAt)
54
+ - Index/constraints
55
55
 
56
- 9. 테스트 전략 종합
57
- - 테스트 커버리지 수준
58
- - 테스트 분류 체계 (단위/통합/E2E)
59
- - 모킹 전략
60
- - 테스트 네이밍 규칙
61
- - DB 테스트 전략
56
+ 9. Testing Strategy Summary
57
+ - Test coverage level
58
+ - Test classification system (unit/integration/E2E)
59
+ - Mocking strategy
60
+ - Test naming conventions
61
+ - DB test strategy
62
62
 
63
- 10. 로깅/모니터링 전략
64
- - 로거 표준
65
- - 로그 레벨 정책
66
- - 구조화 로깅 방식
67
- - 요청/응답 로깅
63
+ 10. Logging/Monitoring Strategy
64
+ - Logger standard
65
+ - Log level policy
66
+ - Structured logging approach
67
+ - Request/response logging
68
68
 
69
- 11. 성능 패턴
70
- - 캐싱 전략
71
- - 쿼리 최적화 현황
72
- - 비동기 처리 현황
73
- - 커넥션 설정
69
+ 11. Performance Patterns
70
+ - Caching strategy
71
+ - Query optimization status
72
+ - Async processing status
73
+ - Connection pool configuration
74
74
 
75
- 12. 코드 품질 도구
76
- - Lint/Format 도구 (ESLint, Prettier, Biome)
77
- - Pre-commit (husky, lint-staged)
78
- - CI 연동 현황
75
+ 12. Code Quality Tools
76
+ - Lint/Format tools (ESLint, Prettier, Biome)
77
+ - Pre-commit hooks (husky, lint-staged)
78
+ - CI integration status
79
79
 
80
- 코드 생성은 하지 마. 통합만.
81
- 결과를 claudeos-core/generated/pass2-merged.json에 저장.
80
+ Do not generate code. Merge only.
81
+ Save results to claudeos-core/generated/pass2-merged.json.
@@ -1,58 +1,58 @@
1
- claudeos-core/generated/project-analysis.json
2
- claudeos-core/generated/pass2-merged.json 읽고,
3
- 분석 결과를 기반으로 ClaudeOS-Core 파일을 전부 생성해줘.
1
+ Read claudeos-core/generated/project-analysis.json and
2
+ claudeos-core/generated/pass2-merged.json, then
3
+ generate all ClaudeOS-Core files based on the analysis results.
4
4
 
5
- 원본 소스 코드를 다시 읽지 마. 분석 결과만 참조.
5
+ Do not read the original source code again. Reference only the analysis results.
6
6
 
7
- 생성 대상:
7
+ Generation targets:
8
8
 
9
- 1. CLAUDE.md (프로젝트 루트)
10
- - Role 정의 (분석된 스택 기반)
9
+ 1. CLAUDE.md (project root)
10
+ - Role definition (based on detected stack)
11
11
  - Build & Run Commands (npm/yarn/pnpm)
12
- - 핵심 아키텍처 다이어그램
13
- - DB 테이블/컬렉션 네이밍
14
- - Standard/Skills/Guide 참조 테이블
12
+ - Core architecture diagram
13
+ - DB table/collection naming
14
+ - Standard/Skills/Guide reference table
15
15
 
16
- 2. claudeos-core/standard/ (활성 도메인만)
17
- - 00.core/01.project-overview.md — 스택, 모듈, API 서버 정보
18
- - 00.core/02.architecture.md — 레이어 구조, 요청 흐름, 디렉토리 구조
19
- - 00.core/03.naming-conventions.md — 파일/변수/타입 명명규칙
20
- - 10.backend-api/01.router-controller-patterns.md — 라우팅 패턴 + 미들웨어
21
- - 10.backend-api/02.service-patterns.md — DI, 트랜잭션, 비즈니스 로직
22
- - 10.backend-api/03.data-access-patterns.md — ORM 패턴, 쿼리 최적화
23
- - 10.backend-api/04.response-exception.md — 응답/에러 핸들링 패턴
24
- - 10.backend-api/05.validation-dto.md — 유효성 검증, DTO 패턴
25
- - 10.backend-api/06.middleware-interceptor.md — 미들웨어, Guard, Interceptor
16
+ 2. claudeos-core/standard/ (active domains only)
17
+ - 00.core/01.project-overview.md — Stack, modules, API server info
18
+ - 00.core/02.architecture.md — Layer structure, request flow, directory structure
19
+ - 00.core/03.naming-conventions.md — File/variable/type naming conventions
20
+ - 10.backend-api/01.router-controller-patterns.md — Routing patterns + middleware
21
+ - 10.backend-api/02.service-patterns.md — DI, transactions, business logic
22
+ - 10.backend-api/03.data-access-patterns.md — ORM patterns, query optimization
23
+ - 10.backend-api/04.response-exception.md — Response/error handling patterns
24
+ - 10.backend-api/05.validation-dto.md — Validation, DTO patterns
25
+ - 10.backend-api/06.middleware-interceptor.md — Middleware, Guard, Interceptor
26
26
  - 30.security-db/01.security-auth.md — JWT, Guard, CORS, Rate Limit
27
- - 30.security-db/02.database-schema.md — 마이그레이션, 시드, 스키마 규칙
28
- - 30.security-db/03.common-utilities.md — 공통 유틸, 헬퍼, 상수
29
- - 40.infra/01.environment-config.md — 환경변수, 설정 관리
30
- - 40.infra/02.logging-monitoring.md — 로깅 표준, 모니터링, 알림
31
- - 40.infra/03.cicd-deployment.md — CI/CD 파이프라인, 배포 전략
32
- - 50.verification/01.development-verification.md — 빌드, 기동, API 테스트
33
- - 50.verification/02.testing-strategy.md — 테스트 전략, 모킹, 커버리지
27
+ - 30.security-db/02.database-schema.md — Migrations, seeds, schema conventions
28
+ - 30.security-db/03.common-utilities.md — Common utils, helpers, constants
29
+ - 40.infra/01.environment-config.md — Environment variables, config management
30
+ - 40.infra/02.logging-monitoring.md — Logging standards, monitoring, alerts
31
+ - 40.infra/03.cicd-deployment.md — CI/CD pipeline, deployment strategy
32
+ - 50.verification/01.development-verification.md — Build, startup, API testing
33
+ - 50.verification/02.testing-strategy.md — Testing strategy, mocking, coverage
34
34
 
35
- 파일에는 반드시 포함:
36
- - 올바른 예시 (✅ 코드 블록)
37
- - 잘못된 예시 (❌ 코드 블록)
38
- - 핵심 규칙 요약 테이블
35
+ Each file MUST include:
36
+ - Correct examples (✅ code blocks)
37
+ - Incorrect examples (❌ code blocks)
38
+ - Key rules summary table
39
39
 
40
- 3. .claude/rules/ (활성 도메인만)
41
- - 규칙 파일에 paths: frontmatter 포함
42
- - 핵심 규칙 5~10 직접 기술
43
- - @import로 상세 standard 참조 (경로: @../../claudeos-core/standard/...)
40
+ 3. .claude/rules/ (active domains only)
41
+ - Each rule file must include paths: frontmatter
42
+ - Write 5-10 lines of key rules directly
43
+ - Reference detailed standards via @import (path: @../../claudeos-core/standard/...)
44
44
 
45
- 4. .claude/rules/50.sync/ (동기화 규칙 3개)
46
- - 01.standard-sync.md — standard 수정 시 plan/10 자동 갱신
47
- - 02.rules-sync.md — rules 수정 시 plan/20 자동 갱신
48
- - 03.skills-sync.md — skills 수정 시 plan/30 자동 갱신
45
+ 4. .claude/rules/50.sync/ (3 sync rules)
46
+ - 01.standard-sync.md — Auto-update plan/10 when standard is modified
47
+ - 02.rules-sync.md — Auto-update plan/20 when rules is modified
48
+ - 03.skills-sync.md — Auto-update plan/30 when skills is modified
49
49
 
50
- 5. claudeos-core/skills/ (활성 도메인만)
51
- - 10.backend-crud/01.scaffold-crud-feature.md (오케스트레이터)
52
- - 10.backend-crud/scaffold-crud-feature/01~08 (하위 스킬: router, controller, service, repository, dto, migration, test, index)
53
- - 00.shared/MANIFEST.md (스킬 레지스트리)
50
+ 5. claudeos-core/skills/ (active domains only)
51
+ - 10.backend-crud/01.scaffold-crud-feature.md (orchestrator)
52
+ - 10.backend-crud/scaffold-crud-feature/01~08 (sub-skills: router, controller, service, repository, dto, migration, test, index)
53
+ - 00.shared/MANIFEST.md (skill registry)
54
54
 
55
- 6. claudeos-core/guide/ (전체)
55
+ 6. claudeos-core/guide/ (all)
56
56
  - 01.onboarding/01.overview.md
57
57
  - 01.onboarding/02.quickstart.md
58
58
  - 01.onboarding/03.glossary.md
@@ -63,16 +63,16 @@ claudeos-core/generated/pass2-merged.json을 읽고,
63
63
  - 04.architecture/01.file-map.md
64
64
  - 04.architecture/02.pros-and-cons.md
65
65
 
66
- 7. claudeos-core/plan/ (마스터 플랜)
67
- - 10.standard-master.md — CLAUDE.md + standard/ 전체 <file> 블록
68
- - 20.rules-master.md — rules/ (sync 제외) 전체 <file> 블록
69
- - 21.sync-rules-master.md — sync 규칙 전체 (코드블록 방식)
70
- - 30.backend-skills-master.md — backend skills 전체 <file> 블록
71
- - 40.guides-master.md — guide/ 전체 <file> 블록
66
+ 7. claudeos-core/plan/ (Master Plan)
67
+ - 10.standard-master.md — CLAUDE.md + all standard/ files as <file> blocks
68
+ - 20.rules-master.md — All rules/ (except sync) as <file> blocks
69
+ - 21.sync-rules-master.md — All sync rules (code block format)
70
+ - 30.backend-skills-master.md — All backend skills as <file> blocks
71
+ - 40.guides-master.md — All guide/ files as <file> blocks
72
72
 
73
73
  8. claudeos-core/database/
74
- - 01.schema-overview.md — 테이블/컬렉션 목록, 관계 설명
75
- - 02.migration-guide.md — 마이그레이션 절차, 롤백 방법
74
+ - 01.schema-overview.md — Table/collection list, relationship description
75
+ - 02.migration-guide.md — Migration procedure, rollback methods
76
76
 
77
77
  9. claudeos-core/mcp-guide/
78
- - 01.mcp-overview.md — 사용 중인 MCP 서버 목록, 연동 방법
78
+ - 01.mcp-overview.md — List of MCP servers in use, integration methods