scene-capability-engine 3.0.0 → 3.0.2

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 (170) hide show
  1. package/CHANGELOG.md +234 -233
  2. package/LICENSE +2 -2
  3. package/README.md +8 -11
  4. package/README.zh.md +7 -10
  5. package/bin/kse.js +1 -1
  6. package/bin/sce.js +1 -1
  7. package/bin/sco.js +1 -1
  8. package/docs/331-poc-adaptation-roadmap.md +25 -25
  9. package/docs/331-poc-dual-track-integration-guide.md +26 -26
  10. package/docs/331-poc-weekly-delivery-checklist.md +8 -8
  11. package/docs/OFFLINE_INSTALL.md +10 -10
  12. package/docs/README.md +24 -24
  13. package/docs/adopt-migration-guide.md +51 -51
  14. package/docs/adoption-guide.md +56 -56
  15. package/docs/agent-hooks-analysis.md +52 -52
  16. package/docs/architecture.md +6 -6
  17. package/docs/articles/ai-driven-development-philosophy-and-practice-review.md +4 -4
  18. package/docs/articles/ai-driven-development-philosophy-and-practice.en.md +9 -9
  19. package/docs/articles/ai-driven-development-philosophy-and-practice.md +10 -10
  20. package/docs/autonomous-control-guide.md +89 -89
  21. package/docs/command-reference.md +11 -11
  22. package/docs/community.md +4 -4
  23. package/docs/cross-tool-guide.md +47 -47
  24. package/docs/developer-guide.md +5 -5
  25. package/docs/document-governance.md +91 -91
  26. package/docs/environment-management-guide.md +53 -53
  27. package/docs/examples/add-export-command/design.md +2 -2
  28. package/docs/examples/add-export-command/requirements.md +5 -5
  29. package/docs/examples/add-export-command/tasks.md +2 -2
  30. package/docs/faq.md +69 -69
  31. package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.json +9 -9
  32. package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.md +3 -3
  33. package/docs/integration-modes.md +60 -60
  34. package/docs/integration-philosophy.md +48 -48
  35. package/docs/knowledge-management-guide.md +21 -21
  36. package/docs/manual-workflows-guide.md +20 -20
  37. package/docs/moqui-capability-matrix.md +22 -22
  38. package/docs/moqui-template-core-library-playbook.md +20 -20
  39. package/docs/multi-agent-coordination-guide.md +19 -19
  40. package/docs/multi-repo-management-guide.md +93 -93
  41. package/docs/quick-start-with-ai-tools.md +36 -36
  42. package/docs/quick-start.md +16 -16
  43. package/docs/release-checklist.md +7 -7
  44. package/docs/releases/v1.46.2-validation.md +1 -1
  45. package/docs/releases/v1.46.2.md +10 -10
  46. package/docs/scene-runtime-guide.md +42 -42
  47. package/docs/spec-collaboration-guide.md +43 -43
  48. package/docs/spec-locking-guide.md +26 -26
  49. package/docs/spec-numbering-guide.md +6 -6
  50. package/docs/spec-workflow.md +25 -25
  51. package/docs/steering-strategy-guide.md +36 -36
  52. package/docs/team-collaboration-guide.md +23 -23
  53. package/docs/testing-strategy.md +2 -2
  54. package/docs/tools/claude-guide.md +26 -26
  55. package/docs/tools/cursor-guide.md +31 -31
  56. package/docs/tools/generic-guide.md +22 -22
  57. package/docs/tools/kiro-guide.md +43 -43
  58. package/docs/tools/vscode-guide.md +18 -18
  59. package/docs/tools/windsurf-guide.md +50 -50
  60. package/docs/troubleshooting.md +116 -116
  61. package/docs/upgrade-guide.md +49 -49
  62. package/docs/value-observability-guide.md +6 -6
  63. package/docs/zh/README.md +22 -22
  64. package/docs/zh/quick-start.md +34 -34
  65. package/docs/zh/release-checklist.md +6 -6
  66. package/docs/zh/releases/v1.46.2-validation.md +1 -1
  67. package/docs/zh/releases/v1.46.2.md +9 -9
  68. package/docs/zh/spec-numbering-guide.md +6 -6
  69. package/docs/zh/tools/claude-guide.md +14 -14
  70. package/docs/zh/tools/cursor-guide.md +18 -18
  71. package/docs/zh/tools/generic-guide.md +40 -40
  72. package/docs/zh/tools/kiro-guide.md +50 -50
  73. package/docs/zh/tools/vscode-guide.md +20 -20
  74. package/docs/zh/tools/windsurf-guide.md +49 -49
  75. package/docs/zh/value-observability-guide.md +6 -6
  76. package/docs//344/272/244/344/273/230/346/270/205/345/215/225.md +4 -4
  77. package/lib/adoption/adoption-logger.js +1 -1
  78. package/lib/adoption/adoption-strategy.js +3 -3
  79. package/lib/adoption/detection-engine.js +1 -1
  80. package/lib/adoption/error-formatter.js +17 -17
  81. package/lib/adoption/progress-reporter.js +2 -2
  82. package/lib/adoption/smart-orchestrator.js +2 -2
  83. package/lib/adoption/strategy-selector.js +2 -2
  84. package/lib/adoption/summary-generator.js +3 -3
  85. package/lib/auto/autonomous-engine.js +2 -2
  86. package/lib/auto/close-loop-runner.js +9 -9
  87. package/lib/backup/backup-system.js +2 -2
  88. package/lib/collab/collab-manager.js +2 -2
  89. package/lib/commands/adopt.js +16 -16
  90. package/lib/commands/auto.js +93 -93
  91. package/lib/commands/collab.js +8 -8
  92. package/lib/commands/docs.js +26 -26
  93. package/lib/commands/doctor.js +2 -2
  94. package/lib/commands/env.js +14 -14
  95. package/lib/commands/knowledge.js +13 -13
  96. package/lib/commands/lock.js +6 -6
  97. package/lib/commands/ops.js +19 -19
  98. package/lib/commands/orchestrate.js +5 -5
  99. package/lib/commands/prompt.js +3 -3
  100. package/lib/commands/rollback.js +4 -4
  101. package/lib/commands/scene.js +29 -29
  102. package/lib/commands/spec-bootstrap.js +1 -1
  103. package/lib/commands/spec-gate.js +1 -1
  104. package/lib/commands/spec-pipeline.js +1 -1
  105. package/lib/commands/task.js +1 -1
  106. package/lib/commands/templates.js +27 -27
  107. package/lib/commands/upgrade.js +8 -8
  108. package/lib/commands/value.js +4 -4
  109. package/lib/commands/watch.js +9 -9
  110. package/lib/commands/workflows.js +5 -5
  111. package/lib/commands/workspace-multi.js +17 -17
  112. package/lib/commands/workspace.js +5 -5
  113. package/lib/context/context-exporter.js +1 -1
  114. package/lib/context/prompt-generator.js +1 -1
  115. package/lib/data/moqui-capability-lexicon.json +1 -1
  116. package/lib/environment/environment-manager.js +1 -1
  117. package/lib/gitignore/gitignore-detector.js +4 -4
  118. package/lib/gitignore/gitignore-integration.js +2 -2
  119. package/lib/gitignore/gitignore-transformer.js +3 -3
  120. package/lib/gitignore/layered-rules-template.js +2 -2
  121. package/lib/governance/diagnostic-engine.js +4 -4
  122. package/lib/governance/doc-reference-checker.js +1 -1
  123. package/lib/governance/hooks-manager.js +5 -5
  124. package/lib/governance/reporter.js +1 -1
  125. package/lib/knowledge/knowledge-manager.js +6 -6
  126. package/lib/orchestrator/agent-spawner.js +1 -1
  127. package/lib/orchestrator/bootstrap-prompt-builder.js +2 -2
  128. package/lib/repo/config-manager.js +2 -2
  129. package/lib/repo/handlers/init-handler.js +3 -3
  130. package/lib/scene-runtime/audit-emitter.js +2 -2
  131. package/lib/scene-runtime/binding-plugin-loader.js +1 -1
  132. package/lib/scene-runtime/moqui-adapter.js +2 -2
  133. package/lib/scene-runtime/moqui-extractor.js +3 -3
  134. package/lib/scene-runtime/scene-loader.js +3 -3
  135. package/lib/scene-runtime/scene-template-linter.js +1 -1
  136. package/lib/scene-runtime/templates/scene-template-erp-query-v0.1.yaml +1 -1
  137. package/lib/scene-runtime/templates/scene-template-hybrid-shadow-v0.1.yaml +1 -1
  138. package/lib/spec/multi-spec-orchestrate.js +1 -1
  139. package/lib/spec-gate/rules/default-rules.js +1 -1
  140. package/lib/steering/adoption-config.js +1 -1
  141. package/lib/steering/compliance-auto-fixer.js +1 -1
  142. package/lib/steering/compliance-cache.js +3 -3
  143. package/lib/steering/compliance-error-reporter.js +1 -1
  144. package/lib/steering/index.js +1 -1
  145. package/lib/steering/steering-manager.js +7 -7
  146. package/lib/task/task-claimer.js +2 -1
  147. package/lib/templates/metadata-collector.js +6 -6
  148. package/lib/templates/template-creator.js +2 -2
  149. package/lib/templates/template-exporter.js +12 -12
  150. package/lib/upgrade/migration-engine.js +4 -4
  151. package/lib/utils/tool-detector.js +25 -25
  152. package/lib/utils/validation.js +3 -3
  153. package/lib/version/version-checker.js +13 -13
  154. package/lib/version/version-manager.js +7 -7
  155. package/lib/watch/presets.js +4 -4
  156. package/lib/workspace/multi/path-utils.js +1 -1
  157. package/lib/workspace/multi/workspace-context-resolver.js +9 -9
  158. package/lib/workspace/multi/workspace-registry.js +2 -2
  159. package/lib/workspace/multi/workspace-state-manager.js +1 -1
  160. package/lib/workspace/multi/workspace.js +1 -1
  161. package/lib/workspace/workspace-sync.js +1 -1
  162. package/locales/en.json +1 -1
  163. package/locales/zh.json +1 -1
  164. package/package.json +5 -6
  165. package/template/.kiro/README.md +40 -40
  166. package/template/.kiro/specs/SPEC_WORKFLOW_GUIDE.md +3 -3
  167. package/template/.kiro/steering/CORE_PRINCIPLES.md +3 -3
  168. package/template/.kiro/steering/ENVIRONMENT.md +2 -2
  169. package/template/README.md +3 -3
  170. /package/bin/{kiro-spec-engine.js → scene-capability-engine.js} +0 -0
