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
@@ -1,84 +1,84 @@
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
- - View 스타일 (FBV/CBV/ViewSet, URL 패턴, 응답 형식)
8
- - Serializer 규칙
9
- - Model 구조 (AbstractModel, 필드 규칙)
10
- - 에러 핸들링 패턴
11
- - 트랜잭션 전략
6
+ 1. Universal Patterns (shared by 100% of all domains)
7
+ - View style (FBV/CBV/ViewSet, URL patterns, response format)
8
+ - Serializer conventions
9
+ - Model structure (AbstractModel, field rules)
10
+ - Error handling patterns
11
+ - Transaction strategy
12
12
 
13
- 2. 다수 공유 패턴 (50% 이상 도메인이 공유)
14
- - 어떤 도메인들이 공유하는지 명시
13
+ 2. Majority Patterns (shared by 50%+ of domains)
14
+ - Specify which domains share them
15
15
 
16
- 3. 도메인 특화 패턴 (해당 도메인만 가진 )
17
- - 파일 업로드: 어느 도메인
18
- - Celery 태스크: 어느 도메인
19
- - WebSocket: 어느 도메인
20
- - 외부 API: 어느 도메인
21
- - 캐싱: 어느 도메인
22
- - Admin 커스터마이징: 어느 도메인
23
- - Management Command: 어느 도메인
24
- - 메시징: 어느 도메인
16
+ 3. Domain-Specific Patterns (unique to a single domain)
17
+ - File upload: which domain
18
+ - Celery tasks: which domain
19
+ - WebSocket: which domain
20
+ - External API: which domain
21
+ - Caching: which domain
22
+ - Admin customization: which domain
23
+ - Management Command: 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
- - 앱/모듈 네이밍 (snake_case)
32
- - Model/Serializer/View 네이밍
33
- - URL 패턴 규칙
34
- - 테스트 파일 구조
30
+ 5. Naming Conventions Summary
31
+ - App/module naming (snake_case)
32
+ - Model/Serializer/View naming
33
+ - URL pattern conventions
34
+ - Test file structure
35
35
 
36
- 6. 공통 모델/유틸리티 목록
37
- - Abstract 모델 필드
38
- - 공유 Manager/QuerySet
39
- - 유틸리티 함수
40
- - 상수/Enum 관리
36
+ 6. Common Models/Utilities List
37
+ - Abstract model fields
38
+ - Shared Manager/QuerySet
39
+ - Utility functions
40
+ - Constants/Enum management
41
41
 
42
- 7. 보안/인증 패턴
43
- - 인증 방식 (JWT, Session, Token, OAuth2)
44
- - Permission 클래스 전략
45
- - CORS 설정
46
- - 환경변수 관리
47
- - CSRF 정책
42
+ 7. Security/Authentication Patterns
43
+ - Authentication method (JWT, Session, Token, OAuth2)
44
+ - Permission class strategy
45
+ - CORS configuration
46
+ - Environment variable management
47
+ - CSRF policy
48
48
 
49
- 8. DB 패턴
50
- - 테이블 네이밍 (db_table, verbose_name)
51
- - 마이그레이션 전략 (squash, revert)
52
- - Fixture/시드 관리
53
- - 감사 필드 (created_at, updated_at)
54
- - 인덱스/제약 조건
55
- - 소프트 삭제 패턴
49
+ 8. Database Patterns
50
+ - Table naming (db_table, verbose_name)
51
+ - Migration strategy (squash, revert)
52
+ - Fixture/seed management
53
+ - Audit fields (created_at, updated_at)
54
+ - Index/constraints
55
+ - Soft delete patterns
56
56
 
57
- 9. 테스트 전략 종합
58
- - 테스트 커버리지 수준
59
- - 테스트 분류 체계 (단위/통합/E2E)
60
- - Factory/Fixture 전략
61
- - 모킹 전략
62
- - DB 테스트 전략
63
- - 테스트 네이밍 규칙
57
+ 9. Testing Strategy Summary
58
+ - Test coverage level
59
+ - Test classification system (unit/integration/E2E)
60
+ - Factory/Fixture strategy
61
+ - Mocking strategy
62
+ - DB test strategy
63
+ - Test naming conventions
64
64
 
