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.
- package/CHANGELOG.md +84 -1
- package/CONTRIBUTING.md +15 -4
- package/README.de.md +187 -11
- package/README.es.md +187 -11
- package/README.fr.md +187 -11
- package/README.hi.md +187 -11
- package/README.ja.md +186 -10
- package/README.ko.md +331 -364
- package/README.md +200 -11
- package/README.ru.md +187 -11
- package/README.vi.md +188 -12
- package/README.zh-CN.md +186 -10
- package/bin/cli.js +183 -61
- package/bootstrap.sh +128 -21
- package/content-validator/index.js +131 -60
- package/health-checker/index.js +29 -23
- package/import-linter/index.js +14 -8
- package/manifest-generator/index.js +26 -20
- package/package.json +84 -75
- package/pass-json-validator/index.js +92 -70
- package/pass-prompts/templates/common/header.md +4 -4
- package/pass-prompts/templates/common/lang-instructions.json +27 -0
- package/pass-prompts/templates/common/pass3-footer.md +2 -3
- package/pass-prompts/templates/java-spring/pass1.md +84 -81
- package/pass-prompts/templates/java-spring/pass2.md +66 -66
- package/pass-prompts/templates/java-spring/pass3.md +60 -60
- package/pass-prompts/templates/kotlin-spring/pass1.md +172 -0
- package/pass-prompts/templates/kotlin-spring/pass2.md +109 -0
- package/pass-prompts/templates/kotlin-spring/pass3.md +98 -0
- package/pass-prompts/templates/node-express/pass1.md +73 -73
- package/pass-prompts/templates/node-express/pass2.md +66 -66
- package/pass-prompts/templates/node-express/pass3.md +53 -53
- package/pass-prompts/templates/node-nextjs/pass1.md +68 -68
- package/pass-prompts/templates/node-nextjs/pass2.md +61 -61
- package/pass-prompts/templates/node-nextjs/pass3.md +48 -48
- package/pass-prompts/templates/python-django/pass1.md +78 -78
- package/pass-prompts/templates/python-django/pass2.md +69 -69
- package/pass-prompts/templates/python-django/pass3.md +45 -45
- package/pass-prompts/templates/python-fastapi/pass1.md +76 -76
- package/pass-prompts/templates/python-fastapi/pass2.md +67 -67
- package/pass-prompts/templates/python-fastapi/pass3.md +45 -45
- package/plan-installer/index.js +623 -97
- package/plan-validator/index.js +54 -23
- package/sync-checker/index.js +25 -14
|
@@ -1,86 +1,86 @@
|
|
|
1
|
-
claudeos-core/generated/project-analysis.json
|
|
2
|
-
|
|
1
|
+
Read claudeos-core/generated/project-analysis.json and
|
|
2
|
+
perform a deep analysis of the following domains only: {{DOMAIN_GROUP}}
|
|
3
3
|
|
|
4
|
-
|
|
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
|
-
-
|
|
11
|
-
-
|
|
12
|
-
-
|
|
13
|
-
- Server Components vs Client Components
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
- middleware.ts
|
|
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
|
-
-
|
|
20
|
-
- Props
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
- UI
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
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
|
-
-
|
|
34
|
-
-
|
|
35
|
-
-
|
|
33
|
+
- Caching strategy (revalidate, cache tags, ISR)
|
|
34
|
+
- Error/loading state handling
|
|
35
|
+
- Streaming (Suspense, streaming SSR)
|
|
36
36
|
|
|
37
|
-
4.
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
- URL
|
|
41
|
-
-
|
|
42
|
-
-
|
|
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
|
-
-
|
|
46
|
-
- next.config
|
|
47
|
-
-
|
|
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
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
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
|
-
-
|
|
57
|
-
-
|
|
58
|
-
- E2E
|
|
59
|
-
-
|
|
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
|
-
-
|
|
65
|
-
-
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
-
- SEO
|
|
69
|
-
-
|
|
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
|
-
-
|
|
76
|
-
-
|
|
77
|
-
-
|
|
78
|
-
-
|
|
79
|
-
-
|
|
80
|
-
-
|
|
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
|
-
|
|
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/
|
|
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.
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
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.
|
|
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
|
-
-
|
|
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
|
-
-
|
|
30
|
-
-
|
|
31
|
-
-
|
|
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
|
-
-
|
|
36
|
-
-
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
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
|
-
-
|
|
43
|
-
-
|
|
44
|
-
- CSRF/XSS
|
|
45
|
-
-
|
|
46
|
-
-
|
|
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
|
-
-
|
|
52
|
-
-
|
|
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
|
-
-
|
|
58
|
-
-
|
|
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
|
-
-
|
|
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
|
|
69
|
-
- Pre-commit
|
|
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
|
-
|
|
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
|
-
|
|
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 —
|
|
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 —
|
|
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,
|
|
27
|
-
- 40.infra/01.environment-config.md —
|
|
28
|
-
- 40.infra/02.logging-monitoring.md —
|
|
29
|
-
- 40.infra/03.cicd-deployment.md — CI/CD, Vercel/Docker
|
|
30
|
-
- 50.verification/01.development-verification.md —
|
|
31
|
-
- 50.verification/02.testing-strategy.md —
|
|
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
|
-
-
|
|
40
|
-
-
|
|
41
|
-
-
|
|
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/ (
|
|
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 (
|
|
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/
|
|
66
|
-
- 20.rules-master.md — rules/ (sync
|
|
67
|
-
- 21.sync-rules-master.md — sync
|
|
68
|
-
- 30.frontend-skills-master.md — frontend skills
|
|
69
|
-
- 40.guides-master.md — guide/
|
|
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 —
|
|
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
|
-
|
|
1
|
+
Read claudeos-core/generated/project-analysis.json and
|
|
2
|
+
perform a deep analysis of the following domains only: {{DOMAIN_GROUP}}
|
|
3
3
|
|
|
4
|
-
|
|
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
|
|
11
|
-
- URL
|
|
12
|
-
-
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
- API
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
-
- API
|
|
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
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
- Form
|
|
26
|
-
-
|
|
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
|
-
-
|
|
30
|
-
-
|
|
31
|
-
- Manager
|
|
32
|
-
- QuerySet
|
|
33
|
-
- Signal
|
|
34
|
-
- Meta
|
|
35
|
-
- N+1
|
|
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
|
-
-
|
|
39
|
-
-
|
|
40
|
-
- Celery
|
|
41
|
-
-
|
|
42
|
-
-
|
|
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
|
-
-
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
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
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
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
|
-
-
|
|
58
|
-
-
|
|
59
|
-
- Fixture/Factory
|
|
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
|
|
62
|
-
-
|
|
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
|
|
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
|
-
-
|
|
71
|
+
9. Domain-Specific Patterns
|
|
72
|
+
- File upload (FileField, ImageField, S3, django-storages)
|
|
73
73
|
- WebSocket (Django Channels, ASGI)
|
|
74
|
-
-
|
|
75
|
-
-
|
|
76
|
-
-
|
|
77
|
-
- Management
|
|
78
|
-
-
|
|
79
|
-
-
|
|
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
|
-
|
|
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
|
}
|