package/docs/README.md CHANGED
@@ -1,6 +1,6 @@
1
- # kse Documentation Index
1
+ # sce Documentation Index
2
2
 
3
- > Complete guide to kse (Kiro Spec Engine)
3
+ > Complete guide to sce (Scene Capability Engine)
4
4
 
5
5
  ---
6
6
 
@@ -11,30 +11,30 @@
11
11
 
12
12
  ## 🚀 Getting Started
13
13
 
14
- **New to kse?** Start here:
14
+ **New to sce?** Start here:
15
15
 
16
16
  - **[Quick Start Guide](quick-start.md)** - Get up and running in 5 minutes
17
17
  - **[FAQ](faq.md)** - Frequently asked questions
18
18
  - **[Troubleshooting](troubleshooting.md)** - Common issues and solutions
19
19
 
20
- ## ⭐ Why Teams Choose kse
20
+ ## ⭐ Why Teams Choose sce
21
21
 
22
22
  - **Structured AI delivery**: Specs enforce Requirements → Design → Tasks before implementation.
23
23
  - **Parallel execution at scale**: Orchestrate multiple Specs with dependency-aware scheduling.
24
- - **Dual-track handoff closure**: `kse auto handoff run` executes plan/queue/batch/observability in one closed loop, supports `--continue-from` resume, and emits executable follow-up recommendations.
24
+ - **Dual-track handoff closure**: `sce auto handoff run` executes plan/queue/batch/observability in one closed loop, supports `--continue-from` resume, and emits executable follow-up recommendations.
25
25
  - **Measurable outcomes**: KPI snapshot/baseline/trend commands make delivery quality auditable.