65
- 10. 로깅/모니터링 전략
66
- - 로거 표준
67
- - 로그 레벨 정책
68
- - 구조화 로깅
69
- - 요청/응답 로깅
65
+ 10. Logging/Monitoring Strategy
66
+ - Logger standard
67
+ - Log level policy
68
+ - Structured logging
69
+ - Request/response logging
70
70
 
71
- 11. 성능 패턴
72
- - 캐싱 전략
73
- - 쿼리 최적화 현황 (select_related, prefetch_related)
74
- - 비동기 처리 현황
75
- - DB 커넥션 관리
71
+ 11. Performance Patterns
72
+ - Caching strategy
73
+ - Query optimization status (select_related, prefetch_related)
74
+ - Async processing status
75
+ - DB connection management
76
76
 
77
- 12. 코드 품질 도구
78
- - Lint/Format 도구 (ruff, black, isort, flake8, mypy)
79
- - Pre-commit
77
+ 12. Code Quality Tools
78
+ - Lint/Format tools (ruff, black, isort, flake8, mypy)
79
+ - Pre-commit hooks
80
80
  - Type Checking (mypy, pyright)
81
- - CI 연동 현황
81
+ - CI integration status
82
82
 
83
- 코드 생성은 하지 마. 통합만.
84
- 결과를 claudeos-core/generated/pass2-merged.json에 저장.
83
+ Do not generate code. Merge only.
84
+ 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 (pip/poetry, manage.py, gunicorn/uwsgi)
12
- - 핵심 아키텍처 다이어그램
13
- - Django 구조
14
- - Standard/Skills/Guide 참조 테이블
12
+ - Core architecture diagram
13
+ - Django app structure
14
+ - Standard/Skills/Guide reference table
15
15
 
16
- 2. claudeos-core/standard/ (활성 도메인만)
17
- - 00.core/01.project-overview.md — 스택, 목록, 서버 정보
18
- - 00.core/02.architecture.md — MTV 구조, 요청 흐름, 구조
19
- - 00.core/03.naming-conventions.md — 앱/모델/뷰/시리얼라이저 명명규칙
20
- - 10.backend-api/01.view-patterns.md — FBV/CBV/ViewSet 패턴 + 예시
21
- - 10.backend-api/02.serializer-patterns.md — Serializer 작성 규칙 + 검증
22
- - 10.backend-api/03.model-patterns.md — Model 구조, Manager, Signal, QuerySet
23
- - 10.backend-api/04.response-exception.md — 응답/에러 핸들링 패턴
24
- - 10.backend-api/05.business-logic.md — Service Layer, 트랜잭션, Celery
25
- - 10.backend-api/06.admin-patterns.md — Admin 커스터마이징, Inline, 액션
16
+ 2. claudeos-core/standard/ (active domains only)
17
+ - 00.core/01.project-overview.md — Stack, app list, server info
18
+ - 00.core/02.architecture.md — MTV structure, request flow, app structure
19
+ - 00.core/03.naming-conventions.md — App/model/view/serializer naming conventions
20
+ - 10.backend-api/01.view-patterns.md — FBV/CBV/ViewSet patterns + examples
21
+ - 10.backend-api/02.serializer-patterns.md — Serializer writing rules + validation
22
+ - 10.backend-api/03.model-patterns.md — Model structure, Manager, Signal, QuerySet
23
+ - 10.backend-api/04.response-exception.md — Response/error handling patterns
24
+ - 10.backend-api/05.business-logic.md — Service Layer, transactions, Celery
25
+ - 10.backend-api/06.admin-patterns.md — Admin customization, Inline, actions
26
26
  - 30.security-db/01.security-auth.md — JWT, Permission, CORS, CSRF
