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,86 +1,86 @@
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. 페이지/라우팅 패턴
10
- - 라우팅 방식 (App Router vs Pages Router)
11
- - 레이아웃 구조 (layout.tsx, template.tsx)
12
- - 동적 라우트 ([slug], [...catchAll], [[...optional]])
13
- - Server Components vs Client Components 구분
14
- - 메타데이터 관리 (generateMetadata, head.tsx)
15
- - 로딩/에러 UI (loading.tsx, error.tsx, not-found.tsx)
16
- - middleware.ts 사용 (인증, 리다이렉트, i18n)
9
+ 1. Page/Routing Patterns
10
+ - Routing approach (App Router vs Pages Router)
11
+ - Layout structure (layout.tsx, template.tsx)
12
+ - Dynamic routes ([slug], [...catchAll], [[...optional]])
13
+ - Server Components vs Client Components separation
14
+ - Metadata management (generateMetadata, head.tsx)
15
+ - Loading/error UI (loading.tsx, error.tsx, not-found.tsx)
16
+ - middleware.ts usage (auth, redirects, i18n)
17
17
 
18
- 2. 컴포넌트 패턴
19
- - 컴포넌트 구조 (함수형, forwardRef, memo)
20
- - Props 타입 정의 방식 (interface vs type, Generic 활용)
21
- - 상태 관리 (useState, useReducer, 외부 라이브러리)
22
- - 스타일링 (CSS Modules, Tailwind, styled-components, Emotion)
23
- - UI 라이브러리 (shadcn/ui, MUI, Ant Design, Radix)
24
- - 컴포넌트 분류 (UI, Feature, Layout, Page)
25
- - 재사용 패턴 (composition, compound components, render props)
26
- - 접근성 (ARIA, semantic HTML, keyboard navigation)
18
+ 2. Component Patterns
19
+ - Component structure (functional, forwardRef, memo)
20
+ - Props type definition (interface vs type, Generic usage)
21
+ - State management (useState, useReducer, external libraries)
22
+ - Styling (CSS Modules, Tailwind, styled-components, Emotion)
23
+ - UI library (shadcn/ui, MUI, Ant Design, Radix)
24
+ - Component classification (UI, Feature, Layout, Page)
25
+ - Reuse patterns (composition, compound components, render props)
26
+ - Accessibility (ARIA, semantic HTML, keyboard navigation)
27
27
 
28
- 3. 데이터 페칭 패턴
28
+ 3. Data Fetching Patterns
29
29
  - Server-side (fetch in RSC, getServerSideProps, getStaticProps)
30
30
  - Client-side (SWR, React Query/TanStack Query, useEffect)
31
31
  - API Routes / Route Handlers (app/api/)
32
32
  - Server Actions (use server)
33
- - 캐싱 전략 (revalidate, cache tags, ISR)
34
- - 에러/로딩 상태 처리
35
- - 스트리밍 (Suspense, streaming SSR)
33
+ - Caching strategy (revalidate, cache tags, ISR)
34
+ - Error/loading state handling
35
+ - Streaming (Suspense, streaming SSR)
36
36
 
37
- 4. 상태 관리 패턴
38
- - 전역 상태 (Zustand, Redux Toolkit, Jotai, Recoil, Context)
39
- - 서버 상태 (TanStack Query, SWR)
40
- - URL 상태 (searchParams, useRouter, nuqs)
41
- - 상태 (React Hook Form, Formik, useActionState)
42
- - 낙관적 업데이트 (useOptimistic)
37
+ 4. State Management Patterns
38
+ - Global state (Zustand, Redux Toolkit, Jotai, Recoil, Context)
39
+ - Server state (TanStack Query, SWR)
40
+ - URL state (searchParams, useRouter, nuqs)
41
+ - Form state (React Hook Form, Formik, useActionState)
42
+ - Optimistic updates (useOptimistic)
43
43
 
44
- 5. 설정/환경 패턴
45
- - 환경변수 관리 (NEXT_PUBLIC_ 규칙, .env 분리)
46
- - next.config 설정 (이미지 도메인, 리다이렉트, 헤더)
47
- - 빌드 최적화 (번들 분석, tree shaking)
44
+ 5. Configuration/Environment Patterns
45
+ - Environment variable management (NEXT_PUBLIC_ convention, .env separation)
46
+ - next.config settings (image domains, redirects, headers)
47
+ - Build optimization (bundle analysis, tree shaking)
48
48
 