26
- - **Tool-agnostic workflow**: Works across Claude, Cursor, Windsurf, Copilot, and Kiro.
26
+ - **Tool-agnostic workflow**: Works across Claude, Cursor, Windsurf, Copilot, and SCE.
27
27
  - **Built-in governance**: Locks, document governance, environment/workspace controls, and audit trails.
28
28
 
29
29
  ---
30
30
 
31
31
  ## 📖 Core Concepts
32
32
 
33
- Understand how kse works:
33
+ Understand how sce works:
34
34
 
35
35
  - **[Spec Workflow](spec-workflow.md)** - Understanding the Spec-driven development process
36
- - **[Integration Modes](integration-modes.md)** - Three ways to integrate kse with AI tools
37
- - **[Command Reference](command-reference.md)** - Complete list of all kse commands
36
+ - **[Integration Modes](integration-modes.md)** - Three ways to integrate sce with AI tools
37
+ - **[Command Reference](command-reference.md)** - Complete list of all sce commands
38
38
 
39
39
  ---
40
40
 
@@ -43,18 +43,18 @@ Understand how kse works:
43
43
  Choose your AI tool and learn how to integrate:
44
44
 
45
45
  ### Native Integration
46
- - **[Kiro IDE Guide](tools/kiro-guide.md)** - Fully automatic integration
46
+ - **[AI IDE Guide](tools/SCE-guide.md)** - Fully automatic integration
47
47
 
