claudeos-core 2.0.2 → 2.1.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.
Files changed (42) hide show
  1. package/CHANGELOG.md +178 -0
  2. package/README.de.md +994 -880
  3. package/README.es.md +993 -880
  4. package/README.fr.md +993 -880
  5. package/README.hi.md +993 -880
  6. package/README.ja.md +993 -880
  7. package/README.ko.md +159 -47
  8. package/README.md +159 -46
  9. package/README.ru.md +993 -880
  10. package/README.vi.md +161 -48
  11. package/README.zh-CN.md +992 -880
  12. package/bin/cli.js +7 -2
  13. package/bin/commands/init.js +733 -143
  14. package/bin/commands/memory.js +17 -5
  15. package/bootstrap.sh +81 -81
  16. package/lib/expected-outputs.js +6 -7
  17. package/lib/memory-scaffold.js +84 -46
  18. package/lib/plan-parser.js +12 -0
  19. package/manifest-generator/index.js +16 -18
  20. package/package.json +1 -1
  21. package/pass-prompts/templates/angular/pass3.md +2 -10
  22. package/pass-prompts/templates/common/pass3-phase1.md +131 -0
  23. package/pass-prompts/templates/common/pass3a-facts.md +143 -0
  24. package/pass-prompts/templates/common/pass3b-core-header.md +58 -0
  25. package/pass-prompts/templates/common/pass3c-skills-guide-header.md +53 -0
  26. package/pass-prompts/templates/common/pass3d-plan-aux-header.md +57 -0
  27. package/pass-prompts/templates/common/pass4.md +4 -19
  28. package/pass-prompts/templates/java-spring/pass3.md +5 -15
  29. package/pass-prompts/templates/kotlin-spring/pass3.md +5 -15
  30. package/pass-prompts/templates/node-express/pass3.md +5 -14
  31. package/pass-prompts/templates/node-fastify/pass3.md +2 -10
  32. package/pass-prompts/templates/node-nestjs/pass3.md +5 -13
  33. package/pass-prompts/templates/node-nextjs/pass3.md +5 -14
  34. package/pass-prompts/templates/node-vite/pass3.md +95 -103
  35. package/pass-prompts/templates/python-django/pass3.md +5 -14
  36. package/pass-prompts/templates/python-fastapi/pass3.md +5 -14
  37. package/pass-prompts/templates/python-flask/pass3.md +95 -103
  38. package/pass-prompts/templates/vue-nuxt/pass3.md +2 -10
  39. package/plan-installer/pass3-context-builder.js +258 -0
  40. package/plan-installer/prompt-generator.js +9 -1
  41. package/plan-validator/index.js +23 -8
  42. 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 plan/10 when standard is modified
90
- - 02.rules-sync.md — Remind AI to update plan/20 when rules is modified
91
- - 03.skills-sync.md — Remind AI to update plan/30 when skills is modified
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
- 9. claudeos-core/mcp-guide/
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 plan/10 when standard is modified
126
- - 02.rules-sync.md — Remind AI to update plan/20 when rules is modified
127
- - 03.skills-sync.md — Remind AI to update plan/30 when skills is modified
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
- 9. claudeos-core/mcp-guide/
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 plan/10 when standard is modified
73
- - 02.rules-sync.md — Remind AI to update plan/20 when rules is modified
74
- - 03.skills-sync.md — Remind AI to update plan/30 when skills is 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
-
92
- 7. claudeos-core/plan/ (Master Plan)
93
- - 10.standard-master.md — CLAUDE.md + all standard/ files as <file> blocks
94
- - 20.rules-master.md — All rules/ (except sync) as <file> blocks
95
- - 21.sync-rules-master.md — All sync rules (code block format)
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 plan/10 when standard is modified
127
- - 02.rules-sync.md — Remind AI to update plan/20 when rules is modified
128
- - 03.skills-sync.md — Remind AI to update plan/30 when skills is modified
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
- 9. claudeos-core/mcp-guide/
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 plan/10 when standard is modified
127
- - 02.rules-sync.md — Remind AI to update plan/20 when rules is modified
128
- - 03.skills-sync.md — Remind AI to update plan/30 when skills is modified
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
- 9. claudeos-core/mcp-guide/
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
- 7. claudeos-core/plan/ (Master Plan)
93
- - 10.standard-master.md — CLAUDE.md + all standard/ files as <file> blocks
94
- - 20.rules-master.md — All rules/ (except sync) as <file> blocks
95
- - 21.sync-rules-master.md — All sync rules (code block format)
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
- 9. claudeos-core/mcp-guide/
91
+ 8. claudeos-core/mcp-guide/
100
92
  - 01.mcp-overview.md — List of MCP servers in use, integration methods