27
- - 30.security-db/02.database-schema.md — 마이그레이션, Fixture, 스키마 규칙
28
- - 30.security-db/03.common-utilities.md — 공통 유틸, 커스텀 Manager, 상수
29
- - 40.infra/01.environment-config.md — settings 분리, 환경변수
30
- - 40.infra/02.logging-monitoring.md — 로깅 표준, 모니터링
31
- - 40.infra/03.cicd-deployment.md — CI/CD, Docker, 배포 전략
32
- - 50.verification/01.development-verification.md — 테스트, 기동, API 테스트
33
- - 50.verification/02.testing-strategy.md — pytest, Factory, 모킹, 커버리지
27
+ - 30.security-db/02.database-schema.md — Migrations, fixtures, schema conventions
28
+ - 30.security-db/03.common-utilities.md — Common utils, custom Manager, constants
29
+ - 40.infra/01.environment-config.md — Settings separation, environment variables
30
+ - 40.infra/02.logging-monitoring.md — Logging standards, monitoring
31
+ - 40.infra/03.cicd-deployment.md — CI/CD, Docker, deployment strategy
32
+ - 50.verification/01.development-verification.md — Testing, startup, API testing
33
+ - 50.verification/02.testing-strategy.md — pytest, Factory, 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 참조
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
44
44
 
45
- 4. .claude/rules/50.sync/ (동기화 규칙 3개)
45
+ 4. .claude/rules/50.sync/ (3 sync rules)
46
46
  - 01.standard-sync.md
47
47
  - 02.rules-sync.md