48
48
  ### Manual Export Integration
49
- - **[Cursor Guide](tools/cursor-guide.md)** - Using kse with Cursor IDE
50
- - **[Claude Code Guide](tools/claude-guide.md)** - Using kse with Claude Code
51
- - **[VS Code + Copilot Guide](tools/vscode-guide.md)** - Using kse with VS Code and GitHub Copilot
49
+ - **[Cursor Guide](tools/cursor-guide.md)** - Using sce with Cursor IDE
50
+ - **[Claude Code Guide](tools/claude-guide.md)** - Using sce with Claude Code
51
+ - **[VS Code + Copilot Guide](tools/vscode-guide.md)** - Using sce with VS Code and GitHub Copilot
52
52
 
53
53
  ### Watch Mode Integration
54
- - **[Windsurf Guide](tools/windsurf-guide.md)** - Using kse with Windsurf (supports watch mode)
54
+ - **[Windsurf Guide](tools/windsurf-guide.md)** - Using sce with Windsurf (supports watch mode)
55
55
 
56
56
  ### Universal Integration
57
- - **[Generic AI Tools Guide](tools/generic-guide.md)** - Using kse with any AI tool
57
+ - **[Generic AI Tools Guide](tools/generic-guide.md)** - Using sce with any AI tool
58
58
 
59
59
  ---
60
60
 
@@ -86,14 +86,14 @@ Learn by example with complete Spec demonstrations:
86
86
 
87
87
  Detailed technical documentation:
88
88
 
89
- - **[Command Reference](command-reference.md)** - All kse commands with examples
89
+ - **[Command Reference](command-reference.md)** - All sce commands with examples
90
90
  - **[Environment Management Guide](environment-management-guide.md)** - Multi-environment configuration management