49
- 6. 로깅/모니터링 패턴
50
- - 클라이언트 에러 추적 (Sentry, DataDog RUM)
51
- - 서버 로깅 (pino, winston)
52
- - 성능 모니터링 (Web Vitals, Lighthouse)
53
- - 분석 도구 (Google Analytics, PostHog, Mixpanel)
49
+ 6. Logging/Monitoring Patterns
50
+ - Client error tracking (Sentry, DataDog RUM)
51
+ - Server logging (pino, winston)
52
+ - Performance monitoring (Web Vitals, Lighthouse)
53
+ - Analytics tools (Google Analytics, PostHog, Mixpanel)
54
54
 
55
- 7. 테스트 패턴
56
- - 테스트 프레임워크 (Jest, Vitest, Playwright, Cypress)
57
- - 컴포넌트 테스트 (React Testing Library, Storybook)
58
- - E2E 테스트 전략
59
- - 모킹 전략 (MSW, jest.mock)
60
- - 테스트 네이밍 규칙
61
- - 스냅샷 테스트 사용 여부
55
+ 7. Testing Patterns
56
+ - Test framework (Jest, Vitest, Playwright, Cypress)
57
+ - Component testing (React Testing Library, Storybook)
58
+ - E2E testing strategy
59
+ - Mocking strategy (MSW, jest.mock)
60
+ - Test naming conventions
61
+ - Snapshot testing usage
62
62
 
63
- 8. 도메인만의 특화 패턴
64
- - 인증/인가 (NextAuth/Auth.js, 미들웨어 보호, 세션 관리)
65
- - 국제화 (next-intl, i18next, 라우트 기반)
66
- - 파일 업로드 (presigned URL, 클라이언트 직접 업로드)
67
- - 실시간 기능 (WebSocket, SSE, Pusher)
68
- - SEO 최적화 (메타태그, 구조화 데이터, sitemap)
69
- - 이미지/폰트 최적화 (next/image, next/font)
70
- - API 버저닝 전략
71
- - PWA 지원
63
+ 8. Domain-Specific Patterns
64
+ - Authentication/authorization (NextAuth/Auth.js, middleware protection, session management)
65
+ - Internationalization (next-intl, i18next, route-based)
66
+ - File upload (presigned URL, client direct upload)
67
+ - Real-time features (WebSocket, SSE, Pusher)
68
+ - SEO optimization (meta tags, structured data, sitemap)
69
+ - Image/font optimization (next/image, next/font)
70
+ - API versioning strategy
71
+ - PWA support
72
72
 
73
- 9. 안티패턴 / 비일관성
74
- - Server/Client Component 경계 혼란
75
- - 불필요한 'use client'
76
- - 다른 도메인과 불일치하는 패턴
77
- - 성능 문제 (불필요한 리렌더링, 번들 크기, 레이아웃 시프트)
78
- - 타입 안정성 문제
79
- - 접근성 문제
80
- - 보안 문제 (XSS, CSRF)
73
+ 9. Anti-patterns / Inconsistencies
74
+ - Server/Client Component boundary confusion
75
+ - Unnecessary 'use client'
76
+ - Patterns inconsistent with other domains
77
+ - Performance issues (unnecessary re-renders, bundle size, layout shift)
78
+ - Type safety issues
79
+ - Accessibility issues
80
+ - Security issues (XSS, CSRF)
81
81
 
82
- 파일 생성은 하지 마. 분석만.
83
- 결과를 claudeos-core/generated/pass1-{{PASS_NUM}}.json 아래 형식으로 저장:
82
+ Do not create files. Analysis only.
83
+ Save results to claudeos-core/generated/pass1-{{PASS_NUM}}.json in the following format:
84
84
 
85
85
  {
86
86
  "analyzedAt": "ISO timestamp",
@@ -109,7 +109,7 @@ claudeos-core/generated/project-analysis.json을 읽고,
109
109
  }
110
110
  },
111
111
  "crossDomainCommon": {
112
- "description": " 그룹의 도메인들이 공통으로 사용하는 패턴",
112
+ "description": "Patterns commonly used across domains in this group",
113
113
  "patterns": []
114
114
  }
115
115
  }
