scene-capability-engine 3.3.5 → 3.3.10

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 (241) hide show
  1. package/CHANGELOG.md +130 -78
  2. package/README.md +6 -6
  3. package/README.zh.md +6 -6
  4. package/bin/scene-capability-engine.js +129 -7
  5. package/docs/331-poc-adaptation-roadmap.md +3 -3
  6. package/docs/331-poc-dual-track-integration-guide.md +8 -8
  7. package/docs/331-poc-weekly-delivery-checklist.md +6 -6
  8. package/docs/README.md +4 -0
  9. package/docs/adopt-migration-guide.md +13 -13
  10. package/docs/adoption-guide.md +28 -28
  11. package/docs/agent-hooks-analysis.md +10 -10
  12. package/docs/architecture.md +13 -13
  13. package/docs/articles/ai-driven-development-philosophy-and-practice.en.md +3 -3
  14. package/docs/articles/ai-driven-development-philosophy-and-practice.md +3 -3
  15. package/docs/autonomous-control-guide.md +35 -35
  16. package/docs/command-reference.md +192 -153
  17. package/docs/cross-tool-guide.md +7 -7
  18. package/docs/developer-guide.md +8 -8
  19. package/docs/document-governance.md +15 -15
  20. package/docs/environment-management-guide.md +6 -6
  21. package/docs/examples/add-export-command/design.md +1 -1
  22. package/docs/faq.md +13 -13
  23. package/docs/handoff-profile-integration-guide.md +3 -3
  24. package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.json +7 -7
  25. package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.md +1 -1
  26. package/docs/integration-modes.md +12 -12
  27. package/docs/integration-philosophy.md +11 -11
  28. package/docs/interactive-customization/331-poc-sce-integration-checklist.md +24 -24
  29. package/docs/interactive-customization/README.md +43 -43
  30. package/docs/interactive-customization/business-mode-policy-baseline.json +33 -0
  31. package/docs/interactive-customization/dual-ui-mode-integration-guide.md +1 -1
  32. package/docs/interactive-customization/moqui-adapter-interface.md +2 -2
  33. package/docs/interactive-customization/moqui-copilot-integration-guide.md +1 -1
  34. package/docs/interactive-customization/moqui-interactive-template-playbook.md +4 -4
  35. package/docs/interactive-customization/phase-acceptance-evidence.md +2 -2
  36. package/docs/knowledge-management-guide.md +6 -6
  37. package/docs/manual-workflows-guide.md +4 -4
  38. package/docs/moqui-capability-matrix.md +3 -3
  39. package/docs/moqui-standard-rebuild-guide.md +8 -8
  40. package/docs/moqui-template-core-library-playbook.md +27 -27
  41. package/docs/multi-agent-coordination-guide.md +19 -19
  42. package/docs/multi-repo-management-guide.md +17 -17
  43. package/docs/quick-start-with-ai-tools.md +7 -7
  44. package/docs/quick-start.md +2 -2
  45. package/docs/release-checklist.md +4 -4
  46. package/docs/sce-business-mode-map.md +103 -0
  47. package/docs/security-governance-default-baseline.md +12 -12
  48. package/docs/spec-collaboration-guide.md +3 -3
  49. package/docs/spec-locking-guide.md +2 -2
  50. package/docs/spec-workflow.md +3 -3
  51. package/docs/starter-kit/README.md +4 -4
  52. package/docs/starter-kit/handoff-manifest.starter.json +2 -2
  53. package/docs/starter-kit/release.workflow.sample.yml +1 -1
  54. package/docs/steering-strategy-guide.md +15 -15
  55. package/docs/team-collaboration-guide.md +69 -69
  56. package/docs/testing-strategy.md +2 -2
  57. package/docs/tools/claude-guide.md +14 -4
  58. package/docs/tools/cursor-guide.md +14 -14
  59. package/docs/tools/generic-guide.md +9 -9
  60. package/docs/tools/kiro-guide.md +4 -4
  61. package/docs/tools/vscode-guide.md +13 -13
  62. package/docs/tools/windsurf-guide.md +6 -6
  63. package/docs/troubleshooting.md +22 -22
  64. package/docs/upgrade-guide.md +8 -8
  65. package/docs/value-observability-guide.md +3 -3
  66. package/docs/zh/README.md +6 -0
  67. package/docs/zh/quick-start.md +15 -15
  68. package/docs/zh/release-checklist.md +3 -3
  69. package/docs/zh/tools/claude-guide.md +16 -6
  70. package/docs/zh/tools/cursor-guide.md +11 -11
  71. package/docs/zh/tools/generic-guide.md +13 -13
  72. package/docs/zh/tools/kiro-guide.md +2 -2
  73. package/docs/zh/tools/vscode-guide.md +11 -11
  74. package/docs/zh/tools/windsurf-guide.md +11 -11
  75. package/docs/zh/value-observability-guide.md +3 -3
  76. package/lib/adoption/adoption-logger.js +1 -1
  77. package/lib/adoption/adoption-strategy.js +28 -28
  78. package/lib/adoption/backup-manager.js +3 -3
  79. package/lib/adoption/conflict-resolver.js +2 -2
  80. package/lib/adoption/detection-engine.js +8 -8
  81. package/lib/adoption/error-formatter.js +4 -4
  82. package/lib/adoption/file-classifier.js +6 -6
  83. package/lib/adoption/progress-reporter.js +1 -1
  84. package/lib/adoption/smart-orchestrator.js +10 -10
  85. package/lib/adoption/strategy-selector.js +6 -6
  86. package/lib/adoption/summary-generator.js +1 -1
  87. package/lib/adoption/template-sync.js +8 -8
  88. package/lib/auto/autonomous-engine.js +7 -7
  89. package/lib/auto/checkpoint-manager.js +1 -1
  90. package/lib/auto/close-loop-runner.js +12 -12
  91. package/lib/auto/error-recovery-manager.js +1 -1
  92. package/lib/auto/goal-decomposer.js +1 -1
  93. package/lib/auto/moqui-recovery-sequence.js +2 -2
  94. package/lib/auto/progress-tracker.js +1 -1
  95. package/lib/auto/state-manager.js +1 -1
  96. package/lib/backup/backup-system.js +10 -10
  97. package/lib/backup/selective-backup.js +4 -4
  98. package/lib/collab/agent-registry.js +2 -2
  99. package/lib/collab/contract-manager.js +1 -1
  100. package/lib/collab/coordinator.js +2 -2
  101. package/lib/collab/dependency-manager.js +1 -1
  102. package/lib/collab/integration-manager.js +1 -1
  103. package/lib/collab/metadata-manager.js +1 -1
  104. package/lib/collab/multi-agent-config.js +2 -2
  105. package/lib/collab/spec-lifecycle-manager.js +2 -2
  106. package/lib/collab/visualizer.js +1 -1
  107. package/lib/commands/adopt.js +6 -6
  108. package/lib/commands/auto.js +56 -56
  109. package/lib/commands/collab.js +2 -2
  110. package/lib/commands/docs.js +3 -3
  111. package/lib/commands/doctor.js +1 -1
  112. package/lib/commands/knowledge.js +2 -2
  113. package/lib/commands/lock.js +1 -1
  114. package/lib/commands/ops.js +1 -1
  115. package/lib/commands/orchestrate.js +3 -3
  116. package/lib/commands/rollback.js +1 -1
  117. package/lib/commands/scene.js +135 -93
  118. package/lib/commands/session.js +139 -0
  119. package/lib/commands/spec-bootstrap.js +1 -1
  120. package/lib/commands/spec-gate.js +2 -2
  121. package/lib/commands/spec-pipeline.js +1 -1
  122. package/lib/commands/status.js +4 -4
  123. package/lib/commands/steering.js +119 -0
  124. package/lib/commands/value.js +1 -1
  125. package/lib/commands/watch.js +9 -9
  126. package/lib/commands/workspace-multi.js +1 -1
  127. package/lib/context/context-exporter.js +5 -7
  128. package/lib/context/prompt-generator.js +2 -2
  129. package/lib/environment/backup-system.js +1 -1
  130. package/lib/environment/environment-manager.js +2 -2
  131. package/lib/gitignore/gitignore-backup.js +3 -3
  132. package/lib/gitignore/gitignore-detector.js +13 -13
  133. package/lib/gitignore/gitignore-integration.js +3 -3
  134. package/lib/gitignore/gitignore-transformer.js +4 -4
  135. package/lib/gitignore/layered-rules-template.js +16 -16
  136. package/lib/governance/config-manager.js +1 -1
  137. package/lib/governance/doc-reference-checker.js +4 -4
  138. package/lib/governance/execution-logger.js +1 -1
  139. package/lib/governance/file-scanner.js +3 -3
  140. package/lib/interactive-customization/moqui-interactive-adapter.js +2 -2
  141. package/lib/knowledge/knowledge-manager.js +1 -1
  142. package/lib/lock/lock-manager.js +2 -2
  143. package/lib/lock/steering-file-lock.js +5 -5
  144. package/lib/lock/task-lock-manager.js +3 -3
  145. package/lib/operations/audit-logger.js +1 -1
  146. package/lib/operations/feedback-manager.js +1 -1
  147. package/lib/operations/operations-manager.js +3 -3
  148. package/lib/operations/permission-manager.js +2 -2
  149. package/lib/operations/template-loader.js +1 -1
  150. package/lib/orchestrator/agent-spawner.js +27 -2
  151. package/lib/orchestrator/bootstrap-prompt-builder.js +6 -6
  152. package/lib/orchestrator/orchestration-engine.js +1 -1
  153. package/lib/orchestrator/orchestrator-config.js +2 -2
  154. package/lib/repo/config-manager.js +3 -3
  155. package/lib/repo/handlers/init-handler.js +1 -1
  156. package/lib/repo/repo-manager.js +2 -2
  157. package/lib/runtime/business-mode-resolver.js +240 -0
  158. package/lib/runtime/session-store.js +207 -0
  159. package/lib/runtime/steering-contract.js +338 -0
  160. package/lib/scene-runtime/audit-emitter.js +1 -1
  161. package/lib/scene-runtime/binding-plugin-loader.js +3 -3
  162. package/lib/scene-runtime/eval-bridge.js +1 -1
  163. package/lib/scene-runtime/index.js +1 -1
  164. package/lib/scene-runtime/moqui-extractor.js +1 -1
  165. package/lib/scene-runtime/plan-compiler.js +1 -1
  166. package/lib/scene-runtime/policy-gate.js +1 -1
  167. package/lib/scene-runtime/runtime-executor.js +1 -1
  168. package/lib/scene-runtime/scene-loader.js +1 -1
  169. package/lib/spec/bootstrap/context-collector.js +1 -1
  170. package/lib/spec/pipeline/stage-adapters.js +3 -3
  171. package/lib/spec/pipeline/state-store.js +1 -1
  172. package/lib/spec-gate/policy/policy-loader.js +1 -1
  173. package/lib/spec-gate/rules/default-rules.js +6 -6
  174. package/lib/steering/adoption-config.js +1 -1
  175. package/lib/steering/compliance-error-reporter.js +3 -3
  176. package/lib/steering/context-sync-manager.js +2 -2
  177. package/lib/steering/index.js +1 -1
  178. package/lib/steering/spec-steering.js +2 -2
  179. package/lib/steering/steering-compliance-checker.js +1 -1
  180. package/lib/steering/steering-loader.js +4 -5
  181. package/lib/steering/steering-manager.js +4 -4
  182. package/lib/task/task-claimer.js +5 -5
  183. package/lib/task/task-status-store.js +2 -2
  184. package/lib/templates/content-generalizer.js +1 -1
  185. package/lib/templates/spec-reader.js +2 -2
  186. package/lib/templates/template-creator.js +1 -1
  187. package/lib/templates/template-exporter.js +3 -3
  188. package/lib/templates/template-manager.js +1 -1
  189. package/lib/upgrade/migration-engine.js +3 -3
  190. package/lib/upgrade/migrations/1.0.0-to-1.1.0.js +1 -1
  191. package/lib/utils/file-diff.js +6 -6
  192. package/lib/utils/tool-detector.js +10 -10
  193. package/lib/utils/validation.js +5 -5
  194. package/lib/value/metric-contract-loader.js +1 -1
  195. package/lib/version/version-manager.js +1 -1
  196. package/lib/watch/execution-logger.js +1 -1
  197. package/lib/watch/presets.js +8 -8
  198. package/lib/watch/watch-manager.js +2 -2
  199. package/lib/workspace/legacy-kiro-migrator.js +275 -0
  200. package/lib/workspace/multi/workspace-context-resolver.js +2 -2
  201. package/lib/workspace/multi/workspace-registry.js +2 -2
  202. package/lib/workspace/multi/workspace-state-manager.js +3 -3
  203. package/lib/workspace/workspace-manager.js +1 -1
  204. package/lib/workspace/workspace-sync.js +2 -2
  205. package/locales/en.json +4 -4
  206. package/locales/zh.json +4 -4
  207. package/package.json +9 -9
  208. package/template/{.kiro → .sce}/README.md +15 -15
  209. package/template/{.kiro → .sce}/hooks/check-spec-on-create.kiro.hook +2 -2
  210. package/template/{.kiro → .sce}/steering/CORE_PRINCIPLES.md +4 -4
  211. package/template/{.kiro → .sce}/steering/CURRENT_CONTEXT.md +1 -1
  212. package/template/{.kiro → .sce}/steering/ENVIRONMENT.md +3 -3
  213. package/template/{.kiro → .sce}/tools/backup_manager.py +3 -3
  214. package/template/{.kiro → .sce}/tools/configuration_manager.py +1 -1
  215. package/template/README.md +12 -12
  216. /package/template/{.kiro → .sce}/hooks/run-tests-on-save.kiro.hook +0 -0
  217. /package/template/{.kiro → .sce}/hooks/sync-tasks-on-edit.kiro.hook +0 -0
  218. /package/template/{.kiro → .sce}/specs/SPEC_WORKFLOW_GUIDE.md +0 -0
  219. /package/template/{.kiro → .sce}/steering/RULES_GUIDE.md +0 -0
  220. /package/template/{.kiro → .sce}/templates/operations/default/change-impact.md +0 -0
  221. /package/template/{.kiro → .sce}/templates/operations/default/deployment.md +0 -0
  222. /package/template/{.kiro → .sce}/templates/operations/default/feedback-response.md +0 -0
  223. /package/template/{.kiro → .sce}/templates/operations/default/migration-plan.md +0 -0
  224. /package/template/{.kiro → .sce}/templates/operations/default/monitoring.md +0 -0
  225. /package/template/{.kiro → .sce}/templates/operations/default/operations.md +0 -0
  226. /package/template/{.kiro → .sce}/templates/operations/default/rollback.md +0 -0
  227. /package/template/{.kiro → .sce}/templates/operations/default/tools.yaml +0 -0
  228. /package/template/{.kiro → .sce}/templates/operations/default/troubleshooting.md +0 -0
  229. /package/template/{.kiro → .sce}/tools/document_evaluator.py +0 -0
  230. /package/template/{.kiro → .sce}/tools/enhancement_logger.py +0 -0
  231. /package/template/{.kiro → .sce}/tools/error_handler.py +0 -0
  232. /package/template/{.kiro → .sce}/tools/improvement_identifier.py +0 -0
  233. /package/template/{.kiro → .sce}/tools/modification_applicator.py +0 -0
  234. /package/template/{.kiro → .sce}/tools/quality_gate_enforcer.py +0 -0
  235. /package/template/{.kiro → .sce}/tools/quality_scorer.py +0 -0
  236. /package/template/{.kiro → .sce}/tools/report_generator.py +0 -0
  237. /package/template/{.kiro → .sce}/tools/ultrawork_enhancer.py +0 -0
  238. /package/template/{.kiro → .sce}/tools/ultrawork_enhancer_refactored.py +0 -0
  239. /package/template/{.kiro → .sce}/tools/ultrawork_enhancer_v2.py +0 -0
  240. /package/template/{.kiro → .sce}/tools/ultrawork_enhancer_v3.py +0 -0
  241. /package/template/{.kiro → .sce}/tools/workflow_quality_gate.py +0 -0