91
91
  - **[Multi-Repository Management Guide](multi-repo-management-guide.md)** - Managing multiple Git repositories
92
92
  - **[Value Observability Guide](value-observability-guide.md)** - KPI snapshot, baseline, trend, and gate evidence workflow
93
93
  - **[Scene Runtime Guide](scene-runtime-guide.md)** - Scene template engine, quality pipeline, ontology, and Moqui ERP integration
94
- - **[Moqui Template Core Library Playbook](moqui-template-core-library-playbook.md)** - Default-gated intake flow for absorbing Moqui capabilities into KSE templates
95
- - **[331-poc Dual-Track Integration Guide](331-poc-dual-track-integration-guide.md)** - Handoff contract and integration playbook between 331-poc and kse
96
- - **[331-poc Adaptation Roadmap](331-poc-adaptation-roadmap.md)** - Ongoing KSE-side adaptation backlog and rollout phases
94
+ - **[Moqui Template Core Library Playbook](moqui-template-core-library-playbook.md)** - Default-gated intake flow for absorbing Moqui capabilities into sce templates
95
+ - **[331-poc Dual-Track Integration Guide](331-poc-dual-track-integration-guide.md)** - Handoff contract and integration playbook between 331-poc and sce
96
+ - **[331-poc Adaptation Roadmap](331-poc-adaptation-roadmap.md)** - Ongoing sce-side adaptation backlog and rollout phases
97
97
  - **[Multi-Agent Coordination Guide](multi-agent-coordination-guide.md)** - Multi-agent parallel coordination for concurrent development
98
98
  - **[Troubleshooting](troubleshooting.md)** - Solutions to common problems
99
99
  - **[FAQ](faq.md)** - Answers to frequently asked questions
@@ -102,8 +102,8 @@ Detailed technical documentation:
102
102
 
103
103
  ## 📋 Additional Guides
104
104
 
105
- - **[Adoption Guide](adoption-guide.md)** - Adopting kse in existing projects
106
- - **[Upgrade Guide](upgrade-guide.md)** - Upgrading kse to newer versions
105
+ - **[Adoption Guide](adoption-guide.md)** - Adopting sce in existing projects
106
+ - **[Upgrade Guide](upgrade-guide.md)** - Upgrading sce to newer versions
107
107
  - **[Release Checklist](release-checklist.md)** - Repeatable pre-release verification flow
108
108
  - **[Release Archive](releases/README.md)** - Index of release notes and validation reports
109
109
  - **[Release Notes v1.46.2](releases/v1.46.2.md)** - Summary of value observability and onboarding improvements
@@ -112,8 +112,8 @@ Detailed technical documentation:
112
112
  - **[Multi-Repository Management Guide](multi-repo-management-guide.md)** - Managing multiple Git repositories
113
113
  - **[Scene Runtime Guide](scene-runtime-guide.md)** - Scene template engine, quality pipeline, ontology, and Moqui ERP integration
114
114
  - **[Multi-Agent Coordination Guide](multi-agent-coordination-guide.md)** - Multi-agent parallel coordination for concurrent development
115
- - **[Developer Guide](developer-guide.md)** - Contributing to kse development
116
- - **[Architecture](architecture.md)** - kse system architecture
115
+ - **[Developer Guide](developer-guide.md)** - Contributing to sce development
116
+ - **[Architecture](architecture.md)** - sce system architecture
117
117
 
118
118
  ---
119
119
 
@@ -139,7 +139,7 @@ Detailed technical documentation:
139
139
  4. [Troubleshooting](troubleshooting.md) - Solve problems
140
140
 
141
141
  ### For Advanced Users
142
- 1. [Developer Guide](developer-guide.md) - Contribute to kse
142
+ 1. [Developer Guide](developer-guide.md) - Contribute to sce
143
143
  2. [Architecture](architecture.md) - Understand internals