@@ -1,74 +1,74 @@
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
- - 페이지/라우팅 구조 (App Router / Pages Router)
8
- - 컴포넌트 작성 규칙 (함수형, Props 타입, 스타일링)
9
- - 데이터 페칭 전략 (RSC vs Client)
10
- - 상태 관리 방식
11
- - 에러/로딩 처리 패턴
12
- - middleware.ts 활용
6
+ 1. Universal Patterns (shared by 100% of all domains)
7
+ - Page/routing structure (App Router / Pages Router)
8
+ - Component writing conventions (functional, Props types, styling)
9
+ - Data fetching strategy (RSC vs Client)
10
+ - State management approach
11
+ - Error/loading handling patterns
12
+ - middleware.ts usage
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
- - 실시간 기능: 어느 도메인
20
- - 파일 업로드: 어느 도메인
21
- - 국제화: 어느 도메인
22
- - SEO 최적화: 어느 도메인
17
+ 3. Domain-Specific Patterns (unique to a single domain)
18
+ - Auth: which domain
19
+ - Real-time features: which domain
20
+ - File upload: which domain
21
+ - i18n: which domain
22
+ - SEO optimization: which domain
23
23
 
24
- 4. 안티패턴 종합
25
- - 모든 도메인에서 발견된 비일관성 통합
26
- - 심각도별 분류 (CRITICAL / HIGH / MEDIUM / LOW)
24
+ 4. Anti-pattern Summary
25
+ - Consolidate all inconsistencies found across domains
26
+ - Classify by severity (CRITICAL / HIGH / MEDIUM / LOW)
27
27
 
28
- 5. 명명 규칙 종합
29
- - 파일/디렉토리 네이밍 (kebab-case, PascalCase)
30
- - 컴포넌트 네이밍 규칙
31
- - 네이밍 (use* 접두사)
32
- - API 라우트 패턴
28
+ 5. Naming Conventions Summary
29
+ - File/directory naming (kebab-case, PascalCase)
30
+ - Component naming conventions
31
+ - Hook naming (use* prefix)
32
+ - API route patterns
33
33
 
34
- 6. 공유 타입/컴포넌트 목록
35
- - 공통 UI 컴포넌트
36
- - 공유
37
- - 유틸리티 함수
38
- - 환경변수 타입
39
- - 상수/Enum 관리
34
+ 6. Shared Types/Components List
35
+ - Common UI components
36
+ - Shared hooks
37
+ - Utility functions
38
+ - Environment variable types
39
+ - Constants/Enum management
40
40
 
41
- 7. 보안/인증 패턴
42
- - 인증 방식 (NextAuth, 커스텀)
43
- - 미들웨어 보호 전략
44
- - CSRF/XSS 방지
45
- - 환경변수 관리 (NEXT_PUBLIC_ 규칙)
46
- - 콘텐츠 보안 정책 (CSP)
41
+ 7. Security/Authentication Patterns
42
+ - Authentication approach (NextAuth, custom)
43
+ - Middleware protection strategy
44
+ - CSRF/XSS prevention
45
+ - Environment variable management (NEXT_PUBLIC_ convention)
46
+ - Content security policy (CSP)
47
47
 
48
- 8. 성능 패턴
49
- - Server Component 활용도
50
- - 이미지/폰트 최적화 전략
51
- - 번들 최적화 (dynamic import, tree shaking)
52
- - 캐싱 전략 (ISR, revalidate, cache tags)
53
- - Web Vitals 현황
48
+ 8. Performance Patterns
49
+ - Server Component utilization
50
+ - Image/font optimization strategy
51
+ - Bundle optimization (dynamic import, tree shaking)
52
+ - Caching strategy (ISR, revalidate, cache tags)
53
+ - Web Vitals status
54
54
 
55
- 9. 테스트 전략 종합
56
- - 테스트 커버리지 수준
57
- - 테스트 분류 체계 (단위/컴포넌트/E2E)
58
- - 모킹 전략 (MSW, jest.mock)
59
- - Storybook 활용 여부
60
- - 테스트 네이밍 규칙
55
+ 9. Testing Strategy Summary
56
+ - Test coverage level
57
+ - Test classification system (unit/component/E2E)
58
+ - Mocking strategy (MSW, jest.mock)
59
+ - Storybook usage
60
+ - Test naming conventions
61
61
 
62
- 10. 로깅/모니터링 전략
63
- - 에러 추적 방식 (Sentry, DataDog)
64
- - 분석 도구
65
- - Web Vitals 모니터링
62
+ 10. Logging/Monitoring Strategy
63
+ - Error tracking approach (Sentry, DataDog)
64
+ - Analytics tools
65
+ - Web Vitals monitoring
66
66
 
