claudeos-core 2.0.2 → 2.1.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 +208 -0
- package/README.de.md +961 -880
- package/README.es.md +960 -880
- package/README.fr.md +960 -880
- package/README.hi.md +960 -880
- package/README.ja.md +960 -880
- package/README.ko.md +126 -47
- package/README.md +126 -46
- package/README.ru.md +960 -880
- package/README.vi.md +128 -48
- package/README.zh-CN.md +959 -880
- package/bin/cli.js +7 -2
- package/bin/commands/init.js +733 -143
- package/bin/commands/memory.js +17 -5
- package/bootstrap.sh +81 -81
- package/lib/expected-outputs.js +6 -7
- package/lib/memory-scaffold.js +84 -46
- package/lib/plan-parser.js +12 -0
- package/manifest-generator/index.js +16 -18
- package/package.json +1 -1
- package/pass-prompts/templates/angular/pass3.md +2 -10
- package/pass-prompts/templates/common/pass3-phase1.md +131 -0
- package/pass-prompts/templates/common/pass3a-facts.md +143 -0
- package/pass-prompts/templates/common/pass3b-core-header.md +58 -0
- package/pass-prompts/templates/common/pass3c-skills-guide-header.md +53 -0
- package/pass-prompts/templates/common/pass3d-plan-aux-header.md +57 -0
- package/pass-prompts/templates/common/pass4.md +4 -19
- package/pass-prompts/templates/java-spring/pass3.md +5 -15
- package/pass-prompts/templates/kotlin-spring/pass3.md +5 -15
- package/pass-prompts/templates/node-express/pass3.md +5 -14
- package/pass-prompts/templates/node-fastify/pass3.md +2 -10
- package/pass-prompts/templates/node-nestjs/pass3.md +5 -13
- package/pass-prompts/templates/node-nextjs/pass3.md +5 -14
- package/pass-prompts/templates/node-vite/pass3.md +95 -103
- package/pass-prompts/templates/python-django/pass3.md +5 -14
- package/pass-prompts/templates/python-fastapi/pass3.md +5 -14
- package/pass-prompts/templates/python-flask/pass3.md +95 -103
- package/pass-prompts/templates/vue-nuxt/pass3.md +2 -10
- package/plan-installer/pass3-context-builder.js +258 -0
- package/plan-installer/prompt-generator.js +9 -1
- package/plan-validator/index.js +23 -8
- package/sync-checker/index.js +44 -0
|
@@ -86,9 +86,9 @@ Generation targets:
|
|
|
86
86
|
List only the standard files that were actually generated above.
|
|
87
87
|
|
|
88
88
|
4. .claude/rules/50.sync/ (3 sync rules)
|
|
89
|
-
- 01.standard-sync.md — Remind AI to update
|
|
90
|
-
- 02.rules-sync.md — Remind AI to update
|
|
91
|
-
- 03.skills-sync.md — Remind AI to update
|
|
89
|
+
- 01.standard-sync.md — Remind AI to update corresponding rule when standard is modified
|
|
90
|
+
- 02.rules-sync.md — Remind AI to update corresponding standard when rules are modified
|
|
91
|
+
- 03.skills-sync.md — Remind AI to update MANIFEST.md when skills are modified
|
|
92
92
|
|
|
93
93
|
5. claudeos-core/skills/ (active domains only)
|
|
94
94
|
- 10.backend-crud/01.scaffold-crud-feature.md (orchestrator)
|
|
@@ -105,17 +105,9 @@ Generation targets:
|
|
|
105
105
|
- 03.troubleshooting/01.troubleshooting.md
|
|
106
106
|
- 04.architecture/01.file-map.md
|
|
107
107
|
- 04.architecture/02.pros-and-cons.md
|
|
108
|
-
|
|
109
|
-
7. claudeos-core/plan/ (Master Plan)
|
|
110
|
-
- 10.standard-master.md — CLAUDE.md + all standard/ files as <file> blocks
|
|
111
|
-
- 20.rules-master.md — All rules/ (except sync) as <file> blocks
|
|
112
|
-
- 21.sync-rules-master.md — All sync rules (code block format)
|
|
113
|
-
- 30.backend-skills-master.md — All backend skills as <file> blocks
|
|
114
|
-
- 40.guides-master.md — All guide/ files as <file> blocks
|
|
115
|
-
|
|
116
|
-
8. claudeos-core/database/
|
|
108
|
+
7. claudeos-core/database/
|
|
117
109
|
- 01.schema-overview.md — Table/collection list, relationship description
|
|
118
110
|
- 02.migration-guide.md — Migration procedure, rollback methods
|
|
119
111
|
|
|
120
|
-
|
|
112
|
+
8. claudeos-core/mcp-guide/
|
|
121
113
|
- 01.mcp-overview.md — List of MCP servers in use, integration methods
|
|
@@ -113,7 +113,6 @@ Generation targets:
|
|
|
113
113
|
- claudeos-core/standard/50.verification/01.development-verification.md
|
|
114
114
|
- claudeos-core/standard/50.verification/02.testing-strategy.md
|
|
115
115
|
## DO NOT Read (context waste)
|
|
116
|
-
- claudeos-core/plan/ — Master Plan backup files. Never read during coding.
|
|
117
116
|
- claudeos-core/generated/ — Build metadata. Not for coding reference.
|
|
118
117
|
- claudeos-core/guide/ — Onboarding/usage guides for humans. Not for coding reference.
|
|
119
118
|
- claudeos-core/mcp-guide/ — MCP server integration docs. Not for coding reference.
|
|
@@ -122,9 +121,9 @@ Generation targets:
|
|
|
122
121
|
|
|
123
122
|
4. .claude/rules/50.sync/ (3 sync rules — AI fallback reminders)
|
|
124
123
|
- NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
|
|
125
|
-
- 01.standard-sync.md — Remind AI to update
|
|
126
|
-
- 02.rules-sync.md — Remind AI to update
|
|
127
|
-
- 03.skills-sync.md — Remind AI to update
|
|
124
|
+
- 01.standard-sync.md — Remind AI to update corresponding rule when standard is modified
|
|
125
|
+
- 02.rules-sync.md — Remind AI to update corresponding standard when rules are modified
|
|
126
|
+
- 03.skills-sync.md — Remind AI to update MANIFEST.md when skills are modified
|
|
128
127
|
|
|
129
128
|
5. claudeos-core/skills/ (active domains only)
|
|
130
129
|
- 20.frontend-page/01.scaffold-page-feature.md (orchestrator)
|
|
@@ -141,16 +140,8 @@ Generation targets:
|
|
|
141
140
|
- 03.troubleshooting/01.troubleshooting.md
|
|
142
141
|
- 04.architecture/01.file-map.md
|
|
143
142
|
- 04.architecture/02.pros-and-cons.md
|
|
144
|
-
|
|
145
|
-
7. claudeos-core/plan/ (Master Plan)
|
|
146
|
-
- 10.standard-master.md — CLAUDE.md + all standard/ files as <file> blocks
|
|
147
|
-
- 20.rules-master.md — All rules/ (except sync) as <file> blocks
|
|
148
|
-
- 21.sync-rules-master.md — All sync rules (code block format)
|
|
149
|
-
- 30.frontend-skills-master.md — All frontend skills as <file> blocks
|
|
150
|
-
- 40.guides-master.md — All guide/ files as <file> blocks
|
|
151
|
-
|
|
152
|
-
8. claudeos-core/database/
|
|
143
|
+
7. claudeos-core/database/
|
|
153
144
|
- 01.schema-overview.md — DB schema description (if applicable)
|
|
154
145
|
|
|
155
|
-
|
|
146
|
+
8. claudeos-core/mcp-guide/
|
|
156
147
|
- 01.mcp-overview.md — List of MCP servers in use, integration methods
|
|
@@ -1,103 +1,95 @@
|
|
|
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
|
-
CRITICAL — Package Manager Consistency:
|
|
8
|
-
Check `stack.packageManager` in project-analysis.json (e.g., "pnpm", "yarn", "npm").
|
|
9
|
-
ALL generated files MUST use ONLY that detected package manager's commands.
|
|
10
|
-
NEVER mix npm/yarn/pnpm commands. Also check `scripts` field in the project's package.json
|
|
11
|
-
for actual script names.
|
|
12
|
-
|
|
13
|
-
CRITICAL — Cross-file Consistency:
|
|
14
|
-
Rules (.claude/rules/) and Standards (claudeos-core/standard/) MUST NOT contradict each other.
|
|
15
|
-
|
|
16
|
-
CRITICAL — Code Example Accuracy:
|
|
17
|
-
ALL code examples in rules and standards MUST use EXACT method names, class names,
|
|
18
|
-
and signatures from pass2-merged.json analysis data.
|
|
19
|
-
Do NOT paraphrase, rename, or infer API names.
|
|
20
|
-
|
|
21
|
-
CRITICAL — CLAUDE.md Reference Table Completeness:
|
|
22
|
-
The reference table in CLAUDE.md MUST list ALL generated standard files.
|
|
23
|
-
|
|
24
|
-
Generation targets:
|
|
25
|
-
|
|
26
|
-
1. CLAUDE.md (project root)
|
|
27
|
-
- Role definition (based on detected stack — Vite + React SPA)
|
|
28
|
-
- Build & Run Commands (use ONLY the detected packageManager)
|
|
29
|
-
- Core architecture diagram (client-side SPA, routing, state management)
|
|
30
|
-
- Directory structure description
|
|
31
|
-
- Standard/Skills/Guide reference table
|
|
32
|
-
|
|
33
|
-
2. claudeos-core/standard/ (active domains only)
|
|
34
|
-
- 00.core/01.project-overview.md — Stack, routing approach, deployment environment
|
|
35
|
-
- 00.core/02.architecture.md — SPA structure, component hierarchy, data flow
|
|
36
|
-
- 00.core/03.naming-conventions.md — File/component/hook/type naming conventions
|
|
37
|
-
- 20.frontend-ui/01.component-patterns.md — Component writing rules, Props patterns, reuse
|
|
38
|
-
- 20.frontend-ui/02.page-routing-patterns.md — Client-side routing, layouts, route guards, lazy loading
|
|
39
|
-
- 20.frontend-ui/03.data-fetching.md — API client, TanStack Query/SWR, caching, error handling
|
|
40
|
-
- 20.frontend-ui/04.state-management.md — Global/server/URL/form state management
|
|
41
|
-
- 20.frontend-ui/05.styling-patterns.md — Styling rules, theming, responsive, accessibility
|
|
42
|
-
- 30.security-db/01.security-auth.md — Auth patterns, token management, route protection, environment variables
|
|
43
|
-
- 40.infra/01.environment-config.md — Environment variables (VITE_ prefix), vite.config, build optimization
|
|
44
|
-
- 40.infra/02.logging-monitoring.md — Error tracking, analytics tools, performance monitoring
|
|
45
|
-
- 40.infra/03.cicd-deployment.md — CI/CD, static hosting deployment (Nginx, S3, Vercel, Netlify)
|
|
46
|
-
- 50.verification/01.development-verification.md — Build, startup, dev server
|
|
47
|
-
- 50.verification/02.testing-strategy.md — Testing strategy (Vitest, RTL, E2E, Storybook)
|
|
48
|
-
|
|
49
|
-
Each file MUST include:
|
|
50
|
-
- Correct examples (code blocks)
|
|
51
|
-
- Incorrect examples (code blocks)
|
|
52
|
-
- Key rules summary table
|
|
53
|
-
|
|
54
|
-
3. .claude/rules/ (active domains only)
|
|
55
|
-
- Write the full rule content directly in each file (self-contained, no external references)
|
|
56
|
-
- Include 5-15 lines of key rules with concrete examples
|
|
57
|
-
- Do NOT use @import — it is not a Claude Code feature and does not work
|
|
58
|
-
- Each rule file MUST end with a `## Reference` section linking to the corresponding standard file(s):
|
|
59
|
-
```
|
|
60
|
-
## Reference
|
|
61
|
-
> For detailed patterns and examples, Read: claudeos-core/standard/20.frontend-ui/01.component-patterns.md
|
|
62
|
-
```
|
|
63
|
-
- `paths:` frontmatter per rule category:
|
|
64
|
-
- `00.core/*` rules: `paths: ["**/*"]`
|
|
65
|
-
- `20.frontend/*` rules: `paths: ["**/*"]`
|
|
66
|
-
- `30.security-db/*` rules: `paths: ["**/*"]`
|
|
67
|
-
- `40.infra/*` rules: `paths: ["**/*.json", "**/*.env*", "**/vite.config.*", "**/Dockerfile*", "**/*.yml", "**/*.yaml"]`
|
|
68
|
-
- `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]`
|
|
69
|
-
- MUST generate `.claude/rules/00.core/00.standard-reference.md` — directory of all standard files.
|
|
70
|
-
|
|
71
|
-
4. .claude/rules/50.sync/ (3 sync rules)
|
|
72
|
-
- 01.standard-sync.md — Remind AI to update
|
|
73
|
-
- 02.rules-sync.md — Remind AI to update
|
|
74
|
-
- 03.skills-sync.md — Remind AI to update
|
|
75
|
-
|
|
76
|
-
5. claudeos-core/skills/ (active domains only)
|
|
77
|
-
- 20.frontend-page/01.scaffold-page-feature.md (orchestrator)
|
|
78
|
-
- 20.frontend-page/scaffold-page-feature/01~08 (sub-skills: page, layout, component, hook, api-client, test, style, index)
|
|
79
|
-
- 00.shared/MANIFEST.md (skill registry)
|
|
80
|
-
|
|
81
|
-
6. claudeos-core/guide/ (all)
|
|
82
|
-
- 01.onboarding/01.overview.md
|
|
83
|
-
- 01.onboarding/02.quickstart.md
|
|
84
|
-
- 01.onboarding/03.glossary.md
|
|
85
|
-
- 02.usage/01.faq.md
|
|
86
|
-
- 02.usage/02.real-world-examples.md
|
|
87
|
-
- 02.usage/03.do-and-dont.md
|
|
88
|
-
- 03.troubleshooting/01.troubleshooting.md
|
|
89
|
-
- 04.architecture/01.file-map.md
|
|
90
|
-
- 04.architecture/02.pros-and-cons.md
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
-
|
|
96
|
-
- 30.frontend-skills-master.md — All frontend skills as <file> blocks
|
|
97
|
-
- 40.guides-master.md — All guide/ files as <file> blocks
|
|
98
|
-
|
|
99
|
-
8. claudeos-core/database/
|
|
100
|
-
- 01.schema-overview.md — API endpoint catalog, request/response schemas (if applicable)
|
|
101
|
-
|
|
102
|
-
9. claudeos-core/mcp-guide/
|
|
103
|
-
- 01.mcp-overview.md — List of MCP servers in use, integration methods
|
|
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
|
+
CRITICAL — Package Manager Consistency:
|
|
8
|
+
Check `stack.packageManager` in project-analysis.json (e.g., "pnpm", "yarn", "npm").
|
|
9
|
+
ALL generated files MUST use ONLY that detected package manager's commands.
|
|
10
|
+
NEVER mix npm/yarn/pnpm commands. Also check `scripts` field in the project's package.json
|
|
11
|
+
for actual script names.
|
|
12
|
+
|
|
13
|
+
CRITICAL — Cross-file Consistency:
|
|
14
|
+
Rules (.claude/rules/) and Standards (claudeos-core/standard/) MUST NOT contradict each other.
|
|
15
|
+
|
|
16
|
+
CRITICAL — Code Example Accuracy:
|
|
17
|
+
ALL code examples in rules and standards MUST use EXACT method names, class names,
|
|
18
|
+
and signatures from pass2-merged.json analysis data.
|
|
19
|
+
Do NOT paraphrase, rename, or infer API names.
|
|
20
|
+
|
|
21
|
+
CRITICAL — CLAUDE.md Reference Table Completeness:
|
|
22
|
+
The reference table in CLAUDE.md MUST list ALL generated standard files.
|
|
23
|
+
|
|
24
|
+
Generation targets:
|
|
25
|
+
|
|
26
|
+
1. CLAUDE.md (project root)
|
|
27
|
+
- Role definition (based on detected stack — Vite + React SPA)
|
|
28
|
+
- Build & Run Commands (use ONLY the detected packageManager)
|
|
29
|
+
- Core architecture diagram (client-side SPA, routing, state management)
|
|
30
|
+
- Directory structure description
|
|
31
|
+
- Standard/Skills/Guide reference table
|
|
32
|
+
|
|
33
|
+
2. claudeos-core/standard/ (active domains only)
|
|
34
|
+
- 00.core/01.project-overview.md — Stack, routing approach, deployment environment
|
|
35
|
+
- 00.core/02.architecture.md — SPA structure, component hierarchy, data flow
|
|
36
|
+
- 00.core/03.naming-conventions.md — File/component/hook/type naming conventions
|
|
37
|
+
- 20.frontend-ui/01.component-patterns.md — Component writing rules, Props patterns, reuse
|
|
38
|
+
- 20.frontend-ui/02.page-routing-patterns.md — Client-side routing, layouts, route guards, lazy loading
|
|
39
|
+
- 20.frontend-ui/03.data-fetching.md — API client, TanStack Query/SWR, caching, error handling
|
|
40
|
+
- 20.frontend-ui/04.state-management.md — Global/server/URL/form state management
|
|
41
|
+
- 20.frontend-ui/05.styling-patterns.md — Styling rules, theming, responsive, accessibility
|
|
42
|
+
- 30.security-db/01.security-auth.md — Auth patterns, token management, route protection, environment variables
|
|
43
|
+
- 40.infra/01.environment-config.md — Environment variables (VITE_ prefix), vite.config, build optimization
|
|
44
|
+
- 40.infra/02.logging-monitoring.md — Error tracking, analytics tools, performance monitoring
|
|
45
|
+
- 40.infra/03.cicd-deployment.md — CI/CD, static hosting deployment (Nginx, S3, Vercel, Netlify)
|
|
46
|
+
- 50.verification/01.development-verification.md — Build, startup, dev server
|
|
47
|
+
- 50.verification/02.testing-strategy.md — Testing strategy (Vitest, RTL, E2E, Storybook)
|
|
48
|
+
|
|
49
|
+
Each file MUST include:
|
|
50
|
+
- Correct examples (code blocks)
|
|
51
|
+
- Incorrect examples (code blocks)
|
|
52
|
+
- Key rules summary table
|
|
53
|
+
|
|
54
|
+
3. .claude/rules/ (active domains only)
|
|
55
|
+
- Write the full rule content directly in each file (self-contained, no external references)
|
|
56
|
+
- Include 5-15 lines of key rules with concrete examples
|
|
57
|
+
- Do NOT use @import — it is not a Claude Code feature and does not work
|
|
58
|
+
- Each rule file MUST end with a `## Reference` section linking to the corresponding standard file(s):
|
|
59
|
+
```
|
|
60
|
+
## Reference
|
|
61
|
+
> For detailed patterns and examples, Read: claudeos-core/standard/20.frontend-ui/01.component-patterns.md
|
|
62
|
+
```
|
|
63
|
+
- `paths:` frontmatter per rule category:
|
|
64
|
+
- `00.core/*` rules: `paths: ["**/*"]`
|
|
65
|
+
- `20.frontend/*` rules: `paths: ["**/*"]`
|
|
66
|
+
- `30.security-db/*` rules: `paths: ["**/*"]`
|
|
67
|
+
- `40.infra/*` rules: `paths: ["**/*.json", "**/*.env*", "**/vite.config.*", "**/Dockerfile*", "**/*.yml", "**/*.yaml"]`
|
|
68
|
+
- `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]`
|
|
69
|
+
- MUST generate `.claude/rules/00.core/00.standard-reference.md` — directory of all standard files.
|
|
70
|
+
|
|
71
|
+
4. .claude/rules/50.sync/ (3 sync rules)
|
|
72
|
+
- 01.standard-sync.md — Remind AI to update corresponding rule when standard is modified
|
|
73
|
+
- 02.rules-sync.md — Remind AI to update corresponding standard when rules are modified
|
|
74
|
+
- 03.skills-sync.md — Remind AI to update MANIFEST.md when skills are modified
|
|
75
|
+
|
|
76
|
+
5. claudeos-core/skills/ (active domains only)
|
|
77
|
+
- 20.frontend-page/01.scaffold-page-feature.md (orchestrator)
|
|
78
|
+
- 20.frontend-page/scaffold-page-feature/01~08 (sub-skills: page, layout, component, hook, api-client, test, style, index)
|
|
79
|
+
- 00.shared/MANIFEST.md (skill registry)
|
|
80
|
+
|
|
81
|
+
6. claudeos-core/guide/ (all)
|
|
82
|
+
- 01.onboarding/01.overview.md
|
|
83
|
+
- 01.onboarding/02.quickstart.md
|
|
84
|
+
- 01.onboarding/03.glossary.md
|
|
85
|
+
- 02.usage/01.faq.md
|
|
86
|
+
- 02.usage/02.real-world-examples.md
|
|
87
|
+
- 02.usage/03.do-and-dont.md
|
|
88
|
+
- 03.troubleshooting/01.troubleshooting.md
|
|
89
|
+
- 04.architecture/01.file-map.md
|
|
90
|
+
- 04.architecture/02.pros-and-cons.md
|
|
91
|
+
7. claudeos-core/database/
|
|
92
|
+
- 01.schema-overview.md — API endpoint catalog, request/response schemas (if applicable)
|
|
93
|
+
|
|
94
|
+
8. claudeos-core/mcp-guide/
|
|
95
|
+
- 01.mcp-overview.md — List of MCP servers in use, integration methods
|
|
@@ -114,7 +114,6 @@ Generation targets:
|
|
|
114
114
|
- claudeos-core/standard/50.verification/01.development-verification.md
|
|
115
115
|
- claudeos-core/standard/50.verification/02.testing-strategy.md
|
|
116
116
|
## DO NOT Read (context waste)
|
|
117
|
-
- claudeos-core/plan/ — Master Plan backup files. Never read during coding.
|
|
118
117
|
- claudeos-core/generated/ — Build metadata. Not for coding reference.
|
|
119
118
|
- claudeos-core/guide/ — Onboarding/usage guides for humans. Not for coding reference.
|
|
120
119
|
- claudeos-core/mcp-guide/ — MCP server integration docs. Not for coding reference.
|
|
@@ -123,9 +122,9 @@ Generation targets:
|
|
|
123
122
|
|
|
124
123
|
4. .claude/rules/50.sync/ (3 sync rules — AI fallback reminders)
|
|
125
124
|
- NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
|
|
126
|
-
- 01.standard-sync.md — Remind AI to update
|
|
127
|
-
- 02.rules-sync.md — Remind AI to update
|
|
128
|
-
- 03.skills-sync.md — Remind AI to update
|
|
125
|
+
- 01.standard-sync.md — Remind AI to update corresponding rule when standard is modified
|
|
126
|
+
- 02.rules-sync.md — Remind AI to update corresponding standard when rules are modified
|
|
127
|
+
- 03.skills-sync.md — Remind AI to update MANIFEST.md when skills are modified
|
|
129
128
|
|
|
130
129
|
5. claudeos-core/skills/ (active domains only)
|
|
131
130
|
- 10.backend-crud/01.scaffold-crud-feature.md (orchestrator)
|
|
@@ -142,17 +141,9 @@ Generation targets:
|
|
|
142
141
|
- 03.troubleshooting/01.troubleshooting.md
|
|
143
142
|
- 04.architecture/01.file-map.md
|
|
144
143
|
- 04.architecture/02.pros-and-cons.md
|
|
145
|
-
|
|
146
|
-
7. claudeos-core/plan/ (Master Plan)
|
|
147
|
-
- 10.standard-master.md
|
|
148
|
-
- 20.rules-master.md
|
|
149
|
-
- 21.sync-rules-master.md
|
|
150
|
-
- 30.backend-skills-master.md
|
|
151
|
-
- 40.guides-master.md
|
|
152
|
-
|
|
153
|
-
8. claudeos-core/database/
|
|
144
|
+
7. claudeos-core/database/
|
|
154
145
|
- 01.schema-overview.md — Table list, relationship description
|
|
155
146
|
- 02.migration-guide.md — Migration procedure, squash, rollback
|
|
156
147
|
|
|
157
|
-
|
|
148
|
+
8. claudeos-core/mcp-guide/
|
|
158
149
|
- 01.mcp-overview.md — List of MCP servers in use, integration methods
|
|
@@ -114,7 +114,6 @@ Generation targets:
|
|
|
114
114
|
- claudeos-core/standard/50.verification/01.development-verification.md
|
|
115
115
|
- claudeos-core/standard/50.verification/02.testing-strategy.md
|
|
116
116
|
## DO NOT Read (context waste)
|
|
117
|
-
- claudeos-core/plan/ — Master Plan backup files. Never read during coding.
|
|
118
117
|
- claudeos-core/generated/ — Build metadata. Not for coding reference.
|
|
119
118
|
- claudeos-core/guide/ — Onboarding/usage guides for humans. Not for coding reference.
|
|
120
119
|
- claudeos-core/mcp-guide/ — MCP server integration docs. Not for coding reference.
|
|
@@ -123,9 +122,9 @@ Generation targets:
|
|
|
123
122
|
|
|
124
123
|
4. .claude/rules/50.sync/ (3 sync rules — AI fallback reminders)
|
|
125
124
|
- NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
|
|
126
|
-
- 01.standard-sync.md — Remind AI to update
|
|
127
|
-
- 02.rules-sync.md — Remind AI to update
|
|
128
|
-
- 03.skills-sync.md — Remind AI to update
|
|
125
|
+
- 01.standard-sync.md — Remind AI to update corresponding rule when standard is modified
|
|
126
|
+
- 02.rules-sync.md — Remind AI to update corresponding standard when rules are modified
|
|
127
|
+
- 03.skills-sync.md — Remind AI to update MANIFEST.md when skills are modified
|
|
129
128
|
|
|
130
129
|
5. claudeos-core/skills/ (active domains only)
|
|
131
130
|
- 10.backend-crud/01.scaffold-crud-feature.md (orchestrator)
|
|
@@ -142,17 +141,9 @@ Generation targets:
|
|
|
142
141
|
- 03.troubleshooting/01.troubleshooting.md
|
|
143
142
|
- 04.architecture/01.file-map.md
|
|
144
143
|
- 04.architecture/02.pros-and-cons.md
|
|
145
|
-
|
|
146
|
-
7. claudeos-core/plan/ (Master Plan)
|
|
147
|
-
- 10.standard-master.md
|
|
148
|
-
- 20.rules-master.md
|
|
149
|
-
- 21.sync-rules-master.md
|
|
150
|
-
- 30.backend-skills-master.md
|
|
151
|
-
- 40.guides-master.md
|
|
152
|
-
|
|
153
|
-
8. claudeos-core/database/
|
|
144
|
+
7. claudeos-core/database/
|
|
154
145
|
- 01.schema-overview.md — Table list, relationship description
|
|
155
146
|
- 02.migration-guide.md — Alembic procedure, autogenerate, rollback
|
|
156
147
|
|
|
157
|
-
|
|
148
|
+
8. claudeos-core/mcp-guide/
|
|
158
149
|
- 01.mcp-overview.md — List of MCP servers in use, integration methods
|
|
@@ -1,103 +1,95 @@
|
|
|
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
|
-
CRITICAL — Package Manager Consistency:
|
|
8
|
-
Check `stack.packageManager` in project-analysis.json (e.g., "poetry", "pipenv", "pip").
|
|
9
|
-
ALL generated files MUST use ONLY that detected package manager's commands.
|
|
10
|
-
NEVER mix pip/poetry/pipenv commands. Also check actual script names in pyproject.toml or Makefile.
|
|
11
|
-
|
|
12
|
-
CRITICAL — Cross-file Consistency:
|
|
13
|
-
Rules (.claude/rules/) and Standards (claudeos-core/standard/) MUST NOT contradict each other.
|
|
14
|
-
|
|
15
|
-
CRITICAL — Code Example Accuracy:
|
|
16
|
-
ALL code examples in rules and standards MUST use EXACT method names, class names,
|
|
17
|
-
and signatures from pass2-merged.json analysis data.
|
|
18
|
-
Do NOT paraphrase, rename, or infer API names.
|
|
19
|
-
|
|
20
|
-
CRITICAL — Response Flow Consistency:
|
|
21
|
-
Determine from pass2-merged.json which layer (route handler vs service layer) formats
|
|
22
|
-
the response. This MUST be identical across architecture.md, route-patterns.md,
|
|
23
|
-
and all rules files.
|
|
24
|
-
|
|
25
|
-
CRITICAL — CLAUDE.md Reference Table Completeness:
|
|
26
|
-
The reference table in CLAUDE.md MUST list ALL generated standard files.
|
|
27
|
-
|
|
28
|
-
Generation targets:
|
|
29
|
-
|
|
30
|
-
1. CLAUDE.md (project root)
|
|
31
|
-
- Role definition (based on detected stack — Flask)
|
|
32
|
-
- Build & Run Commands (pip/poetry, flask run, gunicorn, docker)
|
|
33
|
-
- Core architecture diagram (application factory, Blueprint structure)
|
|
34
|
-
- Module structure
|
|
35
|
-
- Standard/Skills/Guide reference table
|
|
36
|
-
|
|
37
|
-
2. claudeos-core/standard/ (active domains only)
|
|
38
|
-
- 00.core/01.project-overview.md — Stack, modules, server info
|
|
39
|
-
- 00.core/02.architecture.md — Application factory, Blueprint hierarchy, request flow
|
|
40
|
-
- 00.core/03.naming-conventions.md — Module/model/blueprint/route naming conventions
|
|
41
|
-
- 10.backend-api/01.route-blueprint-patterns.md — Blueprint structure, route decorators, request/response handling
|
|
42
|
-
- 10.backend-api/02.model-schema-patterns.md — SQLAlchemy models, marshmallow/WTForms serialization
|
|
43
|
-
- 10.backend-api/03.service-patterns.md — Service layer, business logic separation
|
|
44
|
-
- 10.backend-api/04.response-error-patterns.md — Response formatting, error handlers, custom exceptions
|
|
45
|
-
- 30.security-db/01.security-auth.md — Authentication, CSRF, session management, environment variables
|
|
46
|
-
- 30.security-db/02.database-patterns.md — SQLAlchemy patterns, migrations, relationships
|
|
47
|
-
- 40.infra/01.environment-config.md — Config classes, environment variables, extension initialization
|
|
48
|
-
- 40.infra/02.logging-monitoring.md — app.logger, request logging, error tracking
|
|
49
|
-
- 40.infra/03.cicd-deployment.md — CI/CD, gunicorn, Docker deployment
|
|
50
|
-
- 50.verification/01.development-verification.md — Build, startup, flask run
|
|
51
|
-
- 50.verification/02.testing-strategy.md — pytest, test_client, fixtures, DB testing
|
|
52
|
-
|
|
53
|
-
Each file MUST include:
|
|
54
|
-
- Correct examples (code blocks)
|
|
55
|
-
- Incorrect examples (code blocks)
|
|
56
|
-
- Key rules summary table
|
|
57
|
-
|
|
58
|
-
3. .claude/rules/ (active domains only)
|
|
59
|
-
- Write the full rule content directly in each file (self-contained)
|
|
60
|
-
- Include 5-15 lines of key rules with concrete examples
|
|
61
|
-
- Do NOT use @import
|
|
62
|
-
- Each rule file MUST end with a `## Reference` section linking to the corresponding standard
|
|
63
|
-
- `paths:` frontmatter per rule category:
|
|
64
|
-
- `00.core/*` rules: `paths: ["**/*"]`
|
|
65
|
-
- `10.backend/*` rules: `paths: ["**/*"]`
|
|
66
|
-
- `30.security-db/*` rules: `paths: ["**/*"]`
|
|
67
|
-
- `40.infra/*` rules: `paths: ["**/*.json", "**/*.env*", "**/*.cfg", "**/Dockerfile*", "**/*.yml", "**/*.yaml"]`
|
|
68
|
-
- `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]`
|
|
69
|
-
- MUST generate `.claude/rules/00.core/00.standard-reference.md` — directory of all standard files
|
|
70
|
-
|
|
71
|
-
4. .claude/rules/50.sync/ (3 sync rules)
|
|
72
|
-
- 01.standard-sync.md
|
|
73
|
-
- 02.rules-sync.md
|
|
74
|
-
- 03.skills-sync.md
|
|
75
|
-
|
|
76
|
-
5. claudeos-core/skills/ (active domains only)
|
|
77
|
-
- 10.backend-crud/01.scaffold-crud-feature.md (orchestrator)
|
|
78
|
-
- 10.backend-crud/scaffold-crud-feature/01~08 (sub-skills: blueprint, routes, model, schema, service, migration, test, index)
|
|
79
|
-
- 00.shared/MANIFEST.md (skill registry)
|
|
80
|
-
|
|
81
|
-
6. claudeos-core/guide/ (all)
|
|
82
|
-
- 01.onboarding/01.overview.md
|
|
83
|
-
- 01.onboarding/02.quickstart.md
|
|
84
|
-
- 01.onboarding/03.glossary.md
|
|
85
|
-
- 02.usage/01.faq.md
|
|
86
|
-
- 02.usage/02.real-world-examples.md
|
|
87
|
-
- 02.usage/03.do-and-dont.md
|
|
88
|
-
- 03.troubleshooting/01.troubleshooting.md
|
|
89
|
-
- 04.architecture/01.file-map.md
|
|
90
|
-
- 04.architecture/02.pros-and-cons.md
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
-
|
|
96
|
-
- 30.backend-skills-master.md — All backend skills as <file> blocks
|
|
97
|
-
- 40.guides-master.md — All guide/ files as <file> blocks
|
|
98
|
-
|
|
99
|
-
8. claudeos-core/database/
|
|
100
|
-
- 01.schema-overview.md — DB schema, model relationships, migration guide
|
|
101
|
-
|
|
102
|
-
9. claudeos-core/mcp-guide/
|
|
103
|
-
- 01.mcp-overview.md — MCP server integration
|
|
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
|
+
CRITICAL — Package Manager Consistency:
|
|
8
|
+
Check `stack.packageManager` in project-analysis.json (e.g., "poetry", "pipenv", "pip").
|
|
9
|
+
ALL generated files MUST use ONLY that detected package manager's commands.
|
|
10
|
+
NEVER mix pip/poetry/pipenv commands. Also check actual script names in pyproject.toml or Makefile.
|
|
11
|
+
|
|
12
|
+
CRITICAL — Cross-file Consistency:
|
|
13
|
+
Rules (.claude/rules/) and Standards (claudeos-core/standard/) MUST NOT contradict each other.
|
|
14
|
+
|
|
15
|
+
CRITICAL — Code Example Accuracy:
|
|
16
|
+
ALL code examples in rules and standards MUST use EXACT method names, class names,
|
|
17
|
+
and signatures from pass2-merged.json analysis data.
|
|
18
|
+
Do NOT paraphrase, rename, or infer API names.
|
|
19
|
+
|
|
20
|
+
CRITICAL — Response Flow Consistency:
|
|
21
|
+
Determine from pass2-merged.json which layer (route handler vs service layer) formats
|
|
22
|
+
the response. This MUST be identical across architecture.md, route-patterns.md,
|
|
23
|
+
and all rules files.
|
|
24
|
+
|
|
25
|
+
CRITICAL — CLAUDE.md Reference Table Completeness:
|
|
26
|
+
The reference table in CLAUDE.md MUST list ALL generated standard files.
|
|
27
|
+
|
|
28
|
+
Generation targets:
|
|
29
|
+
|
|
30
|
+
1. CLAUDE.md (project root)
|
|
31
|
+
- Role definition (based on detected stack — Flask)
|
|
32
|
+
- Build & Run Commands (pip/poetry, flask run, gunicorn, docker)
|
|
33
|
+
- Core architecture diagram (application factory, Blueprint structure)
|
|
34
|
+
- Module structure
|
|
35
|
+
- Standard/Skills/Guide reference table
|
|
36
|
+
|
|
37
|
+
2. claudeos-core/standard/ (active domains only)
|
|
38
|
+
- 00.core/01.project-overview.md — Stack, modules, server info
|
|
39
|
+
- 00.core/02.architecture.md — Application factory, Blueprint hierarchy, request flow
|
|
40
|
+
- 00.core/03.naming-conventions.md — Module/model/blueprint/route naming conventions
|
|
41
|
+
- 10.backend-api/01.route-blueprint-patterns.md — Blueprint structure, route decorators, request/response handling
|
|
42
|
+
- 10.backend-api/02.model-schema-patterns.md — SQLAlchemy models, marshmallow/WTForms serialization
|
|
43
|
+
- 10.backend-api/03.service-patterns.md — Service layer, business logic separation
|
|
44
|
+
- 10.backend-api/04.response-error-patterns.md — Response formatting, error handlers, custom exceptions
|
|
45
|
+
- 30.security-db/01.security-auth.md — Authentication, CSRF, session management, environment variables
|
|
46
|
+
- 30.security-db/02.database-patterns.md — SQLAlchemy patterns, migrations, relationships
|
|
47
|
+
- 40.infra/01.environment-config.md — Config classes, environment variables, extension initialization
|
|
48
|
+
- 40.infra/02.logging-monitoring.md — app.logger, request logging, error tracking
|
|
49
|
+
- 40.infra/03.cicd-deployment.md — CI/CD, gunicorn, Docker deployment
|
|
50
|
+
- 50.verification/01.development-verification.md — Build, startup, flask run
|
|
51
|
+
- 50.verification/02.testing-strategy.md — pytest, test_client, fixtures, DB testing
|
|
52
|
+
|
|
53
|
+
Each file MUST include:
|
|
54
|
+
- Correct examples (code blocks)
|
|
55
|
+
- Incorrect examples (code blocks)
|
|
56
|
+
- Key rules summary table
|
|
57
|
+
|
|
58
|
+
3. .claude/rules/ (active domains only)
|
|
59
|
+
- Write the full rule content directly in each file (self-contained)
|
|
60
|
+
- Include 5-15 lines of key rules with concrete examples
|
|
61
|
+
- Do NOT use @import
|
|
62
|
+
- Each rule file MUST end with a `## Reference` section linking to the corresponding standard
|
|
63
|
+
- `paths:` frontmatter per rule category:
|
|
64
|
+
- `00.core/*` rules: `paths: ["**/*"]`
|
|
65
|
+
- `10.backend/*` rules: `paths: ["**/*"]`
|
|
66
|
+
- `30.security-db/*` rules: `paths: ["**/*"]`
|
|
67
|
+
- `40.infra/*` rules: `paths: ["**/*.json", "**/*.env*", "**/*.cfg", "**/Dockerfile*", "**/*.yml", "**/*.yaml"]`
|
|
68
|
+
- `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]`
|
|
69
|
+
- MUST generate `.claude/rules/00.core/00.standard-reference.md` — directory of all standard files
|
|
70
|
+
|
|
71
|
+
4. .claude/rules/50.sync/ (3 sync rules)
|
|
72
|
+
- 01.standard-sync.md
|
|
73
|
+
- 02.rules-sync.md
|
|
74
|
+
- 03.skills-sync.md
|
|
75
|
+
|
|
76
|
+
5. claudeos-core/skills/ (active domains only)
|
|
77
|
+
- 10.backend-crud/01.scaffold-crud-feature.md (orchestrator)
|
|
78
|
+
- 10.backend-crud/scaffold-crud-feature/01~08 (sub-skills: blueprint, routes, model, schema, service, migration, test, index)
|
|
79
|
+
- 00.shared/MANIFEST.md (skill registry)
|
|
80
|
+
|
|
81
|
+
6. claudeos-core/guide/ (all)
|
|
82
|
+
- 01.onboarding/01.overview.md
|
|
83
|
+
- 01.onboarding/02.quickstart.md
|
|
84
|
+
- 01.onboarding/03.glossary.md
|
|
85
|
+
- 02.usage/01.faq.md
|
|
86
|
+
- 02.usage/02.real-world-examples.md
|
|
87
|
+
- 02.usage/03.do-and-dont.md
|
|
88
|
+
- 03.troubleshooting/01.troubleshooting.md
|
|
89
|
+
- 04.architecture/01.file-map.md
|
|
90
|
+
- 04.architecture/02.pros-and-cons.md
|
|
91
|
+
7. claudeos-core/database/
|
|
92
|
+
- 01.schema-overview.md — DB schema, model relationships, migration guide
|
|
93
|
+
|
|
94
|
+
8. claudeos-core/mcp-guide/
|
|
95
|
+
- 01.mcp-overview.md — MCP server integration
|
|
@@ -85,16 +85,8 @@ Generation targets:
|
|
|
85
85
|
- 03.troubleshooting/01.troubleshooting.md
|
|
86
86
|
- 04.architecture/01.file-map.md
|
|
87
87
|
- 04.architecture/02.pros-and-cons.md
|
|
88
|
-
|
|
89
|
-
7. claudeos-core/plan/ (Master Plan)
|
|
90
|
-
- 10.standard-master.md — CLAUDE.md + all standard/ files as <file> blocks
|
|
91
|
-
- 20.rules-master.md — All rules/ (except sync) as <file> blocks
|
|
92
|
-
- 21.sync-rules-master.md — All sync rules (code block format)
|
|
93
|
-
- 30.frontend-skills-master.md — All frontend skills as <file> blocks
|
|
94
|
-
- 40.guides-master.md — All guide/ files as <file> blocks
|
|
95
|
-
|
|
96
|
-
8. claudeos-core/database/
|
|
88
|
+
7. claudeos-core/database/
|
|
97
89
|
- 01.schema-overview.md — DB schema description (if applicable)
|
|
98
90
|
|
|
99
|
-
|
|
91
|
+
8. claudeos-core/mcp-guide/
|
|
100
92
|
- 01.mcp-overview.md — List of MCP servers in use, integration methods
|