48
48
  - 03.skills-sync.md
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 (하위 스킬: model, serializer, view, url, admin, 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: model, serializer, view, url, admin, 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,7 +63,7 @@ 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/ (마스터 플랜)
66
+ 7. claudeos-core/plan/ (Master Plan)
67
67
  - 10.standard-master.md
68
68
  - 20.rules-master.md
69
69
  - 21.sync-rules-master.md
@@ -71,8 +71,8 @@ claudeos-core/generated/pass2-merged.json을 읽고,
71
71
  - 40.guides-master.md
72
72
 
73
73
  8. claudeos-core/database/
74
- - 01.schema-overview.md — 테이블 목록, 관계 설명
75
- - 02.migration-guide.md — 마이그레이션 절차, squash, 롤백
74
+ - 01.schema-overview.md — Table list, relationship description
75
+ - 02.migration-guide.md — Migration procedure, squash, rollback
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
@@ -1,97 +1,97 @@
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/Endpoint 패턴
10
- - 라우터 구조 (APIRouter, include_router, prefix, tags)
11
- - 경로 데코레이터 (@router.get, @router.post, @router.put, @router.delete)
12
- - 파라미터 처리 (Path, Query, Body, Header, Cookie, Depends)
13
- - 응답 모델 (response_model, status_code, response_class)
14
- - 에러 핸들링 (HTTPException, exception_handler, 커스텀 예외)
15
- - 인증 (Depends 기반 JWT/OAuth2, Security schemes)
16
- - API 문서화 (자동 OpenAPI, tags, summary, description, deprecated)
17
- - 페이지네이션 (offset/limit, cursor, 커스텀)
18
- - API 버저닝 (prefix, router 분리)
9
+ 1. Router/Endpoint Patterns
10
+ - Router structure (APIRouter, include_router, prefix, tags)
11
+ - Path decorators (@router.get, @router.post, @router.put, @router.delete)
12
+ - Parameter handling (Path, Query, Body, Header, Cookie, Depends)
13
+ - Response model (response_model, status_code, response_class)
14
+ - Error handling (HTTPException, exception_handler, custom exceptions)
15
+ - Authentication (Depends-based JWT/OAuth2, Security schemes)
16
+ - API documentation (auto OpenAPI, tags, summary, description, deprecated)
17
+ - Pagination (offset/limit, cursor, custom)
18
+ - API versioning (prefix, router separation)
19
19
 
20
- 2. Schema/Pydantic 패턴
21
- - Pydantic 모델 구조 (BaseModel, 상속, Generic)
22
- - 유효성 검증 (@field_validator, @model_validator, BeforeValidator)
23
- - Request/Response 스키마 분리
20
+ 2. Schema/Pydantic Patterns
21
+ - Pydantic model structure (BaseModel, inheritance, Generic)
22
+ - Validation (@field_validator, @model_validator, BeforeValidator)
23
+ - Request/Response schema separation
24
24
  - Config (model_config, from_attributes, json_schema_extra)
25
- - Optional/Union 필드 처리
26
- - Enum/Literal 활용
27
- - 중첩 모델
25
+ - Optional/Union field handling
26
+ - Enum/Literal usage
27
+ - Nested models
28
28
 
29
- 3. 데이터 접근 패턴
29
+ 3. Data Access Patterns
30
30
  - ORM (SQLAlchemy 2.0, Tortoise ORM, SQLModel, Beanie/Motor)
31
- - 세션 관리 (get_db, AsyncSession, contextmanager)
32
- - Repository/CRUD 패턴 (Generic Repository, 추상화 수준)
33
- - 마이그레이션 (Alembic, autogenerate, 수동)
34
- - 쿼리 최적화 (eager loading, selectinload, joinedload)
35
- - 커넥션 관리 (풀, 재시도, 비동기)
36
- - 동적 쿼리/필터링
31
+ - Session management (get_db, AsyncSession, contextmanager)
32
+ - Repository/CRUD pattern (Generic Repository, abstraction level)
33
+ - Migration (Alembic, autogenerate, manual)
34
+ - Query optimization (eager loading, selectinload, joinedload)
35
+ - Connection management (pool, retry, async)
36
+ - Dynamic query/filtering
37
37
 
38
- 4. 의존성 주입 패턴
39
- - Depends 체인 (인증, DB 세션, 권한, 설정)
40
- - 의존성 계층 구조 (중첩 Depends)
41
- - 커스텀 의존성 함수/클래스
42
- - 라이프사이클 이벤트 (lifespan, startup/shutdown)
43
- - 의존성 오버라이드 (테스트용)
38
+ 4. Dependency Injection Patterns
39
+ - Depends chain (auth, DB session, permissions, config)
40
+ - Dependency hierarchy (nested Depends)
41
+ - Custom dependency functions/classes
42
+ - Lifecycle events (lifespan, startup/shutdown)
43
+ - Dependency overrides (for testing)
44
44
 
45
- 5. 설정/환경 패턴
46
- - 환경변수 관리 (pydantic-settings, python-dotenv)
47
- - Settings 클래스 구조 (@lru_cache, 싱글턴)
48
- - 환경별 분기 (development/staging/production)
49
- - 설정 검증
45
+ 5. Configuration/Environment Patterns
46
+ - Environment variable management (pydantic-settings, python-dotenv)
47
+ - Settings class structure (@lru_cache, singleton)
48
+ - Per-environment branching (development/staging/production)
49
+ - Configuration validation
50
50
 
51
- 6. 로깅 패턴
52
- - 로거 사용 (structlog, loguru, logging)
53
- - 로그 레벨 정책
54
- - 구조화 로깅 (JSON 포맷, correlation ID)
55
- - 요청/응답 로깅 (middleware)
56
- - 비동기 로깅
51
+ 6. Logging Patterns
52
+ - Logger usage (structlog, loguru, logging)
53
+ - Log level policy
54
+ - Structured logging (JSON format, correlation ID)
55
+ - Request/response logging (middleware)
56
+ - Async logging
57
57
 
58
- 7. 테스트 패턴
59
- - 테스트 프레임워크 (pytest, pytest-asyncio, httpx)
60
- - 테스트 분류 (단위/통합/E2E)
61
- - 테스트 클라이언트 (TestClient, AsyncClient)
62
- - 의존성 오버라이드 전략
63
- - Fixture 관리 (conftest, factory)
64
- - DB 테스트 전략 (test DB, SQLite in-memory, 트랜잭션 롤백)
65
- - 모킹 (unittest.mock, pytest-mock, responses, respx)
58
+ 7. Testing Patterns
59
+ - Test framework (pytest, pytest-asyncio, httpx)
60
+ - Test classification (unit/integration/E2E)
61
+ - Test client (TestClient, AsyncClient)
62
+ - Dependency override strategy
63
+ - Fixture management (conftest, factory)
64
+ - DB test strategy (test DB, SQLite in-memory, transaction rollback)
65
+ - Mocking (unittest.mock, pytest-mock, responses, respx)
66
66
 
67
- 8. 미들웨어 패턴
67
+ 8. Middleware Patterns
68
68
  - CORS Middleware
69
- - 커스텀 미들웨어 (로깅, 인증, 성능 측정)
70
- - Middleware 등록 순서
71
- - Starlette Middleware 활용
69
+ - Custom middleware (logging, auth, performance measurement)
70
+ - Middleware registration order
71
+ - Starlette Middleware usage
72
72
 
73
- 9. 도메인만의 특화 패턴
74
- - 파일 업로드 (UploadFile, S3, presigned URL)
73
+ 9. Domain-Specific Patterns
74
+ - File upload (UploadFile, S3, presigned URL)
75
75
  - WebSocket (websocket endpoint)
76
- - 백그라운드 태스크 (BackgroundTasks, Celery, ARQ, Dramatiq)
77
- - 외부 API 연동 (httpx, aiohttp)
78
- - 캐싱 (Redis, fastapi-cache, aiocache)
79
- - 이벤트 기반 (async/await, pub/sub)
80
- - 메시징 (Kafka, RabbitMQ, aio-pika)
81
- - 국제화
76
+ - Background tasks (BackgroundTasks, Celery, ARQ, Dramatiq)
77
+ - External API integration (httpx, aiohttp)
78
+ - Caching (Redis, fastapi-cache, aiocache)
79
+ - Event-driven (async/await, pub/sub)
80
+ - Messaging (Kafka, RabbitMQ, aio-pika)
81
+ - Internationalization
82
82
  - Rate Limiting (slowapi)
83
83
  - GraphQL (Strawberry)
84
84
 
85
- 10. 안티패턴 / 비일관성
86
- - 동기/비동기 혼용
87
- - 타입 힌트 누락
88
- - Depends 남용 또는 미사용
89
- - 레거시로 보이는 패턴
90
- - 보안 문제 (인젝션, 권한 누락)
91
- - 성능 문제 (블로킹 I/O, N+1)
85
+ 10. Anti-patterns / Inconsistencies
86
+ - Sync/async mixing
87
+ - Missing type hints
88
+ - Depends overuse or non-use
89
+ - Legacy-looking patterns
90
+ - Security issues (injection, missing authorization)
91
+ - Performance issues (blocking I/O, N+1)
92
92
 
93
- 파일 생성은 하지 마. 분석만.
94
- 결과를 claudeos-core/generated/pass1-{{PASS_NUM}}.json 아래 형식으로 저장:
93
+ Do not create files. Analysis only.
94
+ Save results to claudeos-core/generated/pass1-{{PASS_NUM}}.json in the following format:
95
95
 
96
96
  {
97
97
  "analyzedAt": "ISO timestamp",
@@ -121,7 +121,7 @@ claudeos-core/generated/project-analysis.json을 읽고,
121
121
  }
122
122
  },