67
- 11. 코드 품질 도구
68
- - Lint/Format 도구 (ESLint, Prettier, Biome)
69
- - Pre-commit (husky, lint-staged)
70
- - TypeScript strict 모드 여부
71
- - CI 연동 현황
67
+ 11. Code Quality Tools
68
+ - Lint/Format tools (ESLint, Prettier, Biome)
69
+ - Pre-commit hooks (husky, lint-staged)
70
+ - TypeScript strict mode
71
+ - CI integration status
72
72
 
73
- 코드 생성은 하지 마. 통합만.
74
- 결과를 claudeos-core/generated/pass2-merged.json에 저장.
73
+ Do not generate code. Merge only.
74
+ Save results to claudeos-core/generated/pass2-merged.json.
@@ -1,56 +1,56 @@
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, dev/build/start)
12
- - 핵심 아키텍처 다이어그램
13
- - 디렉토리 구조 설명
14
- - Standard/Skills/Guide 참조 테이블
12
+ - Core architecture diagram
13
+ - Directory structure description
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 — App Router 구조, 컴포넌트 계층, 데이터 흐름
19
- - 00.core/03.naming-conventions.md — 파일/컴포넌트/훅/타입 명명규칙
20
- - 20.frontend-ui/01.component-patterns.md — 컴포넌트 작성 규칙, Props 패턴, 재사용
21
- - 20.frontend-ui/02.page-routing-patterns.md — 페이지/레이아웃/동적라우트/미들웨어
22
- - 20.frontend-ui/03.data-fetching.md — RSC, Server Actions, TanStack Query, 캐싱
23
- - 20.frontend-ui/04.state-management.md — 전역/서버/URL/폼 상태 관리
24
- - 20.frontend-ui/05.styling-patterns.md — 스타일링 규칙, 테마, 반응형, 접근성
25
- - 10.backend-api/01.api-routes.md — Route Handlers, Server Actions 패턴
26
- - 30.security-db/01.security-auth.md — NextAuth, 미들웨어, 환경변수, CSP
27
- - 40.infra/01.environment-config.md — 환경변수, next.config, 빌드 최적화
28
- - 40.infra/02.logging-monitoring.md — 에러 추적, 분석 도구, Web Vitals
29
- - 40.infra/03.cicd-deployment.md — CI/CD, Vercel/Docker 배포, 프리뷰
30
- - 50.verification/01.development-verification.md — 빌드, 기동, Lighthouse
31
- - 50.verification/02.testing-strategy.md — 테스트 전략, RTL, E2E, Storybook
16
+ 2. claudeos-core/standard/ (active domains only)
17
+ - 00.core/01.project-overview.md — Stack, routing approach, deployment environment
18
+ - 00.core/02.architecture.md — App Router structure, component hierarchy, data flow
19
+ - 00.core/03.naming-conventions.md — File/component/hook/type naming conventions
20
+ - 20.frontend-ui/01.component-patterns.md — Component writing rules, Props patterns, reuse
21
+ - 20.frontend-ui/02.page-routing-patterns.md — Pages/layouts/dynamic routes/middleware
22
+ - 20.frontend-ui/03.data-fetching.md — RSC, Server Actions, TanStack Query, caching
23
+ - 20.frontend-ui/04.state-management.md — Global/server/URL/form state management
24
+ - 20.frontend-ui/05.styling-patterns.md — Styling rules, theming, responsive, accessibility
25
+ - 10.backend-api/01.api-routes.md — Route Handlers, Server Actions patterns
26
+ - 30.security-db/01.security-auth.md — NextAuth, middleware, environment variables, CSP
27
+ - 40.infra/01.environment-config.md — Environment variables, next.config, build optimization
28
+ - 40.infra/02.logging-monitoring.md — Error tracking, analytics tools, Web Vitals
29
+ - 40.infra/03.cicd-deployment.md — CI/CD, Vercel/Docker deployment, preview
30
+ - 50.verification/01.development-verification.md — Build, startup, Lighthouse
31
+ - 50.verification/02.testing-strategy.md — Testing strategy, RTL, E2E, Storybook
32
32
 
