scene-capability-engine 3.0.1 → 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 +233 -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 +3 -5
  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
@@ -2,11 +2,11 @@
2
2
 
3
3
  ## Overview
4
4
 
5
- When adopting kiro-spec-engine (kse) into a project that already has steering files in `.kiro/steering/`, you must choose a steering strategy. This is because Kiro IDE loads all files in the steering directory, and having both kse steering rules and your project's custom steering rules can cause conflicts.
5
+ When adopting scene-capability-engine (sce) into a project that already has steering files in `.kiro/steering/`, you must choose a steering strategy. This is because AI IDE loads all files in the steering directory, and having both sce steering rules and your project's custom steering rules can cause conflicts.
6
6
 
7
7
  ## Why Steering Exclusivity?
8
8
 
9
- Kiro IDE automatically loads all Markdown files in `.kiro/steering/` as AI behavior rules. If you have both kse steering files and your project's custom steering files, the AI will try to follow both sets of rules, which can lead to:
9
+ AI IDE automatically loads all Markdown files in `.kiro/steering/` as AI behavior rules. If you have both sce steering files and your project's custom steering files, the AI will try to follow both sets of rules, which can lead to:
10
10
 
11
11
  - Conflicting instructions
12
12
  - Unpredictable AI behavior
@@ -16,16 +16,16 @@ Therefore, you must choose **one** set of steering rules to use.
16
16
 
17
17
  ## Steering Strategies
18
18
 
19
- ### Strategy 1: Use kse Steering (Recommended for New Users)
19
+ ### Strategy 1: Use sce Steering (Recommended for New Users)
20
20
 
21
21
  **When to choose:**
22
- - You're new to kse and want to use the recommended steering rules
22
+ - You're new to sce and want to use the recommended steering rules
23
23
  - You don't have critical custom steering rules
24
- - You want the full kse experience with optimized AI behavior
24
+ - You want the full sce experience with optimized AI behavior
25
25
 
26
26
  **What happens:**
27
27
  1. Your existing steering files are backed up to `.kiro/backups/steering-{timestamp}/`
28
- 2. kse steering template files are installed to `.kiro/steering/`
28
+ 2. sce steering template files are installed to `.kiro/steering/`
29
29
  3. The backup ID is saved in `.kiro/adoption-config.json`
30
30
  4. You can rollback if needed
31
31
 
@@ -39,34 +39,34 @@ Therefore, you must choose **one** set of steering rules to use.
39
39
 
40
40
  **When to choose:**
41
41
  - You have custom steering rules that are critical to your project
42
- - You want to integrate kse without changing your AI behavior rules
42
+ - You want to integrate sce without changing your AI behavior rules
43
43
  - You're experienced with steering files and want full control
44
44
 
45
45
  **What happens:**
46
46
  1. Your existing steering files are preserved
47
- 2. kse steering files are **not** installed
47
+ 2. sce steering files are **not** installed
48
48
  3. The choice is documented in `.kiro/adoption-config.json`
49
- 4. You can manually integrate kse steering concepts if desired
49
+ 4. You can manually integrate sce steering concepts if desired
50
50
 
51
51
  **Trade-offs:**
52
- - You won't get kse's optimized AI behavior out of the box
53
- - You'll need to manually add kse-specific steering rules if needed
54
- - Spec workflow may not work as smoothly without kse steering
52
+ - You won't get sce's optimized AI behavior out of the box
53
+ - You'll need to manually add sce-specific steering rules if needed
54
+ - Spec workflow may not work as smoothly without sce steering
55
55
 
56
56
  ## Adoption Flow
57
57
 
58
58
  ```
59
- kse adopt
59
+ sce adopt
60
60
 
61
61
  Detect existing steering files
62
62
 
63
- ├─ No steering files → Install kse steering (default)
63
+ ├─ No steering files → Install sce steering (default)
64
64
 
65
65
  └─ Steering files found → Prompt for strategy
66
66
 
67
- ├─ use-kse → Backup existing → Install kse steering
67
+ ├─ use-kse → Backup existing → Install sce steering
68
68
 
69
- └─ use-project → Keep existing → Skip kse steering
69
+ └─ use-project → Keep existing → Skip sce steering
70
70
  ```