144
144
  3. [Manual Workflows Guide](manual-workflows-guide.md) - Advanced workflows
145
145
 
@@ -21,10 +21,10 @@ This guide helps users transition from the old interactive adoption mode to the
21
21
 
22
22
  ### Old Behavior (v1.8.x and earlier)
23
23
 
24
- The `kse adopt` command was **interactive** and required user input:
24
+ The `sce adopt` command was **interactive** and required user input:
25
25
 
26
26
  ```bash
27
- $ kse adopt
27
+ $ sce adopt
28
28
 
29
29
  📦 Analyzing project structure...
30
30
 
@@ -51,12 +51,12 @@ $ kse adopt
51
51
 
52
52
  ### New Behavior (v1.9.0+)
53
53
 
54
- The `kse adopt` command is now **smart and automatic**:
54
+ The `sce adopt` command is now **smart and automatic**:
55
55
 
56
56
  ```bash
57
- $ kse adopt
57
+ $ sce adopt
58
58
 
59
- 🔥 Kiro Spec Engine - Project Adoption
59
+ 🔥 Scene Capability Engine - Project Adoption
60
60
 
61
61
  📦 Analyzing project structure... ✅
62
62
  📋 Creating adoption plan... ✅
@@ -82,7 +82,7 @@ Adoption Plan:
82
82
  Preserved: 3 specs, 2 custom files
83
83
 
84
84
  💡 Your original files are safely backed up.
85
- To restore: kse rollback backup-20260128-143022
85
+ To restore: sce rollback backup-20260128-143022
86
86
  ```
87
87
 
88
88
  **Characteristics**:
@@ -162,15 +162,15 @@ Automatic resolution based on file type:
162
162
  **Old Behavior**:
163
163
  ```bash
164
164
  # Backup was optional
165
- kse adopt # No backup
166
- kse adopt --backup # With backup
165
+ sce adopt # No backup
166
+ sce adopt --backup # With backup
167
167
  ```
168
168
 
169
169
  **New Behavior**:
170
170
  ```bash
171
171
  # Backup is mandatory
172
- kse adopt # Always creates backup
173
- kse adopt --no-backup # Requires confirmation (dangerous)
172
+ sce adopt # Always creates backup
173
+ sce adopt --no-backup # Requires confirmation (dangerous)
174
174
  ```
175
175
 
176
176
  ---
@@ -179,26 +179,26 @@ kse adopt --no-backup # Requires confirmation (dangerous)
179
179
 
180
180
  ### For Individual Users
181
181
 
182
- **Step 1**: Upgrade KSE
182
+ **Step 1**: Upgrade sce
183
183
  ```bash
184
- npm install -g kiro-spec-engine@latest
184
+ npm install -g scene-capability-engine@latest
185
185
  ```
186
186
 
187
187
  **Step 2**: Test with dry-run (optional)
188
188
  ```bash
189
189
  cd your-project
190
- kse adopt --dry-run
190
+ sce adopt --dry-run
191
191
  ```
192
192
 
193
193
  **Step 3**: Run adoption
194
194
  ```bash
195
- kse adopt
195
+ sce adopt
196
196
  ```
197
197
 
198
198
  **Step 4**: Verify results
199
199
  ```bash
200
- kse status
201
- kse version-info
200
+ sce status
201
+ sce version-info
202
202
  ```
203
203
 
204
204
  ### For Teams
@@ -211,8 +211,8 @@ kse version-info
211
211
  **Step 2**: Test on non-critical project
212
212
  ```bash
213
213
  cd test-project
214
- kse adopt --dry-run
215
- kse adopt
214
+ sce adopt --dry-run
215
+ sce adopt
216
216
  ```
217
217
 
218
218
  **Step 3**: Roll out gradually
@@ -232,16 +232,16 @@ kse adopt
232
232
  **Old Script**:
233
233
  ```bash
234
234
  # Old: Required --auto flag
