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
|
@@ -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
|
-
|
|
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. Router/Controller
|
|
10
|
-
-
|
|
11
|
-
-
|
|
12
|
-
- URL
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
- API
|
|
18
|
-
-
|
|
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
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
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
|
|
29
|
-
- Repository
|
|
30
|
-
-
|
|
31
|
-
-
|
|
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
|
-
-
|
|
38
|
-
-
|
|
39
|
-
- Request/Response
|
|
40
|
-
- TypeScript
|
|
41
|
-
-
|
|
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
|
-
-
|
|
46
|
-
-
|
|
47
|
-
-
|
|
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
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
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
|
-
-
|
|
58
|
-
-
|
|
59
|
-
-
|
|
60
|
-
-
|
|
61
|
-
-
|
|
62
|
-
- 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
|
-
-
|
|
66
|
-
- WebSocket
|
|
67
|
-
-
|
|
68
|
-
-
|
|
69
|
-
-
|
|
70
|
-
-
|
|
71
|
-
-
|
|
72
|
-
-
|
|
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
|
-
-
|
|
81
|
-
-
|
|
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
|
-
|
|
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/
|
|
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
|
-
- Router/Controller
|
|
8
|
-
- Service
|
|
9
|
-
-
|
|
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.
|
|
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
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
32
|
-
- DTO
|
|
33
|
-
-
|
|
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
|
-
-
|
|
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.
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
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
|
-
-
|
|
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
|
|
77
|
-
- Pre-commit
|
|
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
|
-
|
|
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
|
-
|
|
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 —
|
|
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 —
|
|
25
|
-
- 10.backend-api/06.middleware-interceptor.md —
|
|
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 —
|
|
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
|
-
-
|
|
42
|
-
-
|
|
43
|
-
-
|
|
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/ (
|
|
46
|
-
- 01.standard-sync.md —
|
|
47
|
-
- 02.rules-sync.md —
|
|
48
|
-
- 03.skills-sync.md —
|
|
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 (
|
|
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/
|
|
68
|
-
- 20.rules-master.md — rules/ (sync
|
|
69
|
-
- 21.sync-rules-master.md — sync
|
|
70
|
-
- 30.backend-skills-master.md — backend skills
|
|
71
|
-
- 40.guides-master.md — guide/
|
|
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 —
|
|
78
|
+
- 01.mcp-overview.md — List of MCP servers in use, integration methods
|