33
- 파일에는 반드시 포함:
34
- - 올바른 예시 (✅ 코드 블록)
35
- - 잘못된 예시 (❌ 코드 블록)
36
- - 핵심 규칙 요약 테이블
33
+ Each file MUST include:
34
+ - Correct examples (✅ code blocks)
35
+ - Incorrect examples (❌ code blocks)
36
+ - Key rules summary table
37
37
 
38
- 3. .claude/rules/ (활성 도메인만)
39
- - 규칙 파일에 paths: frontmatter 포함
40
- - 핵심 규칙 5~10 직접 기술
41
- - @import로 상세 standard 참조 (경로: @../../claudeos-core/standard/...)
38
+ 3. .claude/rules/ (active domains only)
39
+ - Each rule file must include paths: frontmatter
40
+ - Write 5-10 lines of key rules directly
41
+ - Reference detailed standards via @import (path: @../../claudeos-core/standard/...)
42
42
 
43
- 4. .claude/rules/50.sync/ (동기화 규칙 3개)
43
+ 4. .claude/rules/50.sync/ (3 sync rules)
44
44
  - 01.standard-sync.md
45
45
  - 02.rules-sync.md
46
46
  - 03.skills-sync.md
47
47
 
48
- 5. claudeos-core/skills/ (활성 도메인만)
49
- - 20.frontend-page/01.scaffold-page-feature.md (오케스트레이터)
50
- - 20.frontend-page/scaffold-page-feature/01~08 (하위 스킬: page, layout, component, hook, api-route, test, style, index)
51
- - 00.shared/MANIFEST.md (스킬 레지스트리)
48
+ 5. claudeos-core/skills/ (active domains only)
49
+ - 20.frontend-page/01.scaffold-page-feature.md (orchestrator)
50
+ - 20.frontend-page/scaffold-page-feature/01~08 (sub-skills: page, layout, component, hook, api-route, test, style, index)
51
+ - 00.shared/MANIFEST.md (skill registry)
52
52
 
53
- 6. claudeos-core/guide/ (전체)
53
+ 6. claudeos-core/guide/ (all)
54
54
  - 01.onboarding/01.overview.md
55
55
  - 01.onboarding/02.quickstart.md
56
56
  - 01.onboarding/03.glossary.md
@@ -61,15 +61,15 @@ claudeos-core/generated/pass2-merged.json을 읽고,
61
61
  - 04.architecture/01.file-map.md
62
62
  - 04.architecture/02.pros-and-cons.md
63
63
 
64
- 7. claudeos-core/plan/ (마스터 플랜)
65
- - 10.standard-master.md — CLAUDE.md + standard/ 전체 <file> 블록
66
- - 20.rules-master.md — rules/ (sync 제외) 전체 <file> 블록
67
- - 21.sync-rules-master.md — sync 규칙 전체 (코드블록 방식)
68
- - 30.frontend-skills-master.md — frontend skills 전체 <file> 블록
69
- - 40.guides-master.md — guide/ 전체 <file> 블록
64
+ 7. claudeos-core/plan/ (Master Plan)
65
+ - 10.standard-master.md — CLAUDE.md + all standard/ files as <file> blocks
66
+ - 20.rules-master.md — All rules/ (except sync) as <file> blocks
67
+ - 21.sync-rules-master.md — All sync rules (code block format)
68
+ - 30.frontend-skills-master.md — All frontend skills as <file> blocks
69
+ - 40.guides-master.md — All guide/ files as <file> blocks
70
70
 
71
71
  8. claudeos-core/database/
72
- - 01.schema-overview.md — DB 스키마 설명 (사용하는 경우)
72
+ - 01.schema-overview.md — DB schema description (if applicable)
73
73
 
74
74
  9. claudeos-core/mcp-guide/