123
123
  "crossDomainCommon": {
124
- "description": " 그룹의 도메인들이 공통으로 사용하는 패턴",
124
+ "description": "Patterns commonly used across domains in this group",
125
125
  "patterns": []
126
126
  }
127
127
  }
@@ -1,83 +1,83 @@
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/Endpoint 스타일 (데코레이터, 응답 모델, 상태 코드)
8
- - Schema/Pydantic 규칙 (BaseModel, 검증)
9
- - 데이터 접근 패턴 (ORM, 세션 관리)
10
- - 의존성 주입 체인 (Depends)
11
- - 에러 핸들링 패턴
12
- - 미들웨어 체인
6
+ 1. Universal Patterns (shared by 100% of all domains)
7
+ - Router/Endpoint style (decorators, response models, status codes)
8
+ - Schema/Pydantic conventions (BaseModel, validation)
9
+ - Data access patterns (ORM, session management)
10
+ - Dependency injection chain (Depends)
11
+ - Error handling patterns
12
+ - Middleware chain
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
- - 메시징: 어느 도메인
17
+ 3. Domain-Specific Patterns (unique to a single domain)
18
+ - File upload: which domain
19
+ - WebSocket: which domain
20
+ - Background tasks: which domain
21
+ - External API: which domain
22
+ - Caching: which domain
23
+ - Messaging: which domain
24
24
 