71
71
 
72
72
  ## Rollback
@@ -75,19 +75,19 @@ If you chose "use-kse" and want to restore your original steering files:
75
75
 
76
76
  ```bash
77
77
  # List available backups
78
- kse rollback --list
78
+ sce rollback --list
79
79
 
80
80
  # Restore from backup
81
- kse rollback {backup-id}
81
+ sce rollback {backup-id}
82
82
  ```
83
83
 
84
84
  Or manually restore from `.kiro/backups/steering-{timestamp}/`.
85
85
 
86
86
  ## Manual Integration
87
87
 
88
- If you chose "use-project" but want to incorporate kse steering concepts:
88
+ If you chose "use-project" but want to incorporate sce steering concepts:
89
89
 
90
- 1. Review kse steering templates in `template/.kiro/steering/`
90
+ 1. Review sce steering templates in `template/.kiro/steering/`
91
91
  2. Identify useful concepts (Spec workflow, Ultrawork principles, etc.)
92
92
  3. Manually merge relevant sections into your steering files
93
93
  4. Test with a sample Spec to ensure compatibility
@@ -109,20 +109,20 @@ Your steering strategy choice is saved in `.kiro/adoption-config.json`:
109
109
 
110
110
  ## Best Practices
111
111
 
112
- ### For New kse Users
112
+ ### For New sce Users
113
113
 
114
114
  1. **Choose "use-kse"** to get the full experience
115
- 2. Review the installed steering files to understand kse workflow
115
+ 2. Review the installed steering files to understand sce workflow
116
116
  3. Customize `ENVIRONMENT.md` for your project specifics
117
117
  4. Update `CURRENT_CONTEXT.md` as you work on different Specs
118
118
 
119
119
  ### For Experienced Users
120
120
 
121
121
  1. **Choose "use-project"** if you have mature steering rules
122
- 2. Review kse steering templates for useful patterns
122
+ 2. Review sce steering templates for useful patterns
123
123
  3. Consider creating a hybrid approach:
124
124
  - Keep your core steering rules
125
- - Add kse-specific rules in separate files
125
+ - Add sce-specific rules in separate files
126
126
  - Use file naming to control load order (e.g., `00-core.md`, `10-kse.md`)
127
127
 
128
128
  ### For Teams
@@ -138,20 +138,20 @@ Your steering strategy choice is saved in `.kiro/adoption-config.json`:
138
138
 
139
139
  **Solution:**
140
140
  - Check which steering strategy you chose: `cat .kiro/adoption-config.json`
141
- - If "use-kse", verify kse steering files are present
142
- - If "use-project", ensure your steering files are compatible with kse
141
+ - If "use-kse", verify sce steering files are present
142
+ - If "use-project", ensure your steering files are compatible with sce
143
143
 
144
144
  ### Problem: Want to switch strategies after adoption
145
145
 
146
146
  **Solution:**
147
147
  1. If currently "use-kse":
148
148
  ```bash
149
- kse rollback {steering-backup-id}
149
+ sce rollback {steering-backup-id}
150
150
  ```
151
151
 
152
152
  2. If currently "use-project":
153
153
  - Manually backup your steering files
154
- - Copy kse templates from `template/.kiro/steering/`
154
+ - Copy sce templates from `template/.kiro/steering/`
155
155
  - Update `.kiro/adoption-config.json`
156
156
 
157
157
  ### Problem: Lost steering backup
@@ -163,21 +163,21 @@ Your steering strategy choice is saved in `.kiro/adoption-config.json`:
163
163
 
164
164
  ## FAQ
165
165
 