235
- kse adopt --auto
235
+ sce adopt --auto
236
236
  ```
237
237
 
238
238
  **New Script**:
239
239
  ```bash
240
240
  # New: No flag needed (already automatic)
241
- kse adopt
241
+ sce adopt
242
242
 
243
243
  # Or with verbose logging
244
- kse adopt --verbose
244
+ sce adopt --verbose
245
245
  ```
246
246
 
247
247
  ---
@@ -261,7 +261,7 @@ You might prefer interactive mode if:
261
261
  Simply add the `--interactive` flag:
262
262
 
263
263
  ```bash
264
- kse adopt --interactive
264
+ sce adopt --interactive
265
265
  ```
266
266
 
267
267
  This enables the old behavior:
@@ -272,7 +272,7 @@ This enables the old behavior:
272
272
  ### Example
273
273
 
274
274
  ```bash
275
- $ kse adopt --interactive
275
+ $ sce adopt --interactive
276
276
 
277
277
  📦 Analyzing project structure...
278
278
 
@@ -301,7 +301,7 @@ $ kse adopt --interactive
301
301
 
302
302
  **A**: Use the `--interactive` flag:
303
303
  ```bash
304
- kse adopt --interactive
304
+ sce adopt --interactive
305
305
  ```
306
306
 
307
307
  ---
@@ -320,12 +320,12 @@ kse adopt --interactive
320
320
 
321
321
  **A**: You can easily rollback:
322
322
  ```bash
323
- kse rollback backup-20260128-143022
323
+ sce rollback backup-20260128-143022
324
324
  ```
325
325
 
326
326
  Then use interactive mode:
327
327
  ```bash
328
- kse adopt --interactive
328
+ sce adopt --interactive
329
329
  ```
330
330
 
331
331
  ---
@@ -334,7 +334,7 @@ kse adopt --interactive
334
334
 
335
335
  **A**: Use dry-run mode:
336
336
  ```bash
337
- kse adopt --dry-run
337
+ sce adopt --dry-run
338
338
  ```
339
339
 
340
340
  ---
@@ -343,7 +343,7 @@ kse adopt --dry-run
343
343
 
344
344
  **A**: Yes, use the `--force` flag:
345
345
  ```bash
346
- kse adopt --force
346
+ sce adopt --force
347
347
  ```
348
348
 
349
349
  This will:
@@ -375,7 +375,7 @@ This will:
375
375
 
376
376
  For more details, use verbose mode:
377
377
  ```bash
378
- kse adopt --verbose
378
+ sce adopt --verbose
379
379
  ```
380
380
 
381
381
  ---
@@ -384,7 +384,7 @@ kse adopt --verbose
384
384
 
385
385
  **A**: Not recommended, but possible:
386
386
  ```bash
387
- kse adopt --no-backup
387
+ sce adopt --no-backup
388
388
  ```
389
389
 
390
390
  ⚠️ **Warning**: This is dangerous and requires confirmation.
@@ -403,12 +403,12 @@ kse adopt --no-backup
403
403
 
404
404
  **Old**:
405
405
  ```bash
406
- kse adopt --auto
406
+ sce adopt --auto
407
407
  ```
408
408
 
409
409
  **New**:
410
410
  ```bash
411
- kse adopt
411
+ sce adopt
412
412
  ```
413
413
 
414
414
  ---
@@ -430,7 +430,7 @@ Problem: Unable to create backup
430
430
  Solutions:
431
431
  1. Free up disk space
432
432
  2. Check permissions
433
- 3. Run kse doctor
433
+ 3. Run sce doctor
434
434
  ```
435
435
 
436
436
  ---
@@ -442,7 +442,7 @@ Solutions:
442
442
  ```bash
443
443
  for dir in project1 project2 project3; do
444
444
  cd $dir
445
- kse adopt
445
+ sce adopt
446
446
  cd ..
447
447
  done