25
- 4. 안티패턴 종합
26
- - 모든 도메인에서 발견된 비일관성 통합
27
- - 심각도별 분류 (CRITICAL / HIGH / MEDIUM / LOW)
25
+ 4. Anti-pattern Summary
26
+ - Consolidate all inconsistencies found across domains
27
+ - Classify by severity (CRITICAL / HIGH / MEDIUM / LOW)
28
28
 
29
- 5. 명명 규칙 종합
30
- - 모듈/패키지 네이밍 (snake_case)
31
- - Schema/Model 네이밍 규칙
32
- - 라우터 URL 패턴
33
- - 파일 구조 규칙
29
+ 5. Naming Conventions Summary
30
+ - Module/package naming (snake_case)
31
+ - Schema/Model naming conventions
32
+ - Router URL patterns
33
+ - File structure conventions
34
34
 
35
- 6. 공통 모델/유틸리티 목록
36
- - Base 모델 필드
37
- - 공유 의존성 함수
38
- - 유틸리티 함수
39
- - 상수/Enum 관리
35
+ 6. Common Models/Utilities List
36
+ - Base model fields
37
+ - Shared dependency functions
38
+ - Utility functions
39
+ - Constants/Enum management
40
40
 
41
- 7. 보안/인증 패턴
42
- - 인증 방식 (JWT Bearer, OAuth2PasswordBearer)
43
- - 의존성 기반 권한 체크
44
- - CORS 설정
41
+ 7. Security/Authentication Patterns
42
+ - Authentication method (JWT Bearer, OAuth2PasswordBearer)
43
+ - Depends-based authorization check
44
+ - CORS configuration
45
45
  - Rate Limiting
46
- - 환경변수 관리
46
+ - Environment variable management
47
47
 
48
- 8. DB 패턴
49
- - 테이블 네이밍 (__tablename__)
50
- - Alembic 마이그레이션 전략
51
- - 시드 데이터 관리
52
- - 감사 필드 (created_at, updated_at)
53
- - 비동기 DB 접근 패턴
54
- - 인덱스/제약 조건
48
+ 8. Database Patterns
49
+ - Table naming (__tablename__)
50
+ - Alembic migration strategy
51
+ - Seed data management
52
+ - Audit fields (created_at, updated_at)
53
+ - Async DB access patterns
54
+ - Index/constraints
55
55
 
56
- 9. 테스트 전략 종합
57
- - 테스트 커버리지 수준
58
- - 테스트 분류 체계 (단위/통합/E2E)
59
- - 의존성 오버라이드 전략
60
- - 비동기 테스트 방식
61
- - Fixture/Factory 전략
62
- - 모킹 전략
56
+ 9. Testing Strategy Summary
57
+ - Test coverage level
58
+ - Test classification system (unit/integration/E2E)
59
+ - Dependency override strategy
60
+ - Async testing approach
61
+ - Fixture/Factory strategy
62
+ - Mocking strategy
63
63
 
64
- 10. 로깅/모니터링 전략
65
- - 로거 표준
66
- - 로그 레벨 정책
67
- - 구조화 로깅 방식
68
- - 요청/응답 로깅
64
+ 10. Logging/Monitoring Strategy
65
+ - Logger standard
66
+ - Log level policy
67
+ - Structured logging approach
68
+ - Request/response logging
69
69
 
70
- 11. 성능 패턴
71
- - 캐싱 전략
72
- - 비동기 처리 현황
73
- - 커넥션 설정
74
- - 쿼리 최적화
70
+ 11. Performance Patterns
71
+ - Caching strategy
72
+ - Async processing status
73
+ - Connection pool configuration
74
+ - Query optimization
75
75
 
76
- 12. 코드 품질 도구
77
- - Lint/Format 도구 (ruff, black, isort, mypy)
78
- - Pre-commit
76
+ 12. Code Quality Tools
77
+ - Lint/Format tools (ruff, black, isort, mypy)
78
+ - Pre-commit hooks
79
79
  - Type Checking (mypy, pyright)
80
- - CI 연동 현황
80
+ - CI integration status
81
81
 
82
- 코드 생성은 하지 마. 통합만.
83
- 결과를 claudeos-core/generated/pass2-merged.json에 저장.
82
+ Do not generate code. Merge only.
83
+ Save results to claudeos-core/generated/pass2-merged.json.