166
- **Q: Can I use both kse and project steering files?**
166
+ **Q: Can I use both sce and project steering files?**
167
167
 
168
- A: No, due to Kiro IDE's behavior. You must choose one set of rules.
168
+ A: No, due to AI IDE's behavior. You must choose one set of rules.
169
169
 
170
- **Q: Will my Specs work without kse steering?**
170
+ **Q: Will my Specs work without sce steering?**
171
171
 
172
- A: Yes, but the AI may not follow kse workflow conventions as closely.
172
+ A: Yes, but the AI may not follow sce workflow conventions as closely.
173
173
 
174
- **Q: Can I modify kse steering files after installation?**
174
+ **Q: Can I modify sce steering files after installation?**
175
175
 
176
- A: Yes! kse steering files are templates. Customize them for your project.
176
+ A: Yes! sce steering files are templates. Customize them for your project.
177
177
 
178
178
  **Q: What if I don't have any steering files?**
179
179
 
180
- A: kse will automatically install its steering files (no choice needed).
180
+ A: sce will automatically install its steering files (no choice needed).
181
181
 
182
182
  **Q: Can I switch strategies later?**
183
183
 
@@ -187,7 +187,7 @@ A: Yes, but you'll need to manually manage the steering files and update the con
187
187
 
188
188
  - [Adoption Guide](./adoption-guide.md) - Complete adoption workflow
189
189
  - [Spec Workflow Guide](../.kiro/specs/SPEC_WORKFLOW_GUIDE.md) - How to use Specs
190
- - [Steering Files](../.kiro/steering/) - kse steering templates
190
+ - [Steering Files](../.kiro/steering/) - sce steering templates
191
191
 
192
192
  ---
193
193
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  ## Overview
4
4
 
5
- This guide explains how to effectively collaborate on kse projects with your team, covering version control strategies, Spec sharing, and multi-user workflows.
5
+ This guide explains how to effectively collaborate on sce projects with your team, covering version control strategies, Spec sharing, and multi-user workflows.
6
6
 
7
7
  ---
8
8
 
@@ -10,7 +10,7 @@ This guide explains how to effectively collaborate on kse projects with your tea
10
10
 
11
11
  ### What to Commit
12
12
 
13
- kse uses a **layered .gitignore strategy** to balance team collaboration and personal workflow:
13
+ sce uses a **layered .gitignore strategy** to balance team collaboration and personal workflow:
14
14
 
15
15
  #### ✅ DO Commit (Team Shared)
16
16
 
@@ -78,15 +78,15 @@ kse uses a **layered .gitignore strategy** to balance team collaboration and per
78
78
  # Developer A
79
79
  git clone <repo>
80
80
  cd project
81
- npm install -g kiro-spec-engine
82
- kse adopt
81
+ npm install -g scene-capability-engine
82
+ sce adopt
83
83
  .kiro/create-workspace.bat alice
84
84
 
85
85
  # Developer B
86
86
  git clone <repo>
87
87
  cd project
88
- npm install -g kiro-spec-engine
89
- kse adopt
88
+ npm install -g scene-capability-engine
89
+ sce adopt
90
90
  .kiro/create-workspace.bat bob
91
91
  ```
92
92
 
@@ -97,7 +97,7 @@ kse adopt
97
97
  .kiro/switch-workspace.bat alice
98
98
 
99
99
  # Work on your tasks
100
- kse status
100
+ sce status
101
101
  # ... make changes ...
102
102
 
103
103
  # Commit Spec changes (shared)
@@ -119,7 +119,7 @@ git commit -m "feat: complete task 3.2 in Spec 15-00"
119
119
 
120
120
  ```bash
121
121
  # Create new Spec
122
- kse workflows create user-authentication
122
+ sce workflows create user-authentication
123
123
 
124
124
  # Edit requirements, design, tasks
125
125
  # ... work on Spec documents ...
@@ -137,7 +137,7 @@ git push
137
137
  git pull