75
- - 01.mcp-overview.md — 사용 중인 MCP 서버 목록, 연동 방법
75
+ - 01.mcp-overview.md — List of MCP servers in use, integration methods
@@ -1,94 +1,94 @@
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. View 패턴
10
- - View 타입 (FBV vs CBV vs ViewSet vs GenericAPIView)
11
- - URL 설정 (urlpatterns, Router 등록, namespace)
12
- - 파라미터 처리 (request.data, serializer, query_params, kwargs)
13
- - 응답 형식 (Response, JsonResponse, TemplateResponse)
14
- - 에러 핸들링 (exception_handler, DRF exceptions, 커스텀 예외)
15
- - 인증 (permission_classes, authentication_classes)
16
- - API 문서화 (drf-spectacular, drf-yasg, @extend_schema)
17
- - 페이지네이션 (PageNumberPagination, CursorPagination, LimitOffsetPagination)
18
- - 필터링/검색 (django-filter, SearchFilter, OrderingFilter)
19
- - API 버저닝 (URL, Header, Namespace)
9
+ 1. View Patterns
10
+ - View type (FBV vs CBV vs ViewSet vs GenericAPIView)
11
+ - URL configuration (urlpatterns, Router registration, namespace)
12
+ - Parameter handling (request.data, serializer, query_params, kwargs)
13
+ - Response format (Response, JsonResponse, TemplateResponse)
14
+ - Error handling (exception_handler, DRF exceptions, custom exceptions)
15
+ - Authentication (permission_classes, authentication_classes)
16
+ - API documentation (drf-spectacular, drf-yasg, @extend_schema)
17
+ - Pagination (PageNumberPagination, CursorPagination, LimitOffsetPagination)
18
+ - Filtering/search (django-filter, SearchFilter, OrderingFilter)
19
+ - API versioning (URL, Header, Namespace)
20
20
 
21
- 2. Serializer/Form 패턴
22
- - Serializer 타입 (ModelSerializer, Serializer, HyperlinkedSerializer)
23
- - 유효성 검증 (validate_*, validators, UniqueValidator)
24
- - 중첩 Serializer (depth, 수동 중첩, writable nested)
25
- - Form 사용 (ModelForm, Form, Formset)
26
- - 필드 커스터마이징 (SerializerMethodField, to_representation)
21
+ 2. Serializer/Form Patterns
22
+ - Serializer type (ModelSerializer, Serializer, HyperlinkedSerializer)
23
+ - Validation (validate_*, validators, UniqueValidator)
24
+ - Nested serializers (depth, manual nesting, writable nested)
25
+ - Form usage (ModelForm, Form, Formset)
26
+ - Field customization (SerializerMethodField, to_representation)
27
27
 
28
- 3. Model 패턴
29
- - 모델 구조 (AbstractModel, 상속, Proxy, Multi-table)
30
- - 필드 타입 옵션 (null, blank, default, choices, validators)
31
- - Manager 커스터마이징 (custom QuerySet, soft delete)
32
- - QuerySet 메서드 (annotate, aggregate, select_related, prefetch_related)
33
- - Signal 사용 (pre_save, post_save, pre_delete)
34
- - Meta 옵션 (ordering, verbose_name, constraints, indexes, unique_together)
35
- - N+1 대응 (select_related, prefetch_related)
28
+ 3. Model Patterns
29
+ - Model structure (AbstractModel, inheritance, Proxy, Multi-table)
30
+ - Field types and options (null, blank, default, choices, validators)
31
+ - Manager customization (custom QuerySet, soft delete)
32
+ - QuerySet methods (annotate, aggregate, select_related, prefetch_related)
33
+ - Signal usage (pre_save, post_save, pre_delete)
34
+ - Meta options (ordering, verbose_name, constraints, indexes, unique_together)
35
+ - N+1 handling (select_related, prefetch_related)
36
36
 
37
- 4. 비즈니스 로직 패턴
38
- - 아키텍처 (Fat Model vs Service Layer vs Domain Service)
39
- - 트랜잭션 (transaction.atomic, select_for_update, savepoint)
40
- - Celery 태스크 (shared_task, 재시도, 우선순위)
41
- - 유틸리티/헬퍼 함수
42
- - 이벤트 처리 (django-signals, custom event bus)
37
+ 4. Business Logic Patterns
38
+ - Architecture (Fat Model vs Service Layer vs Domain Service)
39
+ - Transactions (transaction.atomic, select_for_update, savepoint)
40
+ - Celery tasks (shared_task, retry, priority)
41
+ - Utility/helper functions
42
+ - Event handling (django-signals, custom event bus)
43
43
 
44
- 5. 설정/환경 패턴
45
- - settings 분리 (base/local/staging/production)
46
- - 환경변수 관리 (django-environ, python-decouple, os.environ)
47
- - 설정 검증
48
- - 설정 (AppConfig, ready())
44
+ 5. Configuration/Environment Patterns
45
+ - Settings separation (base/local/staging/production)
46
+ - Environment variable management (django-environ, python-decouple, os.environ)
47
+ - Configuration validation
48
+ - App configuration (AppConfig, ready())
49
49
 
