claudeos-core 2.3.2 → 2.4.1
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.
- package/CHANGELOG.md +790 -74
- package/CODE_OF_CONDUCT.md +15 -0
- package/README.de.md +374 -876
- package/README.es.md +374 -875
- package/README.fr.md +374 -875
- package/README.hi.md +374 -875
- package/README.ja.md +374 -875
- package/README.ko.md +374 -874
- package/README.md +374 -876
- package/README.ru.md +374 -877
- package/README.vi.md +374 -875
- package/README.zh-CN.md +374 -874
- package/SECURITY.md +51 -0
- package/bin/commands/init.js +192 -37
- package/content-validator/index.js +97 -4
- package/health-checker/index.js +44 -10
- package/package.json +92 -90
- package/pass-json-validator/index.js +58 -7
- package/pass-prompts/templates/angular/pass3.md +15 -14
- package/pass-prompts/templates/common/claude-md-scaffold.md +81 -0
- package/pass-prompts/templates/common/pass3-footer.md +104 -0
- package/pass-prompts/templates/java-spring/pass3.md +19 -18
- package/pass-prompts/templates/kotlin-spring/pass3.md +23 -22
- package/pass-prompts/templates/node-express/pass3.md +18 -17
- package/pass-prompts/templates/node-fastify/pass3.md +11 -10
- package/pass-prompts/templates/node-nestjs/pass3.md +11 -10
- package/pass-prompts/templates/node-nextjs/pass3.md +18 -17
- package/pass-prompts/templates/node-vite/pass3.md +11 -10
- package/pass-prompts/templates/python-django/pass3.md +18 -17
- package/pass-prompts/templates/python-fastapi/pass3.md +18 -17
- package/pass-prompts/templates/python-flask/pass3.md +9 -8
- package/pass-prompts/templates/vue-nuxt/pass3.md +9 -8
- package/plan-installer/domain-grouper.js +45 -5
- package/plan-installer/index.js +11 -1
- package/plan-installer/scanners/scan-java.js +98 -2
- package/plan-installer/stack-detector.js +44 -0
|
@@ -81,23 +81,23 @@ Generation targets:
|
|
|
81
81
|
- 00.core/01.project-overview.md — Stack (Kotlin version, Spring Boot version), module list, server ports
|
|
82
82
|
- 00.core/02.architecture.md — CQRS architecture, BFF layer, request flow (Client → BFF → Feign → Command/Query → DB), module dependency diagram
|
|
83
83
|
- 00.core/03.naming-conventions.md — Kotlin class/file/package naming, DTO naming (Command vs Query DTOs), module naming
|
|
84
|
-
- 10.backend
|
|
85
|
-
- 10.backend
|
|
86
|
-
- 10.backend
|
|
87
|
-
- 10.backend
|
|
88
|
-
- 10.backend
|
|
89
|
-
- 10.backend
|
|
90
|
-
- 10.backend
|
|
91
|
-
- 10.backend
|
|
92
|
-
- 20.frontend
|
|
84
|
+
- 10.backend/01.controller-patterns.md — Command controller vs Query controller rules + examples
|
|
85
|
+
- 10.backend/02.service-patterns.md — Transactions, DI, Kotlin idioms, command/query service separation
|
|
86
|
+
- 10.backend/03.data-access-patterns.md — ORM patterns (tailored to detected JPA/MyBatis/Exposed), read/write DB config
|
|
87
|
+
- 10.backend/04.response-exception.md — Response/error handling patterns, sealed class exceptions
|
|
88
|
+
- 10.backend/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
|
|
89
|
+
- 10.backend/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)
|
|
90
|
+
- 10.backend/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)
|
|
91
|
+
- 10.backend/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)
|
|
92
|
+
- 20.frontend/* — (generate only if frontend detected)
|
|
93
93
|
- 30.security-db/01.security-auth.md — Authentication, authorization, CORS, inter-module auth
|
|
94
94
|
- 30.security-db/02.database-schema.md — DDL, migrations, audit columns, read/write DB separation
|
|
95
95
|
- 30.security-db/03.common-utilities.md — Shared-lib utilities, extension functions, constants, Base classes
|
|
96
96
|
- 40.infra/01.environment-config.md — Profiles, multi-module config, Gradle Kotlin DSL, environment variables
|
|
97
97
|
- 40.infra/02.logging-monitoring.md — kotlin-logging standards, structured logging, distributed tracing
|
|
98
98
|
- 40.infra/03.cicd-deployment.md — CI/CD pipeline, Docker/K8s per module, deployment strategy
|
|
99
|
-
-
|
|
100
|
-
-
|
|
99
|
+
- 80.verification/01.development-verification.md — Build, startup (per module), API testing
|
|
100
|
+
- 80.verification/02.testing-strategy.md — Testing strategy (MockK, Kotest), per-module test approach
|
|
101
101
|
|
|
102
102
|
Each file MUST include:
|
|
103
103
|
- Correct examples (✅ code blocks in Kotlin)
|
|
@@ -112,7 +112,7 @@ Generation targets:
|
|
|
112
112
|
- Each rule file MUST end with a `## Reference` section linking to the corresponding standard file(s):
|
|
113
113
|
```
|
|
114
114
|
## Reference
|
|
115
|
-
> For detailed patterns and examples, Read: claudeos-core/standard/10.backend
|
|
115
|
+
> For detailed patterns and examples, Read: claudeos-core/standard/10.backend/01.controller-patterns.md
|
|
116
116
|
```
|
|
117
117
|
- `paths:` frontmatter per rule category:
|
|
118
118
|
- `00.core/*` rules: `paths: ["**/*"]` — always loaded (architecture, naming are universally needed)
|
|
@@ -123,6 +123,7 @@ Generation targets:
|
|
|
123
123
|
- `40.infra/03.cicd-deployment-rules.md` paths: `["**/*.yml", "**/*.yaml", "**/Dockerfile*", "**/*.gradle*", "**/*.kt", "**/*.kts"]` — CI / build config + source
|
|
124
124
|
- `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]` — loaded only when editing claudeos-core files
|
|
125
125
|
- `60.memory/*` rules: forward reference — Pass 4 will generate 4 files (01.decision-log, 02.failure-patterns, 03.compaction, 04.auto-rule-update), each with file-specific `paths`. Pass 3 must STILL list ```.claude/rules/60.memory/*``` as a row in CLAUDE.md Section 6 Rules table so developers/Claude see the category exists.
|
|
126
|
+
- `70.domains/*` rules (multi-domain projects only): per-domain rules at `.claude/rules/70.domains/{type}/{domain}-rules.md` (where `{type}` is `backend` or `frontend`, ALWAYS present even in single-stack projects for uniform layout + zero-migration future-proofing), each with a `paths:` glob scoped to that domain's source directories so the rule auto-loads only when editing files within the relevant domain. Folder name is PLURAL (`domains/`) — collection of N per-domain files — and each file inside uses the SINGULAR domain name (`{domain}-rules.md`). DO NOT use `60.domains/` (collides with `60.memory/`) and DO NOT skip the `{type}/` sub-folder. See pass3-footer.md "Per-domain folder convention" for the full rationale.
|
|
126
127
|
- MUST generate `.claude/rules/00.core/00.standard-reference.md` — a directory of all standard files. This is NOT a "read all" instruction. Claude should Read ONLY the standards relevant to the current task. Structure it as:
|
|
127
128
|
```
|
|
128
129
|
---
|
|
@@ -139,14 +140,14 @@ Generation targets:
|
|
|
139
140
|
- claudeos-core/standard/00.core/03.naming-conventions.md
|
|
140
141
|
- claudeos-core/standard/00.core/04.doc-writing-guide.md
|
|
141
142
|
## Backend API
|
|
142
|
-
- claudeos-core/standard/10.backend
|
|
143
|
-
- claudeos-core/standard/10.backend
|
|
144
|
-
- claudeos-core/standard/10.backend
|
|
145
|
-
- claudeos-core/standard/10.backend
|
|
146
|
-
- claudeos-core/standard/10.backend
|
|
147
|
-
- claudeos-core/standard/10.backend
|
|
148
|
-
- claudeos-core/standard/10.backend
|
|
149
|
-
- claudeos-core/standard/10.backend
|
|
143
|
+
- claudeos-core/standard/10.backend/01.controller-patterns.md
|
|
144
|
+
- claudeos-core/standard/10.backend/02.service-patterns.md
|
|
145
|
+
- claudeos-core/standard/10.backend/03.data-access-patterns.md
|
|
146
|
+
- claudeos-core/standard/10.backend/04.response-exception.md
|
|
147
|
+
- claudeos-core/standard/10.backend/05.dto-vo-validation.md
|
|
148
|
+
- claudeos-core/standard/10.backend/06.aggregate-patterns.md (if generated)
|
|
149
|
+
- claudeos-core/standard/10.backend/07.bff-feign-patterns.md (if generated)
|
|
150
|
+
- claudeos-core/standard/10.backend/08.inter-module-communication.md (if generated)
|
|
150
151
|
## Security & DB
|
|
151
152
|
- claudeos-core/standard/30.security-db/01.security-auth.md
|
|
152
153
|
- claudeos-core/standard/30.security-db/02.database-schema.md
|
|
@@ -155,8 +156,8 @@ Generation targets:
|
|
|
155
156
|
- claudeos-core/standard/40.infra/01.environment-config.md
|
|
156
157
|
- claudeos-core/standard/40.infra/02.logging-monitoring.md
|
|
157
158
|
- claudeos-core/standard/40.infra/03.cicd-deployment.md
|
|
158
|
-
- claudeos-core/standard/
|
|
159
|
-
- claudeos-core/standard/
|
|
159
|
+
- claudeos-core/standard/80.verification/01.development-verification.md
|
|
160
|
+
- claudeos-core/standard/80.verification/02.testing-strategy.md
|
|
160
161
|
```
|
|
161
162
|
List only the standard files that were actually generated above. Include frontend standards only if frontend was detected. NOTE: `00.core/04.doc-writing-guide.md` is a FORWARD REFERENCE — Pass 4 will generate it; include it anyway. Do NOT add a "DO NOT Read" section here — that information lives in CLAUDE.md Section 7 (the single source of truth).
|
|
162
163
|
|
|
@@ -55,20 +55,20 @@ Generation targets:
|
|
|
55
55
|
- 00.core/01.project-overview.md — Stack, modules, API server info
|
|
56
56
|
- 00.core/02.architecture.md — Layer structure, request flow, directory structure
|
|
57
57
|
- 00.core/03.naming-conventions.md — File/variable/type naming conventions
|
|
58
|
-
- 10.backend
|
|
59
|
-
- 10.backend
|
|
60
|
-
- 10.backend
|
|
61
|
-
- 10.backend
|
|
62
|
-
- 10.backend
|
|
63
|
-
- 10.backend
|
|
58
|
+
- 10.backend/01.router-controller-patterns.md — Routing patterns + middleware
|
|
59
|
+
- 10.backend/02.service-patterns.md — DI, transactions, business logic
|
|
60
|
+
- 10.backend/03.data-access-patterns.md — ORM patterns, query optimization
|
|
61
|
+
- 10.backend/04.response-exception.md — Response/error handling patterns
|
|
62
|
+
- 10.backend/05.validation-dto.md — Validation, DTO patterns
|
|
63
|
+
- 10.backend/06.middleware-interceptor.md — Middleware, Guard, Interceptor
|
|
64
64
|
- 30.security-db/01.security-auth.md — JWT, Guard, CORS, Rate Limit
|
|
65
65
|
- 30.security-db/02.database-schema.md — Migrations, seeds, schema conventions
|
|
66
66
|
- 30.security-db/03.common-utilities.md — Common utils, helpers, constants
|
|
67
67
|
- 40.infra/01.environment-config.md — Environment variables, config management
|
|
68
68
|
- 40.infra/02.logging-monitoring.md — Logging standards, monitoring, alerts
|
|
69
69
|
- 40.infra/03.cicd-deployment.md — CI/CD pipeline, deployment strategy
|
|
70
|
-
-
|
|
71
|
-
-
|
|
70
|
+
- 80.verification/01.development-verification.md — Build, startup, API testing
|
|
71
|
+
- 80.verification/02.testing-strategy.md — Testing strategy, mocking, coverage
|
|
72
72
|
|
|
73
73
|
Each file MUST include:
|
|
74
74
|
- Correct examples (✅ code blocks)
|
|
@@ -82,7 +82,7 @@ Generation targets:
|
|
|
82
82
|
- Each rule file MUST end with a `## Reference` section linking to the corresponding standard file(s):
|
|
83
83
|
```
|
|
84
84
|
## Reference
|
|
85
|
-
> For detailed patterns and examples, Read: claudeos-core/standard/10.backend
|
|
85
|
+
> For detailed patterns and examples, Read: claudeos-core/standard/10.backend/01.router-controller-patterns.md
|
|
86
86
|
```
|
|
87
87
|
- `paths:` frontmatter per rule category:
|
|
88
88
|
- `00.core/*` rules: `paths: ["**/*"]` — always loaded (architecture, naming are universally needed)
|
|
@@ -93,6 +93,7 @@ Generation targets:
|
|
|
93
93
|
- `40.infra/03.cicd-deployment-rules.md` paths: `["**/*.yml", "**/*.yaml", "**/Dockerfile*", "**/*.ts", "**/*.js"]` — CI config + source
|
|
94
94
|
- `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]` — loaded only when editing claudeos-core files
|
|
95
95
|
- `60.memory/*` rules: forward reference — Pass 4 will generate 4 files (01.decision-log, 02.failure-patterns, 03.compaction, 04.auto-rule-update), each with file-specific `paths`. Pass 3 must STILL list ```.claude/rules/60.memory/*``` as a row in CLAUDE.md Section 6 Rules table so developers/Claude see the category exists.
|
|
96
|
+
- `70.domains/*` rules (multi-domain projects only): per-domain rules at `.claude/rules/70.domains/{type}/{domain}-rules.md` (where `{type}` is `backend` or `frontend`, ALWAYS present even in single-stack projects for uniform layout + zero-migration future-proofing), each with a `paths:` glob scoped to that domain's source directories so the rule auto-loads only when editing files within the relevant domain. Folder name is PLURAL (`domains/`) — collection of N per-domain files — and each file inside uses the SINGULAR domain name (`{domain}-rules.md`). DO NOT use `60.domains/` (collides with `60.memory/`) and DO NOT skip the `{type}/` sub-folder. See pass3-footer.md "Per-domain folder convention" for the full rationale.
|
|
96
97
|
- MUST generate `.claude/rules/00.core/00.standard-reference.md` — a directory of all standard files. This is NOT a "read all" instruction. Claude should Read ONLY the standards relevant to the current task. Structure it as:
|
|
97
98
|
```
|
|
98
99
|
---
|
|
@@ -109,12 +110,12 @@ Generation targets:
|
|
|
109
110
|
- claudeos-core/standard/00.core/03.naming-conventions.md
|
|
110
111
|
- claudeos-core/standard/00.core/04.doc-writing-guide.md
|
|
111
112
|
## Backend API
|
|
112
|
-
- claudeos-core/standard/10.backend
|
|
113
|
-
- claudeos-core/standard/10.backend
|
|
114
|
-
- claudeos-core/standard/10.backend
|
|
115
|
-
- claudeos-core/standard/10.backend
|
|
116
|
-
- claudeos-core/standard/10.backend
|
|
117
|
-
- claudeos-core/standard/10.backend
|
|
113
|
+
- claudeos-core/standard/10.backend/01.router-controller-patterns.md
|
|
114
|
+
- claudeos-core/standard/10.backend/02.service-patterns.md
|
|
115
|
+
- claudeos-core/standard/10.backend/03.data-access-patterns.md
|
|
116
|
+
- claudeos-core/standard/10.backend/04.response-exception.md
|
|
117
|
+
- claudeos-core/standard/10.backend/05.validation-dto.md
|
|
118
|
+
- claudeos-core/standard/10.backend/06.middleware-interceptor.md
|
|
118
119
|
## Security & DB
|
|
119
120
|
- claudeos-core/standard/30.security-db/01.security-auth.md
|
|
120
121
|
- claudeos-core/standard/30.security-db/02.database-schema.md
|
|
@@ -123,8 +124,8 @@ Generation targets:
|
|
|
123
124
|
- claudeos-core/standard/40.infra/01.environment-config.md
|
|
124
125
|
- claudeos-core/standard/40.infra/02.logging-monitoring.md
|
|
125
126
|
- claudeos-core/standard/40.infra/03.cicd-deployment.md
|
|
126
|
-
- claudeos-core/standard/
|
|
127
|
-
- claudeos-core/standard/
|
|
127
|
+
- claudeos-core/standard/80.verification/01.development-verification.md
|
|
128
|
+
- claudeos-core/standard/80.verification/02.testing-strategy.md
|
|
128
129
|
```
|
|
129
130
|
List only the standard files that were actually generated above. NOTE: `00.core/04.doc-writing-guide.md` is a FORWARD REFERENCE — Pass 4 will generate it; include it anyway. Do NOT add a "DO NOT Read" section here — that information lives in CLAUDE.md Section 7 (the single source of truth).
|
|
130
131
|
|
|
@@ -53,24 +53,24 @@ Generation targets:
|
|
|
53
53
|
- 00.core/01.project-overview.md — Stack, modules, server info
|
|
54
54
|
- 00.core/02.architecture.md — Plugin architecture, request lifecycle, hooks flow
|
|
55
55
|
- 00.core/03.naming-conventions.md — File/route/schema/plugin naming conventions
|
|
56
|
-
- 10.backend
|
|
57
|
-
- 10.backend
|
|
58
|
-
- 10.backend
|
|
59
|
-
- 10.backend
|
|
60
|
-
- 10.backend
|
|
61
|
-
- 10.backend
|
|
56
|
+
- 10.backend/01.route-plugin-patterns.md — Route registration, plugin encapsulation, prefix
|
|
57
|
+
- 10.backend/02.service-patterns.md — DI (decorators/awilix), business logic
|
|
58
|
+
- 10.backend/03.data-access-patterns.md — ORM patterns, DB plugin lifecycle
|
|
59
|
+
- 10.backend/04.response-exception.md — Response format, error handling, setErrorHandler
|
|
60
|
+
- 10.backend/05.schema-validation.md — JSON Schema, TypeBox, shared schemas, serialization
|
|
61
|
+
- 10.backend/06.hooks-lifecycle.md — Hook order, scope, authentication hooks
|
|
62
62
|
- 30.security-db/01.security-auth.md — JWT, @fastify/auth, CORS, Rate Limit
|
|
63
63
|
- 30.security-db/02.database-schema.md — Migrations, seeds, schema conventions
|
|
64
64
|
- 30.security-db/03.common-utilities.md — Common utils, decorators, constants
|
|
65
65
|
- 40.infra/01.environment-config.md — @fastify/env, configuration management
|
|
66
66
|
- 40.infra/02.logging-monitoring.md — Pino config, serializers, monitoring
|
|
67
67
|
- 40.infra/03.cicd-deployment.md — CI/CD pipeline, deployment strategy
|
|
68
|
-
-
|
|
69
|
-
-
|
|
68
|
+
- 80.verification/01.development-verification.md — Build, startup, API testing
|
|
69
|
+
- 80.verification/02.testing-strategy.md — fastify.inject(), plugin testing, mocking
|
|
70
70
|
|
|
71
71
|
Each file MUST include:
|
|
72
|
-
- Correct examples (code blocks)
|
|
73
|
-
- Incorrect examples (code blocks)
|
|
72
|
+
- Correct examples (✅ code blocks)
|
|
73
|
+
- Incorrect examples (❌ code blocks)
|
|
74
74
|
- Key rules summary table
|
|
75
75
|
|
|
76
76
|
3. .claude/rules/ (active domains only)
|
|
@@ -87,6 +87,7 @@ Generation targets:
|
|
|
87
87
|
- `40.infra/03.cicd-deployment-rules.md` paths: `["**/*.yml", "**/*.yaml", "**/Dockerfile*", "**/*.ts", "**/*.js"]` — CI config + source
|
|
88
88
|
- `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]`
|
|
89
89
|
- `60.memory/*` rules: forward reference — Pass 4 will generate 4 files (01.decision-log, 02.failure-patterns, 03.compaction, 04.auto-rule-update), each with file-specific `paths`. Pass 3 must STILL list ```.claude/rules/60.memory/*``` as a row in CLAUDE.md Section 6 Rules table so developers/Claude see the category exists.
|
|
90
|
+
- `70.domains/*` rules (multi-domain projects only): per-domain rules at `.claude/rules/70.domains/{type}/{domain}-rules.md` (where `{type}` is `backend` or `frontend`, ALWAYS present even in single-stack projects for uniform layout + zero-migration future-proofing), each with a `paths:` glob scoped to that domain's source directories so the rule auto-loads only when editing files within the relevant domain. Folder name is PLURAL (`domains/`) — collection of N per-domain files — and each file inside uses the SINGULAR domain name (`{domain}-rules.md`). DO NOT use `60.domains/` (collides with `60.memory/`) and DO NOT skip the `{type}/` sub-folder. See pass3-footer.md "Per-domain folder convention" for the full rationale.
|
|
90
91
|
- MUST generate `.claude/rules/00.core/00.standard-reference.md` as a directory of all standard files
|
|
91
92
|
|
|
92
93
|
4. .claude/rules/50.sync/ (2 sync rules)
|
|
@@ -56,21 +56,21 @@ Generation targets:
|
|
|
56
56
|
- 00.core/01.project-overview.md — Stack, modules, API server info
|
|
57
57
|
- 00.core/02.architecture.md — NestJS module structure, DI container, request lifecycle (middleware → guard → interceptor → pipe → handler → interceptor → filter)
|
|
58
58
|
- 00.core/03.naming-conventions.md — File/variable/type/decorator naming conventions
|
|
59
|
-
- 10.backend
|
|
60
|
-
- 10.backend
|
|
61
|
-
- 10.backend
|
|
62
|
-
- 10.backend
|
|
63
|
-
- 10.backend
|
|
64
|
-
- 10.backend
|
|
65
|
-
- 10.backend
|
|
59
|
+
- 10.backend/01.controller-patterns.md — @Controller, decorators, parameter binding, response handling
|
|
60
|
+
- 10.backend/02.service-patterns.md — @Injectable, DI, transactions, business logic
|
|
61
|
+
- 10.backend/03.data-access-patterns.md — ORM patterns, repository injection, query optimization
|
|
62
|
+
- 10.backend/04.response-exception.md — Response interceptor, HttpException hierarchy, ExceptionFilter
|
|
63
|
+
- 10.backend/05.validation-dto.md — class-validator, class-transformer, mapped types, ValidationPipe
|
|
64
|
+
- 10.backend/06.guard-interceptor-pipe.md — Guards (auth/role), Interceptors (logging/cache/transform), Pipes (validation/parse)
|
|
65
|
+
- 10.backend/07.module-provider-patterns.md — @Module structure, dynamic modules (forRoot/forFeature), custom providers, global modules
|
|
66
66
|
- 30.security-db/01.security-auth.md — JWT, Passport, Guards, CORS, @nestjs/throttler
|
|
67
67
|
- 30.security-db/02.database-schema.md — Migrations, seeds, schema conventions
|
|
68
68
|
- 30.security-db/03.common-utilities.md — Custom decorators, shared providers, constants
|
|
69
69
|
- 40.infra/01.environment-config.md — @nestjs/config, ConfigModule, environment validation
|
|
70
70
|
- 40.infra/02.logging-monitoring.md — NestJS Logger/pino, LoggingInterceptor, health checks
|
|
71
71
|
- 40.infra/03.cicd-deployment.md — CI/CD pipeline, deployment strategy
|
|
72
|
-
-
|
|
73
|
-
-
|
|
72
|
+
- 80.verification/01.development-verification.md — Build, startup, API testing
|
|
73
|
+
- 80.verification/02.testing-strategy.md — Test.createTestingModule, mocking, E2E
|
|
74
74
|
|
|
75
75
|
Each file MUST include:
|
|
76
76
|
- Correct examples (✅ code blocks)
|
|
@@ -84,7 +84,7 @@ Generation targets:
|
|
|
84
84
|
- Each rule file MUST end with a `## Reference` section linking to the corresponding standard file(s):
|
|
85
85
|
```
|
|
86
86
|
## Reference
|
|
87
|
-
> For detailed patterns and examples, Read: claudeos-core/standard/10.backend
|
|
87
|
+
> For detailed patterns and examples, Read: claudeos-core/standard/10.backend/01.controller-patterns.md
|
|
88
88
|
```
|
|
89
89
|
- `paths:` frontmatter per rule category:
|
|
90
90
|
- `00.core/*` rules: `paths: ["**/*"]`
|
|
@@ -95,6 +95,7 @@ Generation targets:
|
|
|
95
95
|
- `40.infra/03.cicd-deployment-rules.md` paths: `["**/*.yml", "**/*.yaml", "**/Dockerfile*", "**/*.ts"]` — CI config + source
|
|
96
96
|
- `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]`
|
|
97
97
|
- `60.memory/*` rules: forward reference — Pass 4 will generate 4 files (01.decision-log, 02.failure-patterns, 03.compaction, 04.auto-rule-update), each with file-specific `paths`. Pass 3 must STILL list ```.claude/rules/60.memory/*``` as a row in CLAUDE.md Section 6 Rules table so developers/Claude see the category exists.
|
|
98
|
+
- `70.domains/*` rules (multi-domain projects only): per-domain rules at `.claude/rules/70.domains/{type}/{domain}-rules.md` (where `{type}` is `backend` or `frontend`, ALWAYS present even in single-stack projects for uniform layout + zero-migration future-proofing), each with a `paths:` glob scoped to that domain's source directories so the rule auto-loads only when editing files within the relevant domain. Folder name is PLURAL (`domains/`) — collection of N per-domain files — and each file inside uses the SINGULAR domain name (`{domain}-rules.md`). DO NOT use `60.domains/` (collides with `60.memory/`) and DO NOT skip the `{type}/` sub-folder. See pass3-footer.md "Per-domain folder convention" for the full rationale.
|
|
98
99
|
- MUST generate `.claude/rules/00.core/00.standard-reference.md` — directory of all standard files.
|
|
99
100
|
List only the standard files that were actually generated above.
|
|
100
101
|
|
|
@@ -59,18 +59,18 @@ Generation targets:
|
|
|
59
59
|
- 00.core/01.project-overview.md — Stack, routing approach, deployment environment
|
|
60
60
|
- 00.core/02.architecture.md — App Router structure, component hierarchy, data flow
|
|
61
61
|
- 00.core/03.naming-conventions.md — File/component/hook/type naming conventions
|
|
62
|
-
- 20.frontend
|
|
63
|
-
- 20.frontend
|
|
64
|
-
- 20.frontend
|
|
65
|
-
- 20.frontend
|
|
66
|
-
- 20.frontend
|
|
67
|
-
- 10.backend
|
|
62
|
+
- 20.frontend/01.component-patterns.md — Component writing rules, Props patterns, reuse
|
|
63
|
+
- 20.frontend/02.page-routing-patterns.md — Pages/layouts/dynamic routes/middleware
|
|
64
|
+
- 20.frontend/03.data-fetching.md — RSC, Server Actions, TanStack Query, caching
|
|
65
|
+
- 20.frontend/04.state-management.md — Global/server/URL/form state management
|
|
66
|
+
- 20.frontend/05.styling-patterns.md — Styling rules, theming, responsive, accessibility
|
|
67
|
+
- 10.backend/01.api-routes.md — Route Handlers, Server Actions patterns
|
|
68
68
|
- 30.security-db/01.security-auth.md — NextAuth, middleware, environment variables, CSP
|
|
69
69
|
- 40.infra/01.environment-config.md — Environment variables, next.config, build optimization
|
|
70
70
|
- 40.infra/02.logging-monitoring.md — Error tracking, analytics tools, Web Vitals
|
|
71
71
|
- 40.infra/03.cicd-deployment.md — CI/CD, Vercel/Docker deployment, preview
|
|
72
|
-
-
|
|
73
|
-
-
|
|
72
|
+
- 80.verification/01.development-verification.md — Build, startup, Lighthouse
|
|
73
|
+
- 80.verification/02.testing-strategy.md — Testing strategy, RTL, E2E, Storybook
|
|
74
74
|
|
|
75
75
|
Each file MUST include:
|
|
76
76
|
- Correct examples (✅ code blocks)
|
|
@@ -84,7 +84,7 @@ Generation targets:
|
|
|
84
84
|
- Each rule file MUST end with a `## Reference` section linking to the corresponding standard file(s):
|
|
85
85
|
```
|
|
86
86
|
## Reference
|
|
87
|
-
> For detailed patterns and examples, Read: claudeos-core/standard/20.frontend
|
|
87
|
+
> For detailed patterns and examples, Read: claudeos-core/standard/20.frontend/01.component-patterns.md
|
|
88
88
|
```
|
|
89
89
|
- `paths:` frontmatter per rule category:
|
|
90
90
|
- `00.core/*` rules: `paths: ["**/*"]` — always loaded (architecture, naming are universally needed)
|
|
@@ -96,6 +96,7 @@ Generation targets:
|
|
|
96
96
|
- `40.infra/03.cicd-deployment-rules.md` paths: `["**/*.yml", "**/*.yaml", "**/Dockerfile*", "**/*.ts", "**/*.tsx"]` — CI config + source
|
|
97
97
|
- `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]` — loaded only when editing claudeos-core files
|
|
98
98
|
- `60.memory/*` rules: forward reference — Pass 4 will generate 4 files (01.decision-log, 02.failure-patterns, 03.compaction, 04.auto-rule-update), each with file-specific `paths`. Pass 3 must STILL list ```.claude/rules/60.memory/*``` as a row in CLAUDE.md Section 6 Rules table so developers/Claude see the category exists.
|
|
99
|
+
- `70.domains/*` rules (multi-domain projects only): per-domain rules at `.claude/rules/70.domains/{type}/{domain}-rules.md` (where `{type}` is `backend` or `frontend`, ALWAYS present even in single-stack projects for uniform layout + zero-migration future-proofing), each with a `paths:` glob scoped to that domain's source directories so the rule auto-loads only when editing files within the relevant domain. Folder name is PLURAL (`domains/`) — collection of N per-domain files — and each file inside uses the SINGULAR domain name (`{domain}-rules.md`). DO NOT use `60.domains/` (collides with `60.memory/`) and DO NOT skip the `{type}/` sub-folder. See pass3-footer.md "Per-domain folder convention" for the full rationale.
|
|
99
100
|
- MUST generate `.claude/rules/00.core/00.standard-reference.md` — a directory of all standard files. This is NOT a "read all" instruction. Claude should Read ONLY the standards relevant to the current task. Structure it as:
|
|
100
101
|
```
|
|
101
102
|
---
|
|
@@ -112,21 +113,21 @@ Generation targets:
|
|
|
112
113
|
- claudeos-core/standard/00.core/03.naming-conventions.md
|
|
113
114
|
- claudeos-core/standard/00.core/04.doc-writing-guide.md
|
|
114
115
|
## Frontend UI
|
|
115
|
-
- claudeos-core/standard/20.frontend
|
|
116
|
-
- claudeos-core/standard/20.frontend
|
|
117
|
-
- claudeos-core/standard/20.frontend
|
|
118
|
-
- claudeos-core/standard/20.frontend
|
|
119
|
-
- claudeos-core/standard/20.frontend
|
|
116
|
+
- claudeos-core/standard/20.frontend/01.component-patterns.md
|
|
117
|
+
- claudeos-core/standard/20.frontend/02.page-routing-patterns.md
|
|
118
|
+
- claudeos-core/standard/20.frontend/03.data-fetching.md
|
|
119
|
+
- claudeos-core/standard/20.frontend/04.state-management.md
|
|
120
|
+
- claudeos-core/standard/20.frontend/05.styling-patterns.md
|
|
120
121
|
## Backend API
|
|
121
|
-
- claudeos-core/standard/10.backend
|
|
122
|
+
- claudeos-core/standard/10.backend/01.api-routes.md
|
|
122
123
|
## Security & DB
|
|
123
124
|
- claudeos-core/standard/30.security-db/01.security-auth.md
|
|
124
125
|
## Infra & Verification
|
|
125
126
|
- claudeos-core/standard/40.infra/01.environment-config.md
|
|
126
127
|
- claudeos-core/standard/40.infra/02.logging-monitoring.md
|
|
127
128
|
- claudeos-core/standard/40.infra/03.cicd-deployment.md
|
|
128
|
-
- claudeos-core/standard/
|
|
129
|
-
- claudeos-core/standard/
|
|
129
|
+
- claudeos-core/standard/80.verification/01.development-verification.md
|
|
130
|
+
- claudeos-core/standard/80.verification/02.testing-strategy.md
|
|
130
131
|
```
|
|
131
132
|
List only the standard files that were actually generated above. NOTE: `00.core/04.doc-writing-guide.md` is a FORWARD REFERENCE — Pass 4 will generate it; include it anyway. Do NOT add a "DO NOT Read" section here — that information lives in CLAUDE.md Section 7 (the single source of truth).
|
|
132
133
|
|
|
@@ -46,21 +46,21 @@ Generation targets:
|
|
|
46
46
|
- 00.core/01.project-overview.md — Stack, routing approach, deployment environment
|
|
47
47
|
- 00.core/02.architecture.md — SPA structure, component hierarchy, data flow
|
|
48
48
|
- 00.core/03.naming-conventions.md — File/component/hook/type naming conventions
|
|
49
|
-
- 20.frontend
|
|
50
|
-
- 20.frontend
|
|
51
|
-
- 20.frontend
|
|
52
|
-
- 20.frontend
|
|
53
|
-
- 20.frontend
|
|
49
|
+
- 20.frontend/01.component-patterns.md — Component writing rules, Props patterns, reuse
|
|
50
|
+
- 20.frontend/02.page-routing-patterns.md — Client-side routing, layouts, route guards, lazy loading
|
|
51
|
+
- 20.frontend/03.data-fetching.md — API client, TanStack Query/SWR, caching, error handling
|
|
52
|
+
- 20.frontend/04.state-management.md — Global/server/URL/form state management
|
|
53
|
+
- 20.frontend/05.styling-patterns.md — Styling rules, theming, responsive, accessibility
|
|
54
54
|
- 30.security-db/01.security-auth.md — Auth patterns, token management, route protection, environment variables
|
|
55
55
|
- 40.infra/01.environment-config.md — Environment variables (VITE_ prefix), vite.config, build optimization
|
|
56
56
|
- 40.infra/02.logging-monitoring.md — Error tracking, analytics tools, performance monitoring
|
|
57
57
|
- 40.infra/03.cicd-deployment.md — CI/CD, static hosting deployment (Nginx, S3, Vercel, Netlify)
|
|
58
|
-
-
|
|
59
|
-
-
|
|
58
|
+
- 80.verification/01.development-verification.md — Build, startup, dev server
|
|
59
|
+
- 80.verification/02.testing-strategy.md — Testing strategy (Vitest, RTL, E2E, Storybook)
|
|
60
60
|
|
|
61
61
|
Each file MUST include:
|
|
62
|
-
- Correct examples (code blocks)
|
|
63
|
-
- Incorrect examples (code blocks)
|
|
62
|
+
- Correct examples (✅ code blocks)
|
|
63
|
+
- Incorrect examples (❌ code blocks)
|
|
64
64
|
- Key rules summary table
|
|
65
65
|
|
|
66
66
|
3. .claude/rules/ (active domains only)
|
|
@@ -70,7 +70,7 @@ Generation targets:
|
|
|
70
70
|
- Each rule file MUST end with a `## Reference` section linking to the corresponding standard file(s):
|
|
71
71
|
```
|
|
72
72
|
## Reference
|
|
73
|
-
> For detailed patterns and examples, Read: claudeos-core/standard/20.frontend
|
|
73
|
+
> For detailed patterns and examples, Read: claudeos-core/standard/20.frontend/01.component-patterns.md
|
|
74
74
|
```
|
|
75
75
|
- `paths:` frontmatter per rule category:
|
|
76
76
|
- `00.core/*` rules: `paths: ["**/*"]`
|
|
@@ -81,6 +81,7 @@ Generation targets:
|
|
|
81
81
|
- `40.infra/03.cicd-deployment-rules.md` paths: `["**/*.yml", "**/*.yaml", "**/Dockerfile*", "**/*.ts", "**/*.tsx"]` — CI config + source with API origin / codegen references
|
|
82
82
|
- `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]`
|
|
83
83
|
- `60.memory/*` rules: forward reference — Pass 4 will generate 4 files (01.decision-log, 02.failure-patterns, 03.compaction, 04.auto-rule-update), each with file-specific `paths`. Pass 3 must STILL list ```.claude/rules/60.memory/*``` as a row in CLAUDE.md Section 6 Rules table so developers/Claude see the category exists.
|
|
84
|
+
- `70.domains/*` rules (multi-domain projects only): per-domain rules at `.claude/rules/70.domains/{type}/{domain}-rules.md` (where `{type}` is `backend` or `frontend`, ALWAYS present even in single-stack projects for uniform layout + zero-migration future-proofing), each with a `paths:` glob scoped to that domain's source directories so the rule auto-loads only when editing files within the relevant domain. Folder name is PLURAL (`domains/`) — collection of N per-domain files — and each file inside uses the SINGULAR domain name (`{domain}-rules.md`). DO NOT use `60.domains/` (collides with `60.memory/`) and DO NOT skip the `{type}/` sub-folder. See pass3-footer.md "Per-domain folder convention" for the full rationale.
|
|
84
85
|
- MUST generate `.claude/rules/00.core/00.standard-reference.md` — directory of all standard files.
|
|
85
86
|
|
|
86
87
|
4. .claude/rules/50.sync/ (2 sync rules)
|
|
@@ -56,20 +56,20 @@ Generation targets:
|
|
|
56
56
|
- 00.core/01.project-overview.md — Stack, app list, server info
|
|
57
57
|
- 00.core/02.architecture.md — MTV structure, request flow, app structure
|
|
58
58
|
- 00.core/03.naming-conventions.md — App/model/view/serializer naming conventions
|
|
59
|
-
- 10.backend
|
|
60
|
-
- 10.backend
|
|
61
|
-
- 10.backend
|
|
62
|
-
- 10.backend
|
|
63
|
-
- 10.backend
|
|
64
|
-
- 10.backend
|
|
59
|
+
- 10.backend/01.view-patterns.md — FBV/CBV/ViewSet patterns + examples
|
|
60
|
+
- 10.backend/02.serializer-patterns.md — Serializer writing rules + validation
|
|
61
|
+
- 10.backend/03.model-patterns.md — Model structure, Manager, Signal, QuerySet
|
|
62
|
+
- 10.backend/04.response-exception.md — Response/error handling patterns
|
|
63
|
+
- 10.backend/05.business-logic.md — Service Layer, transactions, Celery
|
|
64
|
+
- 10.backend/06.admin-patterns.md — Admin customization, Inline, actions
|
|
65
65
|
- 30.security-db/01.security-auth.md — JWT, Permission, CORS, CSRF
|
|
66
66
|
- 30.security-db/02.database-schema.md — Migrations, fixtures, schema conventions
|
|
67
67
|
- 30.security-db/03.common-utilities.md — Common utils, custom Manager, constants
|
|
68
68
|
- 40.infra/01.environment-config.md — Settings separation, environment variables
|
|
69
69
|
- 40.infra/02.logging-monitoring.md — Logging standards, monitoring
|
|
70
70
|
- 40.infra/03.cicd-deployment.md — CI/CD, Docker, deployment strategy
|
|
71
|
-
-
|
|
72
|
-
-
|
|
71
|
+
- 80.verification/01.development-verification.md — Testing, startup, API testing
|
|
72
|
+
- 80.verification/02.testing-strategy.md — pytest, Factory, mocking, coverage
|
|
73
73
|
|
|
74
74
|
Each file MUST include:
|
|
75
75
|
- Correct examples (✅ code blocks)
|
|
@@ -83,7 +83,7 @@ Generation targets:
|
|
|
83
83
|
- Each rule file MUST end with a `## Reference` section linking to the corresponding standard file(s):
|
|
84
84
|
```
|
|
85
85
|
## Reference
|
|
86
|
-
> For detailed patterns and examples, Read: claudeos-core/standard/10.backend
|
|
86
|
+
> For detailed patterns and examples, Read: claudeos-core/standard/10.backend/01.view-patterns.md
|
|
87
87
|
```
|
|
88
88
|
- `paths:` frontmatter per rule category:
|
|
89
89
|
- `00.core/*` rules: `paths: ["**/*"]` — always loaded (architecture, naming are universally needed)
|
|
@@ -94,6 +94,7 @@ Generation targets:
|
|
|
94
94
|
- `40.infra/03.cicd-deployment-rules.md` paths: `["**/*.yml", "**/*.yaml", "**/Dockerfile*", "**/*.py"]` — CI / deploy config + source
|
|
95
95
|
- `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]` — loaded only when editing claudeos-core files
|
|
96
96
|
- `60.memory/*` rules: forward reference — Pass 4 will generate 4 files (01.decision-log, 02.failure-patterns, 03.compaction, 04.auto-rule-update), each with file-specific `paths`. Pass 3 must STILL list ```.claude/rules/60.memory/*``` as a row in CLAUDE.md Section 6 Rules table so developers/Claude see the category exists.
|
|
97
|
+
- `70.domains/*` rules (multi-domain projects only): per-domain rules at `.claude/rules/70.domains/{type}/{domain}-rules.md` (where `{type}` is `backend` or `frontend`, ALWAYS present even in single-stack projects for uniform layout + zero-migration future-proofing), each with a `paths:` glob scoped to that domain's source directories so the rule auto-loads only when editing files within the relevant domain. Folder name is PLURAL (`domains/`) — collection of N per-domain files — and each file inside uses the SINGULAR domain name (`{domain}-rules.md`). DO NOT use `60.domains/` (collides with `60.memory/`) and DO NOT skip the `{type}/` sub-folder. See pass3-footer.md "Per-domain folder convention" for the full rationale.
|
|
97
98
|
- MUST generate `.claude/rules/00.core/00.standard-reference.md` — a directory of all standard files. This is NOT a "read all" instruction. Claude should Read ONLY the standards relevant to the current task. Structure it as:
|
|
98
99
|
```
|
|
99
100
|
---
|
|
@@ -110,12 +111,12 @@ Generation targets:
|
|
|
110
111
|
- claudeos-core/standard/00.core/03.naming-conventions.md
|
|
111
112
|
- claudeos-core/standard/00.core/04.doc-writing-guide.md
|
|
112
113
|
## Backend API
|
|
113
|
-
- claudeos-core/standard/10.backend
|
|
114
|
-
- claudeos-core/standard/10.backend
|
|
115
|
-
- claudeos-core/standard/10.backend
|
|
116
|
-
- claudeos-core/standard/10.backend
|
|
117
|
-
- claudeos-core/standard/10.backend
|
|
118
|
-
- claudeos-core/standard/10.backend
|
|
114
|
+
- claudeos-core/standard/10.backend/01.view-patterns.md
|
|
115
|
+
- claudeos-core/standard/10.backend/02.serializer-patterns.md
|
|
116
|
+
- claudeos-core/standard/10.backend/03.model-patterns.md
|
|
117
|
+
- claudeos-core/standard/10.backend/04.response-exception.md
|
|
118
|
+
- claudeos-core/standard/10.backend/05.business-logic.md
|
|
119
|
+
- claudeos-core/standard/10.backend/06.admin-patterns.md
|
|
119
120
|
## Security & DB
|
|
120
121
|
- claudeos-core/standard/30.security-db/01.security-auth.md
|
|
121
122
|
- claudeos-core/standard/30.security-db/02.database-schema.md
|
|
@@ -124,8 +125,8 @@ Generation targets:
|
|
|
124
125
|
- claudeos-core/standard/40.infra/01.environment-config.md
|
|
125
126
|
- claudeos-core/standard/40.infra/02.logging-monitoring.md
|
|
126
127
|
- claudeos-core/standard/40.infra/03.cicd-deployment.md
|
|
127
|
-
- claudeos-core/standard/
|
|
128
|
-
- claudeos-core/standard/
|
|
128
|
+
- claudeos-core/standard/80.verification/01.development-verification.md
|
|
129
|
+
- claudeos-core/standard/80.verification/02.testing-strategy.md
|
|
129
130
|
```
|
|
130
131
|
List only the standard files that were actually generated above. NOTE: `00.core/04.doc-writing-guide.md` is a FORWARD REFERENCE — Pass 4 will generate it; include it anyway. Do NOT add a "DO NOT Read" section here — that information lives in CLAUDE.md Section 7 (the single source of truth).
|
|
131
132
|
|
|
@@ -57,20 +57,20 @@ Generation targets:
|
|
|
57
57
|
- 00.core/01.project-overview.md — Stack, modules, server info
|
|
58
58
|
- 00.core/02.architecture.md — Layer structure, request flow, directory structure
|
|
59
59
|
- 00.core/03.naming-conventions.md — Module/schema/model/router naming conventions
|
|
60
|
-
- 10.backend
|
|
61
|
-
- 10.backend
|
|
62
|
-
- 10.backend
|
|
63
|
-
- 10.backend
|
|
64
|
-
- 10.backend
|
|
65
|
-
- 10.backend
|
|
60
|
+
- 10.backend/01.router-endpoint-patterns.md — Router patterns + decorators
|
|
61
|
+
- 10.backend/02.schema-pydantic-patterns.md — Pydantic conventions, validation
|
|
62
|
+
- 10.backend/03.data-access-patterns.md — ORM, Repository, query optimization
|
|
63
|
+
- 10.backend/04.response-exception.md — Response/error handling patterns
|
|
64
|
+
- 10.backend/05.dependency-injection.md — Depends chain, lifecycle
|
|
65
|
+
- 10.backend/06.middleware-patterns.md — CORS, custom middleware, order
|
|
66
66
|
- 30.security-db/01.security-auth.md — JWT, OAuth2, CORS, Rate Limit
|
|
67
67
|
- 30.security-db/02.database-schema.md — Alembic, schema conventions
|
|
68
68
|
- 30.security-db/03.common-utilities.md — Common utils, dependency functions, constants
|
|
69
69
|
- 40.infra/01.environment-config.md — pydantic-settings, environment variables
|
|
70
70
|
- 40.infra/02.logging-monitoring.md — Logging standards, monitoring
|
|
71
71
|
- 40.infra/03.cicd-deployment.md — CI/CD, Docker, uvicorn deployment
|
|
72
|
-
-
|
|
73
|
-
-
|
|
72
|
+
- 80.verification/01.development-verification.md — pytest, startup, API testing
|
|
73
|
+
- 80.verification/02.testing-strategy.md — Async testing, dependency overrides, mocking
|
|
74
74
|
|
|
75
75
|
Each file MUST include:
|
|
76
76
|
- Correct examples (✅ code blocks)
|
|
@@ -84,7 +84,7 @@ Generation targets:
|
|
|
84
84
|
- Each rule file MUST end with a `## Reference` section linking to the corresponding standard file(s):
|
|
85
85
|
```
|
|
86
86
|
## Reference
|
|
87
|
-
> For detailed patterns and examples, Read: claudeos-core/standard/10.backend
|
|
87
|
+
> For detailed patterns and examples, Read: claudeos-core/standard/10.backend/01.router-endpoint-patterns.md
|
|
88
88
|
```
|
|
89
89
|
- `paths:` frontmatter per rule category:
|
|
90
90
|
- `00.core/*` rules: `paths: ["**/*"]` — always loaded (architecture, naming are universally needed)
|
|
@@ -95,6 +95,7 @@ Generation targets:
|
|
|
95
95
|
- `40.infra/03.cicd-deployment-rules.md` paths: `["**/*.yml", "**/*.yaml", "**/Dockerfile*", "**/*.py"]` — CI / deploy config + source
|
|
96
96
|
- `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]` — loaded only when editing claudeos-core files
|
|
97
97
|
- `60.memory/*` rules: forward reference — Pass 4 will generate 4 files (01.decision-log, 02.failure-patterns, 03.compaction, 04.auto-rule-update), each with file-specific `paths`. Pass 3 must STILL list ```.claude/rules/60.memory/*``` as a row in CLAUDE.md Section 6 Rules table so developers/Claude see the category exists.
|
|
98
|
+
- `70.domains/*` rules (multi-domain projects only): per-domain rules at `.claude/rules/70.domains/{type}/{domain}-rules.md` (where `{type}` is `backend` or `frontend`, ALWAYS present even in single-stack projects for uniform layout + zero-migration future-proofing), each with a `paths:` glob scoped to that domain's source directories so the rule auto-loads only when editing files within the relevant domain. Folder name is PLURAL (`domains/`) — collection of N per-domain files — and each file inside uses the SINGULAR domain name (`{domain}-rules.md`). DO NOT use `60.domains/` (collides with `60.memory/`) and DO NOT skip the `{type}/` sub-folder. See pass3-footer.md "Per-domain folder convention" for the full rationale.
|
|
98
99
|
- MUST generate `.claude/rules/00.core/00.standard-reference.md` — a directory of all standard files. This is NOT a "read all" instruction. Claude should Read ONLY the standards relevant to the current task. Structure it as:
|
|
99
100
|
```
|
|
100
101
|
---
|
|
@@ -111,12 +112,12 @@ Generation targets:
|
|
|
111
112
|
- claudeos-core/standard/00.core/03.naming-conventions.md
|
|
112
113
|
- claudeos-core/standard/00.core/04.doc-writing-guide.md
|
|
113
114
|
## Backend API
|
|
114
|
-
- claudeos-core/standard/10.backend
|
|
115
|
-
- claudeos-core/standard/10.backend
|
|
116
|
-
- claudeos-core/standard/10.backend
|
|
117
|
-
- claudeos-core/standard/10.backend
|
|
118
|
-
- claudeos-core/standard/10.backend
|
|
119
|
-
- claudeos-core/standard/10.backend
|
|
115
|
+
- claudeos-core/standard/10.backend/01.router-endpoint-patterns.md
|
|
116
|
+
- claudeos-core/standard/10.backend/02.schema-pydantic-patterns.md
|
|
117
|
+
- claudeos-core/standard/10.backend/03.data-access-patterns.md
|
|
118
|
+
- claudeos-core/standard/10.backend/04.response-exception.md
|
|
119
|
+
- claudeos-core/standard/10.backend/05.dependency-injection.md
|
|
120
|
+
- claudeos-core/standard/10.backend/06.middleware-patterns.md
|
|
120
121
|
## Security & DB
|
|
121
122
|
- claudeos-core/standard/30.security-db/01.security-auth.md
|
|
122
123
|
- claudeos-core/standard/30.security-db/02.database-schema.md
|
|
@@ -125,8 +126,8 @@ Generation targets:
|
|
|
125
126
|
- claudeos-core/standard/40.infra/01.environment-config.md
|
|
126
127
|
- claudeos-core/standard/40.infra/02.logging-monitoring.md
|
|
127
128
|
- claudeos-core/standard/40.infra/03.cicd-deployment.md
|
|
128
|
-
- claudeos-core/standard/
|
|
129
|
-
- claudeos-core/standard/
|
|
129
|
+
- claudeos-core/standard/80.verification/01.development-verification.md
|
|
130
|
+
- claudeos-core/standard/80.verification/02.testing-strategy.md
|
|
130
131
|
```
|
|
131
132
|
List only the standard files that were actually generated above. NOTE: `00.core/04.doc-writing-guide.md` is a FORWARD REFERENCE — Pass 4 will generate it; include it anyway. Do NOT add a "DO NOT Read" section here — that information lives in CLAUDE.md Section 7 (the single source of truth).
|
|
132
133
|
|
|
@@ -51,21 +51,21 @@ Generation targets:
|
|
|
51
51
|
- 00.core/01.project-overview.md — Stack, modules, server info
|
|
52
52
|
- 00.core/02.architecture.md — Application factory, Blueprint hierarchy, request flow
|
|
53
53
|
- 00.core/03.naming-conventions.md — Module/model/blueprint/route naming conventions
|
|
54
|
-
- 10.backend
|
|
55
|
-
- 10.backend
|
|
56
|
-
- 10.backend
|
|
57
|
-
- 10.backend
|
|
54
|
+
- 10.backend/01.route-blueprint-patterns.md — Blueprint structure, route decorators, request/response handling
|
|
55
|
+
- 10.backend/02.model-schema-patterns.md — SQLAlchemy models, marshmallow/WTForms serialization
|
|
56
|
+
- 10.backend/03.service-patterns.md — Service layer, business logic separation
|
|
57
|
+
- 10.backend/04.response-error-patterns.md — Response formatting, error handlers, custom exceptions
|
|
58
58
|
- 30.security-db/01.security-auth.md — Authentication, CSRF, session management, environment variables
|
|
59
59
|
- 30.security-db/02.database-patterns.md — SQLAlchemy patterns, migrations, relationships
|
|
60
60
|
- 40.infra/01.environment-config.md — Config classes, environment variables, extension initialization
|
|
61
61
|
- 40.infra/02.logging-monitoring.md — app.logger, request logging, error tracking
|
|
62
62
|
- 40.infra/03.cicd-deployment.md — CI/CD, gunicorn, Docker deployment
|
|
63
|
-
-
|
|
64
|
-
-
|
|
63
|
+
- 80.verification/01.development-verification.md — Build, startup, flask run
|
|
64
|
+
- 80.verification/02.testing-strategy.md — pytest, test_client, fixtures, DB testing
|
|
65
65
|
|
|
66
66
|
Each file MUST include:
|
|
67
|
-
- Correct examples (code blocks)
|
|
68
|
-
- Incorrect examples (code blocks)
|
|
67
|
+
- Correct examples (✅ code blocks)
|
|
68
|
+
- Incorrect examples (❌ code blocks)
|
|
69
69
|
- Key rules summary table
|
|
70
70
|
|
|
71
71
|
3. .claude/rules/ (active domains only)
|
|
@@ -82,6 +82,7 @@ Generation targets:
|
|
|
82
82
|
- `40.infra/03.cicd-deployment-rules.md` paths: `["**/*.yml", "**/*.yaml", "**/Dockerfile*", "**/*.py"]` — CI / deploy config + source
|
|
83
83
|
- `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]`
|
|
84
84
|
- `60.memory/*` rules: forward reference — Pass 4 will generate 4 files (01.decision-log, 02.failure-patterns, 03.compaction, 04.auto-rule-update), each with file-specific `paths`. Pass 3 must STILL list ```.claude/rules/60.memory/*``` as a row in CLAUDE.md Section 6 Rules table so developers/Claude see the category exists.
|
|
85
|
+
- `70.domains/*` rules (multi-domain projects only): per-domain rules at `.claude/rules/70.domains/{type}/{domain}-rules.md` (where `{type}` is `backend` or `frontend`, ALWAYS present even in single-stack projects for uniform layout + zero-migration future-proofing), each with a `paths:` glob scoped to that domain's source directories so the rule auto-loads only when editing files within the relevant domain. Folder name is PLURAL (`domains/`) — collection of N per-domain files — and each file inside uses the SINGULAR domain name (`{domain}-rules.md`). DO NOT use `60.domains/` (collides with `60.memory/`) and DO NOT skip the `{type}/` sub-folder. See pass3-footer.md "Per-domain folder convention" for the full rationale.
|
|
85
86
|
- MUST generate `.claude/rules/00.core/00.standard-reference.md` — directory of all standard files
|
|
86
87
|
|
|
87
88
|
4. .claude/rules/50.sync/ (2 sync rules)
|