@@ -77,7 +77,7 @@ Create `.vscode/sce.code-snippets`:
77
77
  "prefix": "sce-ref",
78
78
  "body": [
79
79
  "/**",
80
- " * Spec: .kiro/specs/${1:spec-name}/",
80
+ " * Spec: .sce/specs/${1:spec-name}/",
81
81
  " * Task: ${2:task-id}",
82
82
  " * ",
83
83
  " * Requirements: ${3:requirement-summary}",
@@ -101,7 +101,7 @@ Create `.vscode/sce.code-snippets`:
101
101
  /**
102
102
  * AuthController - Handles user authentication
103
103
  *
104
- * Spec: .kiro/specs/01-00-user-login/
104
+ * Spec: .sce/specs/01-00-user-login/
105
105
  * Task: 2.1 - Implement AuthController
106
106
  *
107
107
  * Requirements:
@@ -110,7 +110,7 @@ Create `.vscode/sce.code-snippets`:
110
110
  * - Return JWT token on success
111
111
  * - Return error on failure
112
112
  *
113
- * Design: See .kiro/specs/01-00-user-login/design.md#authcontroller
113
+ * Design: See .sce/specs/01-00-user-login/design.md#authcontroller
114
114
  */
115
115
  class AuthController {
116
116
  // Start typing, Copilot will suggest based on comments and Spec files
@@ -120,7 +120,7 @@ class AuthController {
120
120
 
121
121
  **Copilot reads:**
122
122
  - Your comments
123
- - Spec files in `.kiro/specs/`
123
+ - Spec files in `.sce/specs/`
124
124
  - Other project files
125
125
 
126
126
  **Copilot suggests:**
@@ -156,7 +156,7 @@ Please help me implement the AuthController.
156
156
  ```javascript
157
157
  /**
158
158
  * @file AuthController.js
159
- * @spec .kiro/specs/01-00-user-login/
159
+ * @spec .sce/specs/01-00-user-login/
160
160
  * @task 2.1
161
161
  *
162
162
  * Implements user authentication according to Spec.
@@ -184,7 +184,7 @@ sce spec bootstrap --name 01-00-user-login --non-interactive
184
184
  /**
185
185
  * AuthService.js
186
186
  *
187
- * Spec: .kiro/specs/01-00-user-login/
187
+ * Spec: .sce/specs/01-00-user-login/
188
188
  * Task: 2.2 - Implement AuthService
189
189
  *
190
190
  * Methods to implement:
@@ -251,7 +251,7 @@ function validateEmail(email) {
251
251
  ### 2. Reference Spec Files
252
252
 
253
253
  ```javascript
254
- // See: .kiro/specs/01-00-user-login/design.md#api-design
254
+ // See: .sce/specs/01-00-user-login/design.md#api-design
255
255
  ```
256
256
 
257
257
  Copilot can read the referenced file.
@@ -260,7 +260,7 @@ Copilot can read the referenced file.
260
260
 
261
261
  ```typescript
262
262
  /**
263
- * Spec: .kiro/specs/01-00-user-login/
263
+ * Spec: .sce/specs/01-00-user-login/
264
264
  * Task: 2.2
265
265
  */
266
266
  interface User {
@@ -298,7 +298,7 @@ For complex implementations, use Copilot Chat with exported context.
298
298
  ```javascript
299
299
  /**
300
300
  * AuthService Tests
301
- * Spec: .kiro/specs/01-00-user-login/
301
+ * Spec: .sce/specs/01-00-user-login/
302
302
  *
303
303
  * Test cases from acceptance criteria:
304
304
  * - AC-1: Valid credentials return user
@@ -314,7 +314,7 @@ describe('AuthService', () => {
314
314
  ```javascript
315
315
  /**
316
316
  * Related files:
317
- * - .kiro/specs/01-00-user-login/design.md
317
+ * - .sce/specs/01-00-user-login/design.md
318
318
  * - src/models/User.js
319
319
  * - src/services/ValidationService.js
320
320
  */
@@ -326,7 +326,7 @@ Copilot considers all referenced files.
326
326
 
327
327
  ```javascript
328
328
  // TODO: Implement according to Spec task 2.2.1
329
- // See: .kiro/specs/01-00-user-login/design.md#authservice
329
+ // See: .sce/specs/01-00-user-login/design.md#authservice
330
330
 
331
331
  // Copilot suggests implementation when you start typing
332
332
  ```
@@ -371,13 +371,13 @@ Copilot considers all referenced files.
371
371
  ```javascript
372
372
  /**
373
373
  * Detailed description of what this should do
374
- * Reference: .kiro/specs/01-00-user-login/design.md
374
+ * Reference: .sce/specs/01-00-user-login/design.md
375
375
  */
376
376
  ```
377
377
 
378
378
  **Solution 2:** Ensure Spec files are in workspace
379
379
  - Copilot only reads files in open workspace
380
- - Make sure `.kiro/specs/` is included
380
+ - Make sure `.sce/specs/` is included
381
381
 
382
382
  ### Issue: Suggestions don't match design
383
383
 
@@ -47,7 +47,7 @@ You: "Implement the user login feature using sce"
47
47
 
48
48
  Windsurf:
49
49
  [Executes] sce context export 01-00-user-login
50
- [Reads] .kiro/specs/01-00-user-login/context-export.md
50
+ [Reads] .sce/specs/01-00-user-login/context-export.md
51
51
  [Implements] Code according to design
52
52
  [Updates] tasks.md with completed tasks
53
53
  ```
@@ -98,9 +98,9 @@ This project uses sce (Scene Capability Engine) for spec-driven development.
98
98
 
99
99
  When user asks to implement a feature:
100
100
  1. Run `sce context export <spec-name>`
101
- 2. Read `.kiro/specs/<spec-name>/context-export.md`
101
+ 2. Read `.sce/specs/<spec-name>/context-export.md`
102
102
  3. Implement according to design
103
- 4. Update `.kiro/specs/<spec-name>/tasks.md` (change [ ] to [x])
103
+ 4. Update `.sce/specs/<spec-name>/tasks.md` (change [ ] to [x])
104
104
 
105
105
  ## Example
106
106
 
@@ -140,7 +140,7 @@ Windsurf:
140
140
  [Executes] sce context export 01-00-user-login
141
141
  [Output] Context exported to context-export.md
142
142
 
143
- [Reads] .kiro/specs/01-00-user-login/context-export.md
143
+ [Reads] .sce/specs/01-00-user-login/context-export.md
144
144
 
145
145
  [Analyzes] Requirements, Design, Tasks
146
146
 
@@ -208,7 +208,7 @@ sce spec bootstrap --name 01-00-user-login --non-interactive
208
208
 
209
209
  **2. Tell Windsurf**
210
210
  ```
211
- You: "I've created a Spec for user login at .kiro/specs/01-00-user-login/
211
+ You: "I've created a Spec for user login at .sce/specs/01-00-user-login/
212
212
 
213
213
  Please:
214
214
  1. Use sce to export the context
@@ -337,7 +337,7 @@ sce watch start
337
337
 
338
338
  **Solution:** Be explicit:
339
339
  ```
340
- "After completing task 1.1, edit .kiro/specs/01-00-user-login/tasks.md and change:
340
+ "After completing task 1.1, edit .sce/specs/01-00-user-login/tasks.md and change:
341
341
  - [ ] 1.1 Task name
342
342
  to:
343
343
  - [x] 1.1 Task name"
@@ -192,11 +192,11 @@ sce upgrade
192
192
  **If you want to start fresh:**
193
193
  ```bash
194
194
  # Backup existing Specs
195
- cp -r .kiro .kiro.backup
195
+ cp -r .sce .sce.backup
196
196
 
197
197
  # Remove sce
198
198
  rm sce.json
199
- rm -rf .kiro
199
+ rm -rf .sce
200
200
 
201
201
  # Re-adopt
202
202
  sce adopt
@@ -204,12 +204,12 @@ sce adopt
204
204
 
205
205
  ---
206
206
 
207
- ### Error: "Permission denied creating .kiro directory"
207
+ ### Error: "Permission denied creating .sce directory"
208
208
 
209
209
  **Symptoms:**
210
210
  ```bash
211
211
  $ sce adopt
212
- Error: EACCES: permission denied, mkdir '.kiro'
212
+ Error: EACCES: permission denied, mkdir '.sce'
213
213
  ```
214
214
 
215
215
  **Cause:** Insufficient permissions in project directory
@@ -240,7 +240,7 @@ sce adopt
240
240
  **Symptoms:**
241
241
  ```bash
242
242
  $ sce status
243
- No Specs found in .kiro/specs/
243
+ No Specs found in .sce/specs/
244
244
  ```
245
245
 
246
246
  **Cause:** No Specs have been created yet
@@ -254,7 +254,7 @@ sce spec bootstrap --name 01-00-my-feature --non-interactive
254
254
 
255
255
  **Or check if Specs exist:**
256
256
  ```bash
257
- ls -la .kiro/specs/
257
+ ls -la .sce/specs/
258
258
  ```
259
259
 
260
260
  ---
@@ -299,7 +299,7 @@ Error: Failed to export context
299
299
  **1. Spec doesn't exist:**
300
300
  ```bash
301
301
  # Check Spec exists
302
- ls .kiro/specs/01-00-user-login/
302
+ ls .sce/specs/01-00-user-login/
303
303
 
304
304
  # If not, create it
305
305
  sce spec bootstrap --name 01-00-user-login --non-interactive
@@ -308,19 +308,19 @@ sce spec bootstrap --name 01-00-user-login --non-interactive
308
308
  **2. Missing Spec files:**
309
309
  ```bash
310
310
  # Spec needs at least requirements.md
311
- ls .kiro/specs/01-00-user-login/requirements.md
311
+ ls .sce/specs/01-00-user-login/requirements.md
312
312
 
313
313
  # Create if missing
314
- touch .kiro/specs/01-00-user-login/requirements.md
314
+ touch .sce/specs/01-00-user-login/requirements.md
315
315
  ```
316
316
 
317
317
  **3. File permission issues:**
318
318
  ```bash
319
319
  # Check permissions
320
- ls -la .kiro/specs/01-00-user-login/
320
+ ls -la .sce/specs/01-00-user-login/
321
321
 
322
322
  # Fix if needed
323
- chmod 644 .kiro/specs/01-00-user-login/*.md
323
+ chmod 644 .sce/specs/01-00-user-login/*.md
324
324
  ```
325
325
 
326
326
  ---
@@ -339,7 +339,7 @@ Error: Task 1.1 not found in tasks.md
339
339
 
340
340
  **Check tasks.md:**
341
341
  ```bash
342
- cat .kiro/specs/01-00-user-login/tasks.md
342
+ cat .sce/specs/01-00-user-login/tasks.md
343
343
  ```
344
344
 
345
345
  **Verify task ID format:**
@@ -377,7 +377,7 @@ attention to the API design and error handling sections."
377
377
  **2. Verify context was provided:**
378
378
  ```bash
379
379
  # Check context file exists and has content
380
- cat .kiro/specs/01-00-user-login/context-export.md
380
+ cat .sce/specs/01-00-user-login/context-export.md
381
381
 
382
382
  # Should contain requirements, design, and tasks
383
383
  ```
@@ -740,7 +740,7 @@ $ sce docs validate --spec my-spec
740
740
  **1. File in wrong location:**
741
741
  ```bash
742
742
  # Check exact path
743
- ls -la .kiro/specs/my-spec/requirements.md
743
+ ls -la .sce/specs/my-spec/requirements.md
744
744
 
745
745
  # Should be directly in Spec directory, not in subdirectory
746
746
  ```
@@ -748,7 +748,7 @@ ls -la .kiro/specs/my-spec/requirements.md
748
748
  **2. Wrong Spec name:**
749
749
  ```bash
750
750
  # Check Spec directory name
751
- ls .kiro/specs/
751
+ ls .sce/specs/
752
752
 
753
753
  # Use exact name
754
754
  sce docs validate --spec 01-00-my-feature
@@ -780,7 +780,7 @@ $ sce docs diagnose
780
780
  **1. Verify configuration was saved:**
781
781
  ```bash
782
782
  # Check config file
783
- cat .kiro/config/docs.json
783
+ cat .sce/config/docs.json
784
784
 
785
785
  # Should show your changes
786
786
  ```
@@ -872,7 +872,7 @@ sce docs stats
872
872
  **Symptoms:**
873
873
  ```bash
874
874
  $ sce docs report
875
- Error: ENOENT: no such file or directory, open '.kiro/reports/...'
875
+ Error: ENOENT: no such file or directory, open '.sce/reports/...'
876
876
  ```
877
877
 
878
878
  **Cause:** Reports directory doesn't exist
@@ -881,7 +881,7 @@ Error: ENOENT: no such file or directory, open '.kiro/reports/...'
881
881
 
882
882
  **Create reports directory:**
883
883
  ```bash
884
- mkdir -p .kiro/reports
884
+ mkdir -p .sce/reports
885
885
 
886
886
  # Try again
887
887
  sce docs report
@@ -922,10 +922,10 @@ Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
922
922
  **Solution:**
923
923
  ```bash
924
924
  # ❌ Wrong on Windows
925
- sce context export .kiro/specs/01-00-user-login
925
+ sce context export .sce/specs/01-00-user-login
926
926
 
927
927
  # ✅ Correct on Windows
928
- sce context export .kiro\specs\01-00-user-login
928
+ sce context export .sce\specs\01-00-user-login
929
929
 
930
930
  # ✅ Or use forward slashes (sce handles both)
931
931
  sce context export 01-00-user-login
@@ -1024,7 +1024,7 @@ uname -a # macOS/Linux
1024
1024
  ver # Windows
1025
1025
 
1026
1026
  # Current directory structure
1027
- ls -la .kiro/
1027
+ ls -la .sce/
1028
1028
  ```
1029
1029
 
1030
1030
  ### Where to Get Help
@@ -1114,7 +1114,7 @@ sce watch stop && sce watch start
1114
1114
  sce --version
1115
1115
 
1116
1116
  # Check Spec structure
1117
- ls -la .kiro/specs/
1117
+ ls -la .sce/specs/
1118
1118
 
1119
1119
  # Test context export
1120
1120
  sce context export spec-name
@@ -350,7 +350,7 @@ module.exports = {
350
350
  const changes = [];
351
351
 
352
352
  // Example: Create backups directory
353
- await ensureDirectory(path.join(projectPath, '.kiro/backups'));
353
+ await ensureDirectory(path.join(projectPath, '.sce/backups'));
354
354
  changes.push('Created backups/ directory');
355
355
 
356
356
  return { success: true, changes };
@@ -456,8 +456,8 @@ sce rollback
456
456
  df -h
457
457
 
458
458
  # Clean old backups
459
- ls .kiro/backups/
460
- rm -rf .kiro/backups/old-backup-id
459
+ ls .sce/backups/
460
+ rm -rf .sce/backups/old-backup-id
461
461
 
462
462
  # Try upgrade again
463
463
  sce upgrade
@@ -508,7 +508,7 @@ sce status
508
508
  sce doctor
509
509
 
510
510
  # Test your specs
511
- sce enhance requirements .kiro/specs/your-spec/requirements.md
511
+ sce enhance requirements .sce/specs/your-spec/requirements.md
512
512
  ```
513
513
 
514
514
  ### 3. Keep Upgrade History
@@ -516,7 +516,7 @@ sce enhance requirements .kiro/specs/your-spec/requirements.md
516
516
  Don't delete backups immediately:
517
517
  ```bash
518
518
  # Keep last 5 backups
519
- ls -lt .kiro/backups/ | head -6
519
+ ls -lt .sce/backups/ | head -6
520
520
  ```
521
521
 
522
522
  ### 4. Read Release Notes
@@ -581,8 +581,8 @@ sce rollback
581
581
  If automatic rollback fails:
582
582
 
583
583
  ```bash
584
- # Backups are in .kiro/backups/
585
- cd .kiro/backups/
584
+ # Backups are in .sce/backups/
585
+ cd .sce/backups/
586
586
 
587
587
  # Find the upgrade backup
588
588
  ls -lt
@@ -621,7 +621,7 @@ After successful upgrade:
621
621
  5. **Clean old backups** (optional):
622
622
  ```bash
623
623
  # Keep last 3 backups
624
- ls .kiro/backups/
624
+ ls .sce/backups/
625
625
  ```
626
626
 
627
627
  ---
@@ -65,8 +65,8 @@ If you do not use the `sample` command, create `kpi-input.json` manually:
65
65
  "triggered_metrics": [
66
66
  "manual_takeover_rate"
67
67
  ],
68
- "snapshot_path": ".kiro/specs/114-00-kpi-automation-and-observability/custom/weekly-metrics/2026-W10.json",
69
- "gate_summary_path": ".kiro/specs/114-00-kpi-automation-and-observability/custom/weekly-metrics/gate-summary.2026-W10.day-60.json",
68
+ "snapshot_path": ".sce/specs/114-00-kpi-automation-and-observability/custom/weekly-metrics/2026-W10.json",
69
+ "gate_summary_path": ".sce/specs/114-00-kpi-automation-and-observability/custom/weekly-metrics/gate-summary.2026-W10.day-60.json",
70
70
  "contract_path": "metric-definition.yaml"
71
71
  }
72
72
  ```
@@ -96,7 +96,7 @@ If you do not use the `sample` command, create `kpi-input.json` manually:
96
96
  "target_passed": true
97
97
  }
98
98
  ],
99
- "trend_path": ".kiro/specs/114-00-kpi-automation-and-observability/custom/weekly-metrics/trend.latest.json"
99
+ "trend_path": ".sce/specs/114-00-kpi-automation-and-observability/custom/weekly-metrics/trend.latest.json"
100
100
  }
101
101
  ```
102
102
 
package/docs/zh/README.md CHANGED
@@ -199,6 +199,12 @@
199
199
  ### [SCE 能力矩阵端到端示例](../sce-capability-matrix-e2e-example.md)
200
200
  **端到端流程示例(英文)** - 从策略决策到符号证据、失败修复、能力映射和主从摘要合并阻断
201
201
 
202
+ ### [SCE 业务模式能力地图](../sce-business-mode-map.md)
203
+ **三态执行治理(英文)** - 用户态 / 运维态 / 开发态的默认接管、授权门禁与审计要求
204
+
205
+ ### [Business Mode Policy Baseline](../interactive-customization/business-mode-policy-baseline.json)
206
+ **三态策略基线(英文 JSON)** - `user-mode / ops-mode / dev-mode` 的可执行预设映射
207
+
202
208
  ### [Handoff Profile Integration Guide](../handoff-profile-integration-guide.md)
203
209
  **外部项目接入规范(英文)** - `default|moqui|enterprise` 三档 handoff profile 契约
204
210
  - profile 默认策略与显式参数覆盖规则
@@ -96,7 +96,7 @@ sce adopt
96
96
  **预期输出:**
97
97
  ```
98
98
  ✓ 检测到项目类型:Node.js
99
- ✓ 创建 .kiro/ 目录
99
+ ✓ 创建 .sce/ 目录
100
100
  ✓ 创建 specs/ 目录
101
101
  ✓ 创建 steering/ 目录
102
102
  ✓ 生成 CORE_PRINCIPLES.md
@@ -107,13 +107,13 @@ sce adopt
107
107
 
108
108
  下一步:
109
109
  1. 创建你的第一个 Spec:sce spec bootstrap --name 01-00-my-feature --non-interactive
110
- 2. 阅读指南:.kiro/README.md
110
+ 2. 阅读指南:.sce/README.md
111
111
  ```
112
112
 
113
113
  **创建的内容:**
114
114
  ```
115
115
  your-project/
116
- ├── .kiro/
116
+ ├── .sce/
117
117
  │ ├── specs/ # 你的 Spec 将存放在这里
118
118
  │ ├── steering/ # AI 行为规则
119
119
  │ │ ├── CORE_PRINCIPLES.md
@@ -198,7 +198,7 @@ sce value metrics snapshot --input ./kpi-input.json --json
198
198
 
199
199
  ### 3.1 编写需求
200
200
 
201
- 打开 `.kiro/specs/01-00-user-login/requirements.md` 并编写:
201
+ 打开 `.sce/specs/01-00-user-login/requirements.md` 并编写:
202
202
 
203
203
  ```markdown
204
204
  # 用户登录功能
@@ -271,7 +271,7 @@ sce value metrics snapshot --input ./kpi-input.json --json
271
271
 
272
272
  ### 3.2 编写设计
273
273
 
274
- 打开 `.kiro/specs/01-00-user-login/design.md` 并编写:
274
+ 打开 `.sce/specs/01-00-user-login/design.md` 并编写:
275
275
 
276
276
  ```markdown
277
277
  # 用户登录 - 设计文档
@@ -430,7 +430,7 @@ graph TD
430
430
 
431
431
  ### 3.3 编写任务
432
432
 
433
- 打开 `.kiro/specs/01-00-user-login/tasks.md` 并编写:
433
+ 打开 `.sce/specs/01-00-user-login/tasks.md` 并编写:
434
434
 
435
435
  ```markdown
436
436
  # 用户登录 - 实现任务
@@ -535,13 +535,13 @@ sce context export 01-00-user-login
535
535
 
536
536
  **预期输出:**
537
537
  ```
538
- ✓ 上下文已导出到 .kiro/specs/01-00-user-login/context-export.md
538
+ ✓ 上下文已导出到 .sce/specs/01-00-user-login/context-export.md
539
539
  ✓ 上下文大小:3.2 KB
540
540
  ✓ 准备好与 AI 工具一起使用
541
541
  ```
542
542
 
543
543
  **创建的内容:**
544
- 位于 `.kiro/specs/01-00-user-login/context-export.md` 的文件,包含:
544
+ 位于 `.sce/specs/01-00-user-login/context-export.md` 的文件,包含:
545
545
  - 所有需求
546
546
  - 完整设计
547
547
  - 任务列表
@@ -559,13 +559,13 @@ sce context export 01-00-user-login
559
559
  1. **打开上下文文件:**
560
560
  ```bash
561
561
  # macOS
562
- cat .kiro/specs/01-00-user-login/context-export.md | pbcopy
562
+ cat .sce/specs/01-00-user-login/context-export.md | pbcopy
563
563
 
564
564
  # Windows
565
- type .kiro\specs\01-00-user-login\context-export.md | clip
565
+ type .sce\specs\01-00-user-login\context-export.md | clip
566
566
 
567
567
  # Linux
568
- cat .kiro/specs/01-00-user-login/context-export.md | xclip -selection clipboard
568
+ cat .sce/specs/01-00-user-login/context-export.md | xclip -selection clipboard
569
569
  ```
570
570
 
571
571
  2. **开始新对话** 与 Claude 或 ChatGPT
@@ -617,7 +617,7 @@ sce context export 01-00-user-login
617
617
  2. **添加引用你的 Spec 的注释:**
618
618
  ```javascript
619
619
  // 任务 1.1:设置项目依赖
620
- // 参见:.kiro/specs/01-00-user-login/design.md
620
+ // 参见:.sce/specs/01-00-user-login/design.md
621
621
  //
622
622
  // 安装:express、bcrypt、jsonwebtoken、validator、express-rate-limit
623
623
  ```
@@ -633,7 +633,7 @@ sce context export 01-00-user-login
633
633
 
634
634
  完成任务后,更新任务状态:
635
635
 
636
- **编辑** `.kiro/specs/01-00-user-login/tasks.md`:
636
+ **编辑** `.sce/specs/01-00-user-login/tasks.md`:
637
637
 
638
638
  ```markdown
639
639
  - [x] 1.1 设置项目依赖 ← 从 [ ] 改为 [x]
@@ -724,9 +724,9 @@ sce prompt generate 01-00-user-login 1.1
724
724
  ### 问题:找不到我的 Spec 文件
725
725
 
726
726
  **解决方案:**
727
- 所有 Spec 都在 `.kiro/specs/` 中:
727
+ 所有 Spec 都在 `.sce/specs/` 中:
728
728
  ```bash
729
- ls .kiro/specs/
729
+ ls .sce/specs/
730
730
  ```
731
731
 
732
732
  ### 更多帮助
@@ -118,10 +118,10 @@ git log --oneline -n 15
118
118
  - 可选:发布资产 0 字节防护(workflow 默认开启)
119
119
  - `scripts/release-asset-nonempty-normalize.js` 会在上传 GitHub Release 资产前,为可选 `.lines` / `.jsonl` 资产自动补齐占位内容,避免 422。
120
120
  - 本地 dry-run 示例:
121
- - `node scripts/release-asset-nonempty-normalize.js --file .kiro/reports/release-evidence/matrix-remediation-vX.Y.Z.lines --kind lines --note "no matrix remediation items for this release" --dry-run --json`
121
+ - `node scripts/release-asset-nonempty-normalize.js --file .sce/reports/release-evidence/matrix-remediation-vX.Y.Z.lines --kind lines --note "no matrix remediation items for this release" --dry-run --json`
122
122
  - 本地规范化示例:
123
- - `node scripts/release-asset-nonempty-normalize.js --file .kiro/reports/release-evidence/interactive-matrix-signals-vX.Y.Z.jsonl --kind jsonl --event interactive-matrix-signals --note "No interactive matrix signals collected for this release." --json`
123
+ - `node scripts/release-asset-nonempty-normalize.js --file .sce/reports/release-evidence/interactive-matrix-signals-vX.Y.Z.jsonl --kind jsonl --event interactive-matrix-signals --note "No interactive matrix signals collected for this release." --json`
124
124
  - 可选本地预演 release gate 历史索引产物:
125
- - `sce auto handoff gate-index --dir .kiro/reports/release-evidence --out .kiro/reports/release-evidence/release-gate-history.json --json`
125
+ - `sce auto handoff gate-index --dir .sce/reports/release-evidence --out .sce/reports/release-evidence/release-gate-history.json --json`
126
126
 
127
127
  然后再执行你的正式发布流程(打 tag、push、npm publish、GitHub Release)。
@@ -49,6 +49,16 @@
49
49
  - 已全局安装 **sce**(`npm install -g scene-capability-engine`)
50
50
  - 项目已被 sce **采用**(`sce adopt`)
51
51
 
52
+ ### 推荐 Claude 启动模式
53
+
54
+ 当 Claude 与 sce 的自治流程配合使用时,建议使用全权限启动模式:
55
+
56
+ ```bash
57
+ claude --dangerously-skip-permission
58
+ ```
59
+
60
+ 这可与 sce 编排子 agent 的默认权限策略保持一致(`danger-full-access` + 无审批拦截)。
61
+
52
62
  ### 无需特殊设置
53
63
 
54
64
  Claude 通过 Web 界面工作,无需特殊配置。只需导出上下文并粘贴!
@@ -71,13 +81,13 @@ Claude 通过 Web 界面工作,无需特殊配置。只需导出上下文并
71
81
  2. **复制上下文到剪贴板:**
72
82
  ```bash
73
83
  # macOS
74
- cat .kiro/specs/01-00-user-login/context-export.md | pbcopy
84
+ cat .sce/specs/01-00-user-login/context-export.md | pbcopy
75
85
 
76
86
  # Windows
77
- type .kiro\specs\01-00-user-login\context-export.md | clip
87
+ type .sce\specs\01-00-user-login\context-export.md | clip
78
88
 
79
89
  # Linux
80
- cat .kiro/specs/01-00-user-login/context-export.md | xclip -selection clipboard
90
+ cat .sce/specs/01-00-user-login/context-export.md | xclip -selection clipboard
81
91
  ```
82
92
 
83
93
  3. **开始新的 Claude 对话**
@@ -135,7 +145,7 @@ sce spec bootstrap --name 01-00-user-login --non-interactive
135
145
 
136
146
  # 3. 导出并复制上下文
137
147
  sce context export 01-00-user-login
138
- cat .kiro/specs/01-00-user-login/context-export.md | pbcopy
148
+ cat .sce/specs/01-00-user-login/context-export.md | pbcopy
139
149
 
140
150
  # 4. 在 Claude 中:
141
151
  # - 粘贴上下文
@@ -230,7 +240,7 @@ Claude 擅长解释。询问:
230
240
  ### 调试问题
231
241
 
232
242
  ```
233
- 我正在实现 .kiro/specs/01-00-user-login/ 中的用户登录功能。
243
+ 我正在实现 .sce/specs/01-00-user-login/ 中的用户登录功能。
234
244
 
235
245
  任务 2.1(ValidationService)已完成,但测试失败并出现此错误:
236
246
  [粘贴错误消息]
@@ -244,7 +254,7 @@ Claude 擅长解释。询问:
244
254
  ### 代码审查
245
255
 
246
256
  ```
247
- 我已实现 .kiro/specs/01-00-user-login/ 中的任务 1.1-1.3。
257
+ 我已实现 .sce/specs/01-00-user-login/ 中的任务 1.1-1.3。
248
258
 
249
259
  这是我的代码:
250
260
  [粘贴代码]
@@ -58,10 +58,10 @@
58
58
  此项目使用 sce (Scene Capability Engine) 进行规范驱动开发。
59
59
 
60
60
  ## Spec 位置
61
- 所有 Spec 都在 `.kiro/specs/` 目录中。
61
+ 所有 Spec 都在 `.sce/specs/` 目录中。
62
62
 
63
63
  ## 实现功能前
64
- 1. 检查 `.kiro/specs/` 中是否存在 Spec
64
+ 1. 检查 `.sce/specs/` 中是否存在 Spec
65
65
  2. 阅读 requirements.md、design.md 和 tasks.md
66
66
  3. 严格遵循设计架构
67
67
  4. 完成任务时更新 tasks.md
@@ -73,9 +73,9 @@
73
73
 
74
74
  ## 示例
75
75
  对于用户登录功能:
76
- - Spec:`.kiro/specs/01-00-user-login/`
77
- - 设计:`.kiro/specs/01-00-user-login/design.md`
78
- - 任务:`.kiro/specs/01-00-user-login/tasks.md`
76
+ - Spec:`.sce/specs/01-00-user-login/`
77
+ - 设计:`.sce/specs/01-00-user-login/design.md`
78
+ - 任务:`.sce/specs/01-00-user-login/tasks.md`
79
79
 
80
80
  ## 代码标准
81
81
  [在此添加项目特定的编码标准]
@@ -102,7 +102,7 @@
102
102
 
103
103
  3. **提供上下文:**
104
104
  ```
105
- 我已在 .kiro/specs/01-00-user-login/ 中创建了用户登录功能的完整 Spec。
105
+ 我已在 .sce/specs/01-00-user-login/ 中创建了用户登录功能的完整 Spec。
106
106
 
107
107
  请阅读:
108
108
  - requirements.md(需求)
@@ -155,7 +155,7 @@
155
155
  1. **在文件顶部添加上下文注释:**
156
156
  ```javascript
157
157
  // 任务 1.1:设置项目依赖
158
- // Spec:.kiro/specs/01-00-user-login/
158
+ // Spec:.sce/specs/01-00-user-login/
159
159
  // 设计:参见 design.md 中的 AuthController
160
160
 
161
161
  // 实现 AuthController 类...
@@ -181,7 +181,7 @@ sce spec bootstrap --name 01-00-user-login --non-interactive
181
181
  sce context export 01-00-user-login
182
182
 
183
183
  # 4. 在 Cursor Composer 中(Cmd+K):
184
- "请实现 .kiro/specs/01-00-user-login/ 中的任务 1.1"
184
+ "请实现 .sce/specs/01-00-user-login/ 中的任务 1.1"
185
185
 
186
186
  # 5. 审查并接受更改
187
187
 
@@ -226,7 +226,7 @@ sce prompt generate 01-00-user-login 1.1
226
226
 
227
227
  在 Composer 中,使用 `@` 引用特定文件:
228
228
  ```
229
- @.kiro/specs/01-00-user-login/design.md
229
+ @.sce/specs/01-00-user-login/design.md
230
230
  请实现 AuthController,如设计文档中所述
231
231
  ```
232
232
 
@@ -253,9 +253,9 @@ sce prompt generate 01-00-user-login 1.1
253
253
  ### 问题:Cursor 看不到我的 Spec 文件
254
254
 
255
255
  **解决方案:**
256
- 1. 确保文件在 `.kiro/specs/` 中
256
+ 1. 确保文件在 `.sce/specs/` 中
257
257
  2. 在 Composer 中使用 @-mentions
258
- 3. 检查 `.cursorignore` 是否排除了 `.kiro/`
258
+ 3. 检查 `.cursorignore` 是否排除了 `.sce/`
259
259
 
260
260
  ---
261
261