50
- 6. 로깅 패턴
51
- - 로거 사용 (Django logging, structlog)
52
- - 로그 레벨 정책
53
- - 구조화 로깅
54
- - 요청/응답 로깅 (middleware)
50
+ 6. Logging Patterns
51
+ - Logger usage (Django logging, structlog)
52
+ - Log level policy
53
+ - Structured logging
54
+ - Request/response logging (middleware)
55
55
 
56
- 7. 테스트 패턴
57
- - 테스트 프레임워크 (pytest-django, unittest, factory_boy)
58
- - 테스트 분류 (단위/통합/E2E)
59
- - Fixture/Factory 전략 (factory_boy, FactoryBoy, pytest fixture)
56
+ 7. Testing Patterns
57
+ - Test framework (pytest-django, unittest, factory_boy)
58
+ - Test classification (unit/integration/E2E)
59
+ - Fixture/Factory strategy (factory_boy, FactoryBoy, pytest fixture)
60
60
  - APITestCase vs TestCase
61
- - DB 테스트 전략 (TransactionTestCase, test DB)
62
- - 모킹 (unittest.mock, pytest-mock, responses)
63
- - 테스트 네이밍 규칙
61
+ - DB test strategy (TransactionTestCase, test DB)
62
+ - Mocking (unittest.mock, pytest-mock, responses)
63
+ - Test naming conventions
64
64
 
65
- 8. Admin 패턴
66
- - ModelAdmin 커스터마이징 (list_display, search_fields, filters)
67
- - Inline 사용
68
- - 커스텀 액션
69
- - Admin 권한 관리
65
+ 8. Admin Patterns
66
+ - ModelAdmin customization (list_display, search_fields, filters)
67
+ - Inline usage
68
+ - Custom actions
69
+ - Admin permission management
70
70
 
71
- 9. 도메인만의 특화 패턴
72
- - 파일 업로드 (FileField, ImageField, S3, django-storages)
71
+ 9. Domain-Specific Patterns
72
+ - File upload (FileField, ImageField, S3, django-storages)
73
73
  - WebSocket (Django Channels, ASGI)
74
- - 비동기 처리 (Celery, async views, django-rq)
75
- - 외부 API 연동 (requests, httpx, aiohttp)
76
- - 캐싱 (Django cache framework, Redis, per-view cache)
77
- - Management Command
78
- - 국제화 (gettext, i18n middleware)
79
- - 메시징 (Kafka, RabbitMQ, Celery broker)
80
- - API 버저닝
74
+ - Async processing (Celery, async views, django-rq)
75
+ - External API integration (requests, httpx, aiohttp)
76
+ - Caching (Django cache framework, Redis, per-view cache)
77
+ - Management Commands
78
+ - Internationalization (gettext, i18n middleware)
79
+ - Messaging (Kafka, RabbitMQ, Celery broker)
80
+ - API versioning
81
+
82
+ 10. Anti-patterns / Inconsistencies
83
+ - Code with differing styles within the domain
84
+ - Fat Views (business logic concentrated in views)
85
+ - N+1 query problems
86
+ - Legacy-looking patterns
87
+ - Security issues (SQL Injection, missing authorization, CSRF)
88
+ - Performance issues (unnecessary queries, memory)
81
89
 
82
- 10. 안티패턴 / 비일관성
83
- - 도메인 내에서 스타일이 다른 코드
84
- - Fat View (비즈니스 로직이 View에 집중)
85
- - N+1 쿼리 문제
86
- - 레거시로 보이는 패턴
87
- - 보안 문제 (SQL Injection, 권한 누락, CSRF)
88
- - 성능 문제 (불필요한 쿼리, 메모리)
89
-
90
- 파일 생성은 하지 마. 분석만.
91
- 결과를 claudeos-core/generated/pass1-{{PASS_NUM}}.json에 아래 형식으로 저장:
90
+ Do not create files. Analysis only.
91
+ Save results to claudeos-core/generated/pass1-{{PASS_NUM}}.json in the following format:
92
92
 
93
93
  {
94
94
  "analyzedAt": "ISO timestamp",
@@ -118,7 +118,7 @@ claudeos-core/generated/project-analysis.json을 읽고,
118
118
  }
119
119
  },
120
120
  "crossDomainCommon": {
121
- "description": " 그룹의 도메인들이 공통으로 사용하는 패턴",
121
+ "description": "Patterns commonly used across domains in this group",
122
122
  "patterns": []
123
123
  }
124
124
  }