448
448
  ```
@@ -452,7 +452,7 @@ done
452
452
  ### Q: How do I report issues?
453
453
 
454
454
  **A**:
455
- 1. Run with verbose mode: `kse adopt --verbose`
455
+ 1. Run with verbose mode: `sce adopt --verbose`
456
456
  2. Check the logs
457
457
  3. Report at: https://github.com/heguangyong/scene-capability-engine/issues
458
458
 
@@ -464,7 +464,7 @@ done
464
464
 
465
465
  **Solution**: Use interactive mode:
466
466
  ```bash
467
- kse adopt --interactive
467
+ sce adopt --interactive
468
468
  ```
469
469
 
470
470
  ---
@@ -473,7 +473,7 @@ kse adopt --interactive
473
473
 
474
474
  **Solution**: Use verbose mode:
475
475
  ```bash
476
- kse adopt --verbose
476
+ sce adopt --verbose
477
477
  ```
478
478
 
479
479
  ---
@@ -482,7 +482,7 @@ kse adopt --verbose
482
482
 
483
483
  **Solution**: Use rollback:
484
484
  ```bash
485
- kse rollback backup-20260128-143022
485
+ sce rollback backup-20260128-143022
486
486
  ```
487
487
 
488
488
  ---
@@ -493,7 +493,7 @@ kse rollback backup-20260128-143022
493
493
 
494
494
  1. Rollback immediately:
495
495
  ```bash
496
- kse rollback backup-20260128-143022
496
+ sce rollback backup-20260128-143022
497
497
  ```
498
498
 
499
499
  2. Report the issue:
@@ -510,8 +510,8 @@ kse rollback backup-20260128-143022
510
510
  Always test on a non-critical project first:
511
511
  ```bash
512
512
  cd test-project
513
- kse adopt --dry-run
514
- kse adopt
513
+ sce adopt --dry-run
514
+ sce adopt
515
515
  ```
516
516
 
517
517
  ### 2. Use Version Control
@@ -519,8 +519,8 @@ kse adopt
519
519
  Commit before adopting:
520
520
  ```bash
521
521
  git add -A
522
- git commit -m "Before KSE v1.9.0 adoption"
523
- kse adopt
522
+ git commit -m "Before sce v1.9.0 adoption"
523
+ sce adopt
524
524
  ```
525
525
 
526
526
  ### 3. Keep Backups
@@ -535,8 +535,8 @@ ls .kiro/backups/
535
535
 
536
536
  After adoption, verify:
537
537
  ```bash
538
- kse status
539
- kse version-info
538
+ sce status
539
+ sce version-info
540
540
  npm test # If you have tests
541
541
  ```
542
542
 
@@ -567,22 +567,22 @@ If you customize files, document it:
567
567
  For most users:
568
568
  ```bash
569
569
  # Just run it!
570
- kse adopt
570
+ sce adopt
571
571
  ```
572
572
 
573
573
  For cautious users:
574
574
  ```bash
575
575
  # Preview first
576
- kse adopt --dry-run
576
+ sce adopt --dry-run
577
577
 
578
578
  # Then apply
579
- kse adopt
579
+ sce adopt
580
580
  ```
581
581
 
582
582
  For advanced users:
583
583
  ```bash
584
584
  # Use interactive mode
585
- kse adopt --interactive
585
+ sce adopt --interactive
586
586
  ```
587
587
 
588
588
  ---
@@ -590,8 +590,8 @@ kse adopt --interactive
590
590
  ## Getting Help
591
591
 
592
592
  - **Documentation**: [Adoption Guide](adoption-guide.md)
593
- - **System Check**: `kse doctor`
594
- - **Version Info**: `kse version-info`
593
+ - **System Check**: `sce doctor`
594
+ - **Version Info**: `sce version-info`
595
595
  - **Issues**: https://github.com/heguangyong/scene-capability-engine/issues
596
596
 
597
597
  ---