138
138
 
139
139
  # Check available Specs
140
- kse status
140
+ sce status
141
141
 
142
142
  # Read Spec documents
143
143
  cat .kiro/specs/21-00-user-authentication/requirements.md
@@ -191,17 +191,17 @@ project-root/
191
191
  git clone <repo>
192
192
  cd project
193
193
 
194
- # Install kse
195
- npm install -g kiro-spec-engine
196
- kse adopt
194
+ # Install sce
195
+ npm install -g scene-capability-engine
196
+ sce adopt
197
197
 
198
198
  # Register environments from templates
199
- kse env register config/env-local.json
200
- kse env register config/env-staging.json
201
- kse env register config/env-production.json
199
+ sce env register config/env-local.json
200
+ sce env register config/env-staging.json
201
+ sce env register config/env-production.json
202
202
 
203
203
  # Switch to local environment
204
- kse env switch local
204
+ sce env switch local
205
205
  ```
206
206
 
207
207
  **Benefits**:
@@ -267,7 +267,7 @@ git add .kiro/specs/22-00-feature-name/reports/performance-analysis.md
267
267
 
268
268
  ```bash
269
269
  # 1. Create Spec
270
- kse workflows create payment-integration
270
+ sce workflows create payment-integration
271
271
 
272
272
  # 2. Write requirements
273
273
  # Edit .kiro/specs/23-00-payment-integration/requirements.md
@@ -294,7 +294,7 @@ git push
294
294
  git pull
295
295
 
296
296
  # 2. Review Spec
297
- kse status
297
+ sce status
298
298
  cat .kiro/specs/23-00-payment-integration/requirements.md
299
299
  cat .kiro/specs/23-00-payment-integration/design.md
300
300
 
@@ -347,18 +347,18 @@ cat .kiro/specs/23-00-payment-integration/tasks.md
347
347
  # 1. Clone and setup
348
348
  git clone <repo>
349
349
  cd project
350
- npm install -g kiro-spec-engine
351
- kse adopt
350
+ npm install -g scene-capability-engine
351
+ sce adopt
352
352
 
353
353
  # 2. Create personal workspace
354
354
  .kiro/create-workspace.bat john
355
355
 
356
356
  # 3. Register environments
357
- kse env register config/env-local.json
358
- kse env switch local
357
+ sce env register config/env-local.json
358
+ sce env switch local
359
359
 
360
360
  # 4. Review project Specs
361
- kse status
361
+ sce status
362
362
  # See all features and their status
363
363
 
364
364
  # 5. Pick a task
@@ -2,7 +2,7 @@
2
2
 
3
3
  ## Overview
4
4
 
5
- This document defines the testing strategy for kse (Kiro Spec Engine) to balance code quality with CI/CD performance.
5
+ This document defines the testing strategy for sce (Scene Capability Engine) to balance code quality with CI/CD performance.
6
6
 
7
7
  ## Test Categories
8
8
 
@@ -269,4 +269,4 @@ npm run test:coverage
269
269
 
270
270
  **Version**: v1.0
271
271
  **Last Updated**: 2026-01-29
272
- **Maintained by**: kse Development Team
272
+ **Maintained by**: sce Development Team
@@ -1,6 +1,6 @@
1
- # Using kse with Claude Code
1
+ # Using sce with Claude Code
2
2
 
3
- > Complete guide to integrating kse with Claude Code for AI-assisted development
3
+ > Complete guide to integrating sce with Claude Code for AI-assisted development
4
4
 
5
5
  ---
6
6
 
@@ -16,9 +16,9 @@
16
16
 
17
17
  **Claude Code** is Anthropic's AI coding assistant with a large context window (200K tokens), excellent code understanding, and conversational development capabilities.
18
18
 
19
- **kse integration with Claude** uses the **Manual Export** mode, where you export Spec context and paste it into Claude conversations.
19
+ **sce integration with Claude** uses the **Manual Export** mode, where you export Spec context and paste it into Claude conversations.
20
20
 
21
- ### Why Use kse with Claude?
21
+ ### Why Use sce with Claude?
22
22
 
23
23
  - ✅ **Large context window** - Can handle entire Specs at once
24
24
  - ✅ **Excellent understanding** - Claude deeply understands requirements and design
@@ -32,8 +32,8 @@
32
32
  **Mode:** Manual Export
33
33
 
34
34
  **How it works:**
35
- 1. Create Specs in kse (requirements, design, tasks)
36
- 2. Export context: `kse context export spec-name`
35
+ 1. Create Specs in sce (requirements, design, tasks)
36
+ 2. Export context: `sce context export spec-name`
37
37
  3. Copy entire context and paste into Claude conversation
38
38
  4. Claude implements features based on your Spec
39
39
  5. Update task status manually in tasks.md
@@ -45,8 +45,8 @@
45
45
  ### Prerequisites
46
46
 
47
47
  - **Claude Code access** ([Get access](https://claude.ai/))
48
- - **kse installed** globally (`npm install -g kiro-spec-engine`)
49
- - **Project adopted** by kse (`kse adopt`)
48
+ - **sce installed** globally (`npm install -g scene-capability-engine`)
49
+ - **Project adopted** by sce (`sce adopt`)
50
50
 
51
51
  ### Step 1: Create Shell Alias (Recommended)
52
52
 
@@ -54,10 +54,10 @@ Add to your `~/.bashrc` or `~/.zshrc`:
54
54
 
55
55
  ```bash
56
56
  # Quick export and copy to clipboard
57
- alias kse-clip='kse context export $1 && cat .kiro/specs/$1/context-export.md | pbcopy && echo "✅ Context copied to clipboard"'
57
+ alias sce-clip='sce context export $1 && cat .kiro/specs/$1/context-export.md | pbcopy && echo "✅ Context copied to clipboard"'
58
58
 
59
59
  # Windows PowerShell (add to $PROFILE)
60
- function kse-clip { kse context export $args[0]; Get-Content ".kiro\specs\$($args[0])\context-export.md" | Set-Clipboard; Write-Host "✅ Context copied to clipboard" }
60
+ function sce-clip { sce context export $args[0]; Get-Content ".kiro\specs\$($args[0])\context-export.md" | Set-Clipboard; Write-Host "✅ Context copied to clipboard" }
61
61
  ```
62
62
 
63
63
  ---
@@ -70,8 +70,8 @@ function kse-clip { kse context export $args[0]; Get-Content ".kiro\specs\$($arg
70
70
 
71
71
  **Step 1: Export and copy context**
72
72
  ```bash
73
- kse context export 01-00-user-login
74
- kse-clip 01-00-user-login # Or manually copy
73
+ sce context export 01-00-user-login
74
+ sce-clip 01-00-user-login # Or manually copy
75
75
  ```
76
76
 
77
77
  **Step 2: Start new Claude conversation**
@@ -116,7 +116,7 @@ Edit `.kiro/specs/01-00-user-login/tasks.md`:
116
116
 
117
117
  **Step 1: Generate task-specific prompt**
118
118
  ```bash
119
- kse prompt generate 01-00-user-login 2.1 --tool=claude-code
119
+ sce prompt generate 01-00-user-login 2.1 --tool=claude-code
120
120
  ```
121
121
 
122
122
  **Step 2: Copy and paste into Claude**
@@ -136,9 +136,9 @@ Please implement this task following the design document.
136
136
 
137
137
  **1. Create and prepare Spec**
138
138
  ```bash
139
- kse spec bootstrap --name 01-00-user-login --non-interactive
139
+ sce spec bootstrap --name 01-00-user-login --non-interactive
140
140
  # Edit requirements.md, design.md, tasks.md
141
- kse-clip 01-00-user-login
141
+ sce-clip 01-00-user-login
142
142
  ```
143
143
 
144
144
  **2. Start Claude conversation**
@@ -507,7 +507,7 @@ Please implement exactly as specified."
507
507
 
508
508
  **Solution:** Use task-specific prompts
509
509
  ```bash
510
- kse prompt generate 01-00-user-login 2.1 --tool=claude-code --max-length=10000
510
+ sce prompt generate 01-00-user-login 2.1 --tool=claude-code --max-length=10000
511
511
  ```
512
512
 
513
513
  ### Issue: Lost context in long conversation
@@ -559,7 +559,7 @@ Please fix the implementation."
559
559
  ### With Code Review
560
560
  ```
561
561
  # Share context with reviewer
562
- kse context export 01-00-user-login
562
+ sce context export 01-00-user-login
563
563
 
564
564
  # Reviewer can see:
565
565
  # - What was supposed to be built (requirements)
@@ -609,18 +609,18 @@ kse context export 01-00-user-login
609
609
 
610
610
  ## Related Documentation
611
611
 
612
- - **[Quick Start Guide](../quick-start.md)** - Get started with kse
612
+ - **[Quick Start Guide](../quick-start.md)** - Get started with sce
613
613
  - **[Integration Modes](../integration-modes.md)** - Understanding integration modes
614
614
  - **[Spec Workflow](../spec-workflow.md)** - Creating effective Specs
615
- - **[Command Reference](../command-reference.md)** - All kse commands
615
+ - **[Command Reference](../command-reference.md)** - All sce commands
616
616
 
617
617
  ---
618
618
 
619
619
  ## Summary
620
620
 
621
- **Claude + kse workflow:**
622
- 1. Create Spec in kse (requirements, design, tasks)
623
- 2. Export context: `kse context export spec-name`
621
+ **Claude + sce workflow:**
622
+ 1. Create Spec in sce (requirements, design, tasks)
623
+ 2. Export context: `sce context export spec-name`
624
624
  3. Start fresh Claude conversation
625
625
  4. Paste complete context
626
626
  5. Implement tasks iteratively
@@ -639,11 +639,11 @@ kse context export 01-00-user-login
639
639
  - Reference design document explicitly
640
640
  - Review all generated code
641
641
 
642
- **Start using kse with Claude:** 🚀
642
+ **Start using sce with Claude:** 🚀
643
643
  ```bash
644
- kse adopt
645
- kse spec bootstrap --name 01-00-my-feature --non-interactive
646
- kse-clip 01-00-my-feature
644
+ sce adopt
645
+ sce spec bootstrap --name 01-00-my-feature --non-interactive
646
+ sce-clip 01-00-my-feature
647
647
  # Open Claude and paste context
648
648
  ```
649
649
 
@@ -1,6 +1,6 @@
1
- # Using kse with Cursor
1
+ # Using sce with Cursor
2
2
 
3
- > Complete guide to integrating kse with Cursor IDE for AI-assisted development
3
+ > Complete guide to integrating sce with Cursor IDE for AI-assisted development
4
4
 
5
5
  ---
6
6
 
@@ -16,9 +16,9 @@
16
16
 
17
17
  **Cursor** is an AI-powered IDE built on VS Code that provides intelligent code completion, chat-based coding, and AI pair programming through Composer mode.
18
18
 
19
- **kse integration with Cursor** uses the **Manual Export** mode, where you export Spec context and provide it to Cursor's AI features (Chat, Composer, or inline suggestions).
19
+ **sce integration with Cursor** uses the **Manual Export** mode, where you export Spec context and provide it to Cursor's AI features (Chat, Composer, or inline suggestions).
20
20
 
21
- ### Why Use kse with Cursor?
21
+ ### Why Use sce with Cursor?
22
22
 
23
23
  - ✅ **Structured context** - Cursor understands your requirements and design
24
24
  - ✅ **Better code generation** - AI follows your architecture decisions
@@ -32,8 +32,8 @@
32
32
  **Mode:** Manual Export
33
33
 
34
34
  **How it works:**
35
- 1. You create Specs in kse (requirements, design, tasks)
36
- 2. You export context using `kse context export`
35
+ 1. You create Specs in sce (requirements, design, tasks)
36
+ 2. You export context using `sce context export`
37
37
  3. You provide context to Cursor (Chat, Composer, or .cursorrules)
38
38
  4. Cursor generates code based on your Spec
39
39
  5. You update task status in tasks.md
@@ -45,17 +45,17 @@
45
45
  ### Prerequisites
46
46
 
47
47
  - **Cursor IDE** installed ([Download](https://cursor.sh/))
48
- - **kse** installed globally (`npm install -g kiro-spec-engine`)
49
- - **Project adopted** by kse (`kse adopt`)
48
+ - **sce** installed globally (`npm install -g scene-capability-engine`)
49
+ - **Project adopted** by sce (`sce adopt`)
50
50
 
51
- ### Step 1: Configure Cursor for kse
51
+ ### Step 1: Configure Cursor for sce
52
52
 
53
53
  Create a `.cursorrules` file in your project root:
54
54
 
55
55
  ```markdown
56
56
  # Project Rules
57
57
 
58
- This project uses kse (Kiro Spec Engine) for spec-driven development.
58
+ This project uses sce (Scene Capability Engine) for spec-driven development.
59
59
 
60
60
  ## Spec Location
61
61
  All Specs are in `.kiro/specs/` directory.
@@ -87,10 +87,10 @@ Add to your `~/.bashrc` or `~/.zshrc`:
87
87
 
88
88
  ```bash
89
89
  # Quick export and copy to clipboard
90
- alias kse-clip='kse context export $1 && cat .kiro/specs/$1/context-export.md | pbcopy && echo "✅ Context copied to clipboard"'
90
+ alias sce-clip='sce context export $1 && cat .kiro/specs/$1/context-export.md | pbcopy && echo "✅ Context copied to clipboard"'
91
91
 
92
92
  # Generate task-specific prompt
93
- alias kse-task='kse prompt generate $1 $2 --tool=cursor'
93
+ alias sce-task='sce prompt generate $1 $2 --tool=cursor'
94
94
  ```
95
95
 
96
96
  Reload your shell:
@@ -108,7 +108,7 @@ source ~/.bashrc # or source ~/.zshrc
108
108
 
109
109
  **Step 1: Export context**
110
110
  ```bash
111
- kse context export 01-00-user-login
111
+ sce context export 01-00-user-login
112
112
  ```
113
113
 
114
114
  **Step 2: Copy context**
@@ -120,7 +120,7 @@ cat .kiro/specs/01-00-user-login/context-export.md | pbcopy
120
120
  type .kiro\specs\01-00-user-login\context-export.md | clip
121
121
 
122
122
  # Or use alias
123
- kse-clip 01-00-user-login
123
+ sce-clip 01-00-user-login
124
124
  ```
125
125
 
126
126
  **Step 3: Open Cursor Composer**
@@ -156,7 +156,7 @@ Edit `.kiro/specs/01-00-user-login/tasks.md`:
156
156
 
157
157
  **Step 1: Generate task-specific prompt**
158
158
  ```bash
159
- kse prompt generate 01-00-user-login 1.1 --tool=cursor
159
+ sce prompt generate 01-00-user-login 1.1 --tool=cursor
160
160
  ```
161
161
 
162
162
  **Step 2: Open Cursor Chat**
@@ -213,13 +213,13 @@ class AuthController {
213
213
 
214
214
  **1. Create and write Spec**
215
215
  ```bash
216
- kse spec bootstrap --name 01-00-user-login --non-interactive
216
+ sce spec bootstrap --name 01-00-user-login --non-interactive
217
217
  # Edit requirements.md, design.md, tasks.md
218
218
  ```
219
219
 
220
220
  **2. Export context**
221
221
  ```bash
222
- kse-clip 01-00-user-login
222
+ sce-clip 01-00-user-login
223
223
  ```
224
224
 
225
225
  **3. Open Cursor Composer (Cmd+K)**
@@ -366,10 +366,10 @@ Implement task 1.3: Add authentication logic
366
366
  **Re-export after Spec changes:**
367
367
  ```bash
368
368
  # After editing design.md
369
- kse context export 01-00-user-login
369
+ sce context export 01-00-user-login
370
370
 
371
371
  # Copy new context
372
- kse-clip 01-00-user-login
372
+ sce-clip 01-00-user-login
373
373
 
374
374
  # Provide to Cursor again
375
375
  ```
@@ -379,7 +379,7 @@ kse-clip 01-00-user-login
379
379
  **For large Specs (>5KB context):**
380
380
  ```bash
381
381
  # Instead of exporting entire Spec
382
- kse prompt generate 01-00-user-login 1.1 --tool=cursor
382
+ sce prompt generate 01-00-user-login 1.1 --tool=cursor
383
383
 
384
384
  # Generates focused prompt for just task 1.1
385
385
  ```
@@ -458,7 +458,7 @@ Please implement exactly as specified.
458
458
 
459
459
  **Solution:** Use task-specific prompts
460
460
  ```bash
461
- kse prompt generate 01-00-user-login 1.1 --tool=cursor --max-length=5000
461
+ sce prompt generate 01-00-user-login 1.1 --tool=cursor --max-length=5000
462
462
  ```
463
463
 
464
464
  ### Issue: Cursor suggests wrong file locations
@@ -576,7 +576,7 @@ Please fix the implementation."
576
576
 
577
577
  ```bash
578
578
  # Export context for reviewer
579
- kse context export 01-00-user-login
579
+ sce context export 01-00-user-login
580
580
 
581
581
  # Share context-export.md with reviewer
582
582
  # Reviewer can see requirements and design
@@ -662,18 +662,18 @@ Please help debug and fix the issue.
662
662
 
663
663
  ## Related Documentation
664
664
 
665
- - **[Quick Start Guide](../quick-start.md)** - Get started with kse
665
+ - **[Quick Start Guide](../quick-start.md)** - Get started with sce
666
666
  - **[Integration Modes](../integration-modes.md)** - Understanding integration modes
667
667
  - **[Spec Workflow](../spec-workflow.md)** - Creating effective Specs
668
- - **[Command Reference](../command-reference.md)** - All kse commands
668
+ - **[Command Reference](../command-reference.md)** - All sce commands
669
669
 
670
670
  ---
671
671
 
672
672
  ## Summary
673
673
 
674
- **Cursor + kse workflow:**
675
- 1. Create Spec in kse (requirements, design, tasks)
676
- 2. Export context: `kse context export spec-name`
674
+ **Cursor + sce workflow:**
675
+ 1. Create Spec in sce (requirements, design, tasks)
676
+ 2. Export context: `sce context export spec-name`
677
677
  3. Use Cursor Composer (Cmd+K) or Chat (Cmd+L)
678
678
  4. Provide context and implement tasks
679
679
  5. Update tasks.md as you complete tasks
@@ -691,11 +691,11 @@ Please help debug and fix the issue.
691
691
  - Re-export context after Spec changes
692
692
  - Review all AI suggestions
693
693
 
694
- **Start using kse with Cursor:** 🚀
694
+ **Start using sce with Cursor:** 🚀
695
695
  ```bash
696
- kse adopt
697
- kse spec bootstrap --name 01-00-my-feature --non-interactive
698
- kse context export 01-00-my-feature
696
+ sce adopt
697
+ sce spec bootstrap --name 01-00-my-feature --non-interactive
698
+ sce context export 01-00-my-feature
699
699
  # Open Cursor Composer (Cmd+K) and paste context
700
700
  ```
701
701