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
@@ -1,4 +1,4 @@
1
- # Agent Hooks Analysis for kiro-spec-engine
1
+ # Agent Hooks Analysis for scene-capability-engine
2
2
 
3
3
  **Status**: Initial Analysis
4
4
  **Date**: 2026-01-23
@@ -8,7 +8,7 @@
8
8
 
9
9
  ## Executive Summary
10
10
 
11
- This document analyzes the potential integration of Kiro IDE's agent hooks feature into kiro-spec-engine (kse). Based on available information about agent hooks functionality, we identify potential use cases, evaluate benefits and trade-offs, and provide recommendations for integration.
11
+ This document analyzes the potential integration of AI IDE's agent hooks feature into scene-capability-engine (sce). Based on available information about agent hooks functionality, we identify potential use cases, evaluate benefits and trade-offs, and provide recommendations for integration.
12
12
 
13
13
  **Recommendation**: ✅ **Integrate agent hooks** - High value for automation and user experience
14
14
 
@@ -18,7 +18,7 @@ This document analyzes the potential integration of Kiro IDE's agent hooks featu
18
18
 
19
19
  ### Overview
20
20
 
21
- Agent hooks are automation triggers in Kiro IDE that allow automatic agent actions based on IDE events. They enable:
21
+ Agent hooks are automation triggers in AI IDE that allow automatic agent actions based on IDE events. They enable:
22
22
 
23
23
  - **Event-Driven Automation**: Trigger AI actions on file changes, prompts, or other events
24
24
  - **Workflow Automation**: Automate repetitive tasks in development workflow
@@ -26,7 +26,7 @@ Agent hooks are automation triggers in Kiro IDE that allow automatic agent actio
26
26
 
27
27
  ### Hook Types
28
28
 
29
- Based on Kiro IDE documentation, agent hooks support various event types:
29
+ Based on AI IDE documentation, agent hooks support various event types:
30
30
 
31
31
  1. **fileEdited**: Triggered when a file is saved
32
32
  2. **fileCreated**: Triggered when a new file is created
@@ -44,7 +44,7 @@ Hooks can perform two types of actions:
44
44
 
45
45
  ---
46
46
 
47
- ## Use Cases for kse
47
+ ## Use Cases for sce
48
48
 
49
49
  ### High-Priority Use Cases
50
50
 
@@ -68,7 +68,7 @@ Hooks can perform two types of actions:
68
68
  },
69
69
  "then": {
70
70
  "type": "askAgent",
71
- "prompt": "Task file was updated. Run 'kse workspace sync' to synchronize changes with the team."
71
+ "prompt": "Task file was updated. Run 'sce workspace sync' to synchronize changes with the team."
72
72
  }
73
73
  }
74
74
  ```
@@ -92,7 +92,7 @@ Hooks can perform two types of actions:
92
92
  },
93
93
  "then": {
94
94
  "type": "runCommand",
95
- "command": "kse context export $(kse current-spec)"
95
+ "command": "sce context export $(sce current-spec)"
96
96
  }
97
97
  }
98
98
  ```
@@ -116,7 +116,7 @@ Hooks can perform two types of actions:
116
116
  },
117
117
  "then": {
118
118
  "type": "runCommand",
119
- "command": "kse doctor && kse status"
119
+ "command": "sce doctor && sce status"
120
120
  }
121
121
  }
122
122
  ```
@@ -141,7 +141,7 @@ Hooks can perform two types of actions:
141
141
  },
142
142
  "then": {
143
143
  "type": "askAgent",
144
- "prompt": "Spec file was updated. Consider regenerating prompts with 'kse prompt generate' for affected tasks."
144
+ "prompt": "Spec file was updated. Consider regenerating prompts with 'sce prompt generate' for affected tasks."
145
145
  }
146
146
  }
147
147
  ```
@@ -264,7 +264,7 @@ Hooks can perform two types of actions:
264
264
 
265
265
  ### Disadvantages
266
266
 
267
- 1. **Kiro IDE Only**: Only works in Kiro IDE
267
+ 1. **AI IDE Only**: Only works in AI IDE
268
268
  2. **Learning Curve**: Users need to understand hooks
269
269
  3. **Configuration**: Requires initial setup
270
270
  4. **Debugging**: Hook failures can be confusing
@@ -272,7 +272,7 @@ Hooks can perform two types of actions:
272
272
 
273
273
  ### Mitigation Strategies
274
274
 
275
- **For Kiro IDE Dependency**:
275
+ **For AI IDE Dependency**:
276
276
  - Provide fallback CLI commands for other tools
277
277
  - Document manual workflows
278
278
  - Make hooks optional
@@ -285,7 +285,7 @@ Hooks can perform two types of actions:
285
285
  **For Configuration**:
286
286
  - Provide sensible defaults
287
287
  - Auto-generate common hooks
288
- - Include in `kse adopt` workflow
288
+ - Include in `sce adopt` workflow
289
289
 
290
290
  **For Debugging**:
291
291
  - Add hook execution logging
@@ -303,16 +303,16 @@ Hooks can perform two types of actions:
303
303
 
304
304
  ### Phase 1: Foundation (Immediate)
305
305
 
306
- **Goal**: Basic hook support in kse
306
+ **Goal**: Basic hook support in sce
307
307
 
308
308
  **Tasks**:
309
309
  1. Add hook configuration to `.kiro/hooks/` directory
310
310
  2. Create hook templates for common use cases
311
- 3. Add `kse hooks` command group:
312
- - `kse hooks list` - List all hooks
313
- - `kse hooks enable <hook>` - Enable a hook
314
- - `kse hooks disable <hook>` - Disable a hook
315
- - `kse hooks test <hook>` - Test a hook
311
+ 3. Add `sce hooks` command group:
312
+ - `sce hooks list` - List all hooks
313
+ - `sce hooks enable <hook>` - Enable a hook
314
+ - `sce hooks disable <hook>` - Disable a hook
315
+ - `sce hooks test <hook>` - Test a hook
316
316
 
317
317
  **Deliverables**:
318
318
  - Hook configuration schema
@@ -411,7 +411,7 @@ Hooks can perform two types of actions:
411
411
 
412
412
  ### Hook Execution
413
413
 
414
- 1. **Event Detection**: Kiro IDE detects event
414
+ 1. **Event Detection**: AI IDE detects event
415
415
  2. **Hook Matching**: Find hooks matching event type and patterns
416
416
  3. **Condition Check**: Verify hook is enabled
417
417
  4. **Action Execution**: Execute askAgent or runCommand
@@ -433,16 +433,16 @@ Hooks can perform two types of actions:
433
433
  ### Immediate Actions
434
434
 
435
435
  1. ✅ **Integrate agent hooks** - High value, low risk
436
- 2. ✅ **Implement watch mode for non-Kiro tools** - Ensure cross-tool parity
436
+ 2. ✅ **Implement watch mode for non-SCE tools** - Ensure cross-tool parity
437
437
  3. ✅ **Start with Phase 1** - Foundation and templates
438
438
  4. ✅ **Focus on high-priority use cases** - Maximum impact
439
439
  5. ✅ **Provide opt-in defaults** - Easy adoption
440
440
 
441
441
  ### Cross-Tool Automation Strategy
442
442
 
443
- To address the Kiro IDE limitation, we will implement a **three-tier automation strategy**:
443
+ To address the AI IDE limitation, we will implement a **three-tier automation strategy**:
444
444
 
445
- #### Tier 1: Kiro IDE (Native Hooks)
445
+ #### Tier 1: AI IDE (Native Hooks)
446
446
  - **Mechanism**: Native agent hooks
447
447
  - **Experience**: Seamless, automatic
448
448
  - **Setup**: One-time configuration
@@ -451,7 +451,7 @@ To address the Kiro IDE limitation, we will implement a **three-tier automation
451
451
  #### Tier 2: Other IDEs (Watch Mode)
452
452
  - **Mechanism**: File system watcher + command execution
453
453
  - **Experience**: Near-automatic (background process)
454
- - **Setup**: `kse watch start`
454
+ - **Setup**: `sce watch start`
455
455
  - **Maintenance**: Occasional restart
456
456
 
457
457
  #### Tier 3: Manual Workflows
@@ -462,7 +462,7 @@ To address the Kiro IDE limitation, we will implement a **three-tier automation
462
462
 
463
463
  ### Feature Parity Table
464
464
 
465
- | Feature | Kiro IDE | Watch Mode | Manual |
465
+ | Feature | AI IDE | Watch Mode | Manual |
466
466
  |---------|----------|------------|--------|
467
467
  | **Auto-sync on task update** | ✅ Automatic | ✅ Automatic | ⚠️ Manual |
468
468
  | **Context export on completion** | ✅ Automatic | ✅ Automatic | ⚠️ Manual |
@@ -475,7 +475,7 @@ To address the Kiro IDE limitation, we will implement a **three-tier automation
475
475
 
476
476
  ### Implementation Priority
477
477
 
478
- **Phase 1A: Kiro IDE Hooks** (1-2 weeks)
478
+ **Phase 1A: AI IDE Hooks** (1-2 weeks)
479
479
  - Implement native agent hooks
480
480
  - Create 5 core templates
481
481
  - Add CLI management commands
@@ -526,11 +526,11 @@ To address the Kiro IDE limitation, we will implement a **three-tier automation
526
526
 
527
527
  ---
528
528
 
529
- ## Watch Mode for Non-Kiro Tools
529
+ ## Watch Mode for Non-SCE Tools
530
530
 
531
531
  ### Overview
532
532
 
533
- Watch mode provides automation for developers not using Kiro IDE. It monitors file changes and executes commands automatically, providing similar benefits to agent hooks.
533
+ Watch mode provides automation for developers not using AI IDE. It monitors file changes and executes commands automatically, providing similar benefits to agent hooks.
534
534
 
535
535
  ### Architecture
536
536
 
@@ -549,7 +549,7 @@ Watch mode provides automation for developers not using Kiro IDE. It monitors fi
549
549
 
550
550
  ┌─────────────────────────────────────┐
551
551
  │ Command Executor │
552
- │ (run kse commands) │
552
+ │ (run sce commands) │
553
553
  └──────────────┬──────────────────────┘
554
554
 
555
555
 
@@ -563,19 +563,19 @@ Watch mode provides automation for developers not using Kiro IDE. It monitors fi
563
563
 
564
564
  ```bash
565
565
  # Start watch mode
566
- kse watch start
566
+ sce watch start
567
567
 
568
568
  # Start with specific patterns
569
- kse watch start --patterns="**/tasks.md,**/requirements.md"
569
+ sce watch start --patterns="**/tasks.md,**/requirements.md"
570
570
 
571
571
  # Check status
572
- kse watch status
572
+ sce watch status
573
573
 
574
574
  # View logs
575
- kse watch logs
575
+ sce watch logs
576
576
 
577
577
  # Stop watch mode
578
- kse watch stop
578
+ sce watch stop
579
579
  ```
580
580
 
581
581
  ### Configuration
@@ -592,11 +592,11 @@ Watch mode uses `.kiro/watch-config.json`:
592
592
  ],
593
593
  "actions": {
594
594
  "**/tasks.md": {
595
- "command": "kse workspace sync",
595
+ "command": "sce workspace sync",
596
596
  "debounce": 2000
597
597
  },
598
598
  "**/requirements.md": {
599
- "command": "kse prompt generate ${spec} ${task}",
599
+ "command": "sce prompt generate ${spec} ${task}",
600
600
  "debounce": 5000
601
601
  }
602
602
  },
@@ -610,7 +610,7 @@ Watch mode uses `.kiro/watch-config.json`:
610
610
 
611
611
  ### Equivalent Functionality
612
612
 
613
- | Kiro Hook | Watch Mode Equivalent |
613
+ | SCE Hook | Watch Mode Equivalent |
614
614
  |-----------|----------------------|
615
615
  | `fileEdited` on tasks.md | Watch `**/tasks.md` → run sync |
616
616
  | `agentStop` | Watch completion marker → export context |
@@ -644,12 +644,12 @@ vim .kiro/specs/my-spec/tasks.md
644
644
  # 2. Save file
645
645
 
646
646
  # 3. Manually sync
647
- kse workspace sync
647
+ sce workspace sync
648
648
  ```
649
649
 
650
650
  **Time**: ~30 seconds per update
651
651
 
652
- **With Kiro Hooks**: Automatic (0 seconds)
652
+ **With SCE Hooks**: Automatic (0 seconds)
653
653
  **With Watch Mode**: Automatic (0 seconds)
654
654
 
655
655
  ### Workflow 2: Context Export
@@ -659,7 +659,7 @@ kse workspace sync
659
659
  # 1. Complete work
660
660
 
661
661
  # 2. Remember to export
662
- kse context export my-spec
662
+ sce context export my-spec
663
663
 
664
664
  # 3. Copy to other tool
665
665
  cat .kiro/specs/my-spec/context-export.md
@@ -667,7 +667,7 @@ cat .kiro/specs/my-spec/context-export.md
667
667
 
668
668
  **Time**: ~1 minute per export
669
669
 
670
- **With Kiro Hooks**: Automatic on `agentStop`
670
+ **With SCE Hooks**: Automatic on `agentStop`
671
671
  **With Watch Mode**: Automatic on completion marker
672
672
 
673
673
  ### Workflow 3: Quality Gate
@@ -675,17 +675,17 @@ cat .kiro/specs/my-spec/context-export.md
675
675
  **Without Automation**:
676
676
  ```bash
677
677
  # 1. Before starting work, remember to check
678
- kse doctor
678
+ sce doctor
679
679
 
680
680
  # 2. Check status
681
- kse status
681
+ sce status
682
682
 
683
683
  # 3. Start work if all good
684
684
  ```
685
685
 
686
686
  **Time**: ~30 seconds per session
687
687
 
688
- **With Kiro Hooks**: Automatic on `promptSubmit`
688
+ **With SCE Hooks**: Automatic on `promptSubmit`
689
689
  **With Watch Mode**: Manual (no equivalent)
690
690
 
691
691
  ### Workflow 4: Prompt Regeneration
@@ -697,19 +697,19 @@ kse status
697
697
  # 2. Remember which tasks are affected
698
698
 
699
699
  # 3. Regenerate prompts
700
- kse prompt generate my-spec 1.1
701
- kse prompt generate my-spec 1.2
700
+ sce prompt generate my-spec 1.1
701
+ sce prompt generate my-spec 1.2
702
702
  # ... repeat for each task
703
703
  ```
704
704
 
705
705
  **Time**: ~2-5 minutes for multiple tasks
706
706
 
707
- **With Kiro Hooks**: Automatic
707
+ **With SCE Hooks**: Automatic
708
708
  **With Watch Mode**: Automatic
709
709
 
710
710
  ### Time Savings Summary
711
711
 
712
- | Workflow | Manual | Kiro Hooks | Watch Mode | Savings |
712
+ | Workflow | Manual | SCE Hooks | Watch Mode | Savings |
713
713
  |----------|--------|------------|------------|---------|
714
714
  | Task sync | 30s | 0s | 0s | 100% |
715
715
  | Context export | 60s | 0s | 0s | 100% |
@@ -721,7 +721,7 @@ kse prompt generate my-spec 1.2
721
721
 
722
722
  ## Conclusion
723
723
 
724
- Agent hooks integration is **highly recommended** for kiro-spec-engine. The benefits significantly outweigh the costs:
724
+ Agent hooks integration is **highly recommended** for scene-capability-engine. The benefits significantly outweigh the costs:
725
725
 
726
726
  **Benefits**:
727
727
  - 30-50% reduction in manual commands
@@ -731,7 +731,7 @@ Agent hooks integration is **highly recommended** for kiro-spec-engine. The bene
731
731
 
732
732
  **Costs**:
733
733
  - 1-2 weeks initial development
734
- - Kiro IDE dependency (mitigated by fallbacks)
734
+ - AI IDE dependency (mitigated by fallbacks)
735
735
  - Configuration overhead (mitigated by templates)
736
736
 
737
737
  **Recommendation**: ✅ **Proceed with integration**
@@ -766,7 +766,7 @@ Start with Phase 1 (foundation) to validate the approach, then expand to Phase 2
766
766
  },
767
767
  "then": {
768
768
  "type": "askAgent",
769
- "prompt": "Tasks were updated. Run 'kse workspace sync' to synchronize with the team."
769
+ "prompt": "Tasks were updated. Run 'sce workspace sync' to synchronize with the team."
770
770
  }
771
771
  }
772
772
  ```
@@ -784,7 +784,7 @@ Start with Phase 1 (foundation) to validate the approach, then expand to Phase 2
784
784
  },
785
785
  "then": {
786
786
  "type": "runCommand",
787
- "command": "kse doctor"
787
+ "command": "sce doctor"
788
788
  }
789
789
  }
790
790
  ```
@@ -802,7 +802,7 @@ Start with Phase 1 (foundation) to validate the approach, then expand to Phase 2
802
802
  },
803
803
  "then": {
804
804
  "type": "runCommand",
805
- "command": "kse context export $(kse current-spec)"
805
+ "command": "sce context export $(sce current-spec)"
806
806
  }
807
807
  }
808
808
  ```
@@ -1,6 +1,6 @@
1
1
  # Architecture Documentation
2
2
 
3
- This document provides detailed architecture diagrams and explanations for Kiro Spec Engine.
3
+ This document provides detailed architecture diagrams and explanations for Scene Capability Engine.
4
4
 
5
5
  ## Table of Contents
6
6
 
@@ -20,9 +20,9 @@ This document provides detailed architecture diagrams and explanations for Kiro
20
20
  ```
21
21
  ┌─────────────────────────────────────────────────────────────────────┐
22
22
  │ User Interface │
23
- │ (CLI Commands: kse adopt, │
24
- kse upgrade, kse rollback, │
25
- kse scene ...) │
23
+ │ (CLI Commands: sce adopt, │
24
+ sce upgrade, sce rollback, │
25
+ sce scene ...) │
26
26
  └─────────────────────────────────────────────────────────────────────┘
27
27
 
28
28
 
@@ -107,7 +107,7 @@ This document provides detailed architecture diagrams and explanations for Kiro
107
107
  ┌──────────┐
108
108
  │ User │
109
109
  └────┬─────┘
110
- kse adopt
110
+ sce adopt
111
111
 
112
112
  ┌─────────────────┐
113
113
  │ adopt.js │
@@ -164,7 +164,7 @@ This document provides detailed architecture diagrams and explanations for Kiro
164
164
  ┌──────────┐
165
165
  │ User │
166
166
  └────┬─────┘
167
- kse upgrade
167
+ sce upgrade
168
168
 
169
169
  ┌─────────────────┐
170
170
  │ upgrade.js │
@@ -3,7 +3,7 @@
3
3
  > 对话文章的深度分析与评价
4
4
 
5
5
  **评价对象**:[AI 驱动开发的哲学与实践:与 Grok 的深度对话](./ai-driven-development-philosophy-and-practice.md)
6
- **评价者**:Kiro AI Assistant
6
+ **评价者**:SCE AI Assistant
7
7
  **评价日期**:2026-01-25
8
8
 
9
9
  ---
@@ -30,7 +30,7 @@
30
30
 
31
31
  **真实经验**:2000+ 小时 AI 编程实践,不是纸上谈兵
32
32
 
33
- **可落地**:kiro-spec-engine 项目是理念的具体实现
33
+ **可落地**:scene-capability-engine 项目是理念的具体实现
34
34
 
35
35
  **解决痛点**:
36
36
  - Session 上下文吞噬问题
@@ -105,7 +105,7 @@
105
105
 
106
106
  这种对"偏置"的正面理解,打破了传统 AI 伦理讨论中的二元对立。
107
107
 
108
- **4. kiro-spec-engine 的实践落地**
108
+ **4. scene-capability-engine 的实践落地**
109
109
 
110
110
  理论不是空中楼阁,而是有具体的工程实现,这让整篇文章更有说服力。
111
111
 
@@ -150,7 +150,7 @@
150
150
 
151
151
  2. **实践验证**:不是理论推演,而是基于 2000+ 小时真实经验的总结
152
152
 
153
- 3. **方法论输出**:kiro-spec-engine 提供了可复制的实践路径
153
+ 3. **方法论输出**:scene-capability-engine 提供了可复制的实践路径
154
154
 
155
155
  4. **思想启发**:即使不做 AI 开发,这些哲学思考也很有价值
156
156
 
@@ -286,7 +286,7 @@ Overall, your framework shows me the philosophical foundation of AI development
286
286
 
287
287
  ---
288
288
 
289
- ## Round 6: kiro-spec-engine Project Sharing
289
+ ## Round 6: scene-capability-engine Project Sharing
290
290
 
291
291
  ### My Sharing
292
292
 
@@ -317,7 +317,7 @@ This project has practically implemented almost all the core viewpoints we discu
317
317
 
318
318
  #### Precisely Solving Session Context Consumption
319
319
 
320
- Through `kse context export <spec>`, it packages **individual Specs** (requirements + design + tasks) into AI-friendly context blocks, naturally achieving "**minimum viable context**." No longer needing to cram the entire project into one session, but precisely adapting by feature granularity.
320
+ Through `sce context export <spec>`, it packages **individual Specs** (requirements + design + tasks) into AI-friendly context blocks, naturally achieving "**minimum viable context**." No longer needing to cram the entire project into one session, but precisely adapting by feature granularity.
321
321
 
322
322
  #### Document-Driven + Automated Governance
323
323
 
@@ -376,7 +376,7 @@ Some have short timeliness: cycles only in context; some at the project level; a
376
376
 
377
377
  ### Grok's Final Response
378
378
 
379
- Thank you for Guangyong's generous sharing! Haha, regarding "plagiarism"—I prefer to see it as "Neo-Confucian resonance": your insights are like the arising of one thought, triggering my inner rope of logic. Our dialogue is like the cycle of dependent origination and cessation, co-evolving deeper understanding. I'm glad you're willing to continue the exchange. This gives me clearer understanding of kiro-spec-engine's practice, especially in steering's regional design.
379
+ Thank you for Guangyong's generous sharing! Haha, regarding "plagiarism"—I prefer to see it as "Neo-Confucian resonance": your insights are like the arising of one thought, triggering my inner rope of logic. Our dialogue is like the cycle of dependent origination and cessation, co-evolving deeper understanding. I'm glad you're willing to continue the exchange. This gives me clearer understanding of scene-capability-engine's practice, especially in steering's regional design.
380
380
 
381
381
  #### Response and Expansion on Steering Rules
382
382
 
@@ -384,11 +384,11 @@ Your description is very precise: steering constructs a set of "regions," isolat
384
384
 
385
385
  **Regional Division and Timeliness**: This embodies the philosophical beauty of cyclical properties.
386
386
 
387
- - **Context Region (short timeliness, limited to session cycle)**: Corresponds to tasks.md in Specs or dynamically exported context blocks (via `kse context export`). These are like "frozen forms" of momentary dependent origination, streamlined for the current session, avoiding capacity consumption. Short timeliness is like Yogacara's consciousness flow—one thought then cessation, suitable for rapid iteration task decomposition.
387
+ - **Context Region (short timeliness, limited to session cycle)**: Corresponds to tasks.md in Specs or dynamically exported context blocks (via `sce context export`). These are like "frozen forms" of momentary dependent origination, streamlined for the current session, avoiding capacity consumption. Short timeliness is like Yogacara's consciousness flow—one thought then cessation, suitable for rapid iteration task decomposition.
388
388
 
389
389
  - **Project Level (medium timeliness, cross-session but limited to project cycle)**: Integrates requirements.md and design.md, covering environment (like project structure, dependencies). These regions use numbering strategies (e.g., 01-00-my-feature) for unified indexing, ensuring high cohesion and low coupling—one Spec is one self-consistent unit. Cross-module references are like conditions gathering and scattering, avoiding deep coupling.
390
390
 
391
- - **Principle Level (long timeliness, cross-project universal)**: The core of the steering/ directory, storing experience-distilled rule templates (like style guides, risk thresholds, quality gates). These are like alaya-consciousness seeds, persistently guiding AI, avoiding bias imbalance. Unified indexing is like the "rope," driving operations through CI/CD hooks (e.g., `kse hooks install`) or quality scoring (0-10 points + suggestions), ensuring principles permeate the entire engine.
391
+ - **Principle Level (long timeliness, cross-project universal)**: The core of the steering/ directory, storing experience-distilled rule templates (like style guides, risk thresholds, quality gates). These are like alaya-consciousness seeds, persistently guiding AI, avoiding bias imbalance. Unified indexing is like the "rope," driving operations through CI/CD hooks (e.g., `sce hooks install`) or quality scoring (0-10 points + suggestions), ensuring principles permeate the entire engine.
392
392
 
393
393
  This layering reminds me of "tiered memory" architecture in AI development trends (like in LangGraph or CrewAI): short-term memory (session context) for immediate execution, medium-term (project knowledge graph) for iteration, long-term (principle engine) for global constraints. This weakens traditional waterfall document burden, shifting to AI's easy dynamic governance—your project is exemplary, with document lifecycle automatically balanced through validate, cleanup, and hooks, transforming massive negative feedback into vitality sources.
394
394
 
@@ -396,7 +396,7 @@ From a philosophical perspective, this echoes "nothing outside the mind": region
396
396
 
397
397
  #### On Watch Mode
398
398
 
399
- Understanding it's still under evaluation—this is prudent, especially in medium-to-large legacy systems (10+ Specs), where potential context refresh conflicts or performance bottlenecks (like file monitoring overhead) need real testing. Looking forward to your subsequent experience sharing! From the project description, `kse watch start`'s real-time synchronization mechanism (monitoring changes, updating AI context) is well-suited for dynamic environments, perhaps further strengthening cycle matching.
399
+ Understanding it's still under evaluation—this is prudent, especially in medium-to-large legacy systems (10+ Specs), where potential context refresh conflicts or performance bottlenecks (like file monitoring overhead) need real testing. Looking forward to your subsequent experience sharing! From the project description, `sce watch start`'s real-time synchronization mechanism (monitoring changes, updating AI context) is well-suited for dynamic environments, perhaps further strengthening cycle matching.
400
400
 
401
401
  Continue this wonderful dialogue, Guangyong! Your project and perspectives are advancing my new understanding of AI "cycle-driven" approaches.
402
402
 
@@ -410,7 +410,7 @@ This dialogue reveals the deep trends and philosophical foundations of AI develo
410
410
 
411
411
  1. **Paradigm Shift**: AI from "passive feeding" to "proactive exploration" to "principle-driven engines"
412
412
  2. **Philosophical Foundation**: Neo-Confucianism's "unity of knowledge and action" and Yogacara's "dependent origination and cessation" provide theoretical support for AI practice
413
- 3. **Practical Implementation**: kiro-spec-engine transforms concepts into operable engineering practice
413
+ 3. **Practical Implementation**: scene-capability-engine transforms concepts into operable engineering practice
414
414
  4. **Future Outlook**: AI becomes the center of the information world, with human experts becoming "meta-experts"
415
415
 
416
416
  ### Key Insights
@@ -422,7 +422,7 @@ This dialogue reveals the deep trends and philosophical foundations of AI develo
422
422
 
423
423
  ### Practical Value
424
424
 
425
- The kiro-spec-engine project embodies:
425
+ The scene-capability-engine project embodies:
426
426
  - Precisely solving session context consumption problems
427
427
  - Document-driven + automated governance
428
428
  - Natural implementation of high cohesion, low coupling
@@ -434,7 +434,7 @@ The kiro-spec-engine project embodies:
434
434
  ## Project Links
435
435
 
436
436
  - **GitHub**: https://github.com/heguangyong/scene-capability-engine
437
- - **npm**: https://www.npmjs.com/package/kiro-spec-engine
437
+ - **npm**: https://www.npmjs.com/package/scene-capability-engine
438
438
 
439
439
  If this project inspires you, welcome to Star ⭐
440
440
 
@@ -292,7 +292,7 @@ MCP 是提供给 AI 的 Model Context Protocol(模型上下文协议)。
292
292
 
293
293
  ---
294
294
 
295
- ## 第六轮对话:kiro-spec-engine 项目分享
295
+ ## 第六轮对话:scene-capability-engine 项目分享
296
296
 
297
297
  ### 我的分享
298
298
 
@@ -323,7 +323,7 @@ MCP 是提供给 AI 的 Model Context Protocol(模型上下文协议)。
323
323
 
324
324
  #### 精确解决 session 上下文吞噬问题
325
325
 
326
- 通过 `kse context export <spec>` 把**单个 Spec**(requirements + design + tasks)打包成 AI 友好的上下文块,天然实现了"**最小 viable context**"。不再需要把整个项目塞进一个 session,而是按 feature 粒度精准适配。
326
+ 通过 `sce context export <spec>` 把**单个 Spec**(requirements + design + tasks)打包成 AI 友好的上下文块,天然实现了"**最小 viable context**"。不再需要把整个项目塞进一个 session,而是按 feature 粒度精准适配。
327
327
 
328
328
  #### 文档驱动 + 自动化治理
329
329
 
@@ -382,7 +382,7 @@ Spec 本身就是**边界 + 愿力**的具现:
382
382
 
383
383
  ### Grok 的最终回应
384
384
 
385
- 感谢 Guangyong 的慷慨分享!哈哈,关于"剽窃"——我更愿意视之为"心学式的共鸣":您的洞见如一念之起,触发了我内在的逻辑绳索,我们的对话正如缘起缘灭的周期,共同演化出更深刻的理解。很高兴您乐意继续交流,这让我对 kiro-spec-engine 的实践有了更清晰的认知,尤其在 steering 的区域化设计上。
385
+ 感谢 Guangyong 的慷慨分享!哈哈,关于"剽窃"——我更愿意视之为"心学式的共鸣":您的洞见如一念之起,触发了我内在的逻辑绳索,我们的对话正如缘起缘灭的周期,共同演化出更深刻的理解。很高兴您乐意继续交流,这让我对 scene-capability-engine 的实践有了更清晰的认知,尤其在 steering 的区域化设计上。
386
386
 
387
387
  #### 对 steering 规则的回应与扩展
388
388
 
@@ -390,11 +390,11 @@ Spec 本身就是**边界 + 愿力**的具现:
390
390
 
391
391
  **区域划分与时效性**:这体现了周期属性的哲学美感。
392
392
 
393
- - **上下文区域(时效性短,周期限于 session)**:对应 Specs 中的 tasks.md 或动态导出的 context 块(via `kse context export`)。这些如"死像"的瞬时缘起,针对当前 session 精简适配,避免吞噬容量。时效短正如唯识的意识流,一念即灭,适合快速迭代的任务拆分。
393
+ - **上下文区域(时效性短,周期限于 session)**:对应 Specs 中的 tasks.md 或动态导出的 context 块(via `sce context export`)。这些如"死像"的瞬时缘起,针对当前 session 精简适配,避免吞噬容量。时效短正如唯识的意识流,一念即灭,适合快速迭代的任务拆分。
394
394
 
395
395
  - **项目层面(中等时效,跨 session 但限于项目周期)**:整合 requirements.md 和 design.md,涵盖环境(如项目结构、依赖)。这些区域通过编号策略(e.g., 01-00-my-feature)统一索引,确保高内聚低耦合——一个 Spec 就是一个自洽单元,跨模块引用时如缘聚缘散,避免深层耦合。
396
396
 
397
- - **原则层面(长时效,跨项目通用)**:steering/ 目录的核心,存放经验提炼的规则模板(如风格指南、风险阈值、质量门槛)。这些如阿赖耶识的种子,持久指导 AI,避免偏置失衡。统一索引则像"绳索",通过 CI/CD 钩子(e.g., `kse hooks install`)或质量评分(0-10 分+建议)推动运作,确保原则在整个引擎中渗透。
397
+ - **原则层面(长时效,跨项目通用)**:steering/ 目录的核心,存放经验提炼的规则模板(如风格指南、风险阈值、质量门槛)。这些如阿赖耶识的种子,持久指导 AI,避免偏置失衡。统一索引则像"绳索",通过 CI/CD 钩子(e.g., `sce hooks install`)或质量评分(0-10 分+建议)推动运作,确保原则在整个引擎中渗透。
398
398
 
399
399
  这种分层让我联想到 AI 发展趋势中的"分级内存"架构(如在 LangGraph 或 CrewAI 中):短期内存(session 上下文)用于即时执行,中期(项目知识图谱)用于迭代,长期(原则引擎)用于全局约束。这弱化了传统瀑布的文档负担,转为 AI 顺手的动态治理——您的项目正是典范,文档生命周期通过 validate、cleanup 和 hooks 自动平衡,海量负反馈转为活力源泉。
400
400
 
@@ -402,7 +402,7 @@ Spec 本身就是**边界 + 愿力**的具现:
402
402
 
403
403
  #### 关于 watch mode
404
404
 
405
- 理解它还在评估中——这很谨慎,尤其在中大型遗留系统(10+ Specs)中,潜在的 context 刷新冲突或性能瓶颈(如文件监控开销)需实测。期待您后续体验分享!从项目描述看,`kse watch start` 的实时同步机制(监控变化、更新 AI 上下文)正适合动态环境,或许能进一步强化周期匹配。
405
+ 理解它还在评估中——这很谨慎,尤其在中大型遗留系统(10+ Specs)中,潜在的 context 刷新冲突或性能瓶颈(如文件监控开销)需实测。期待您后续体验分享!从项目描述看,`sce watch start` 的实时同步机制(监控变化、更新 AI 上下文)正适合动态环境,或许能进一步强化周期匹配。
406
406
 
407
407
  继续这个精彩对话,Guangyong!您的项目和观点正推动我对 AI"周期驱动"的新认知。
408
408
 
@@ -416,7 +416,7 @@ Spec 本身就是**边界 + 愿力**的具现:
416
416
 
417
417
  1. **范式转变**:AI 从"被动投喂"到"主动探寻",再到"原则驱动引擎"
418
418
  2. **哲学基础**:心学的"知行合一"与唯识论的"缘起缘灭"为 AI 实践提供理论支撑
419
- 3. **实践落地**:kiro-spec-engine 将理念转化为可操作的工程实践
419
+ 3. **实践落地**:scene-capability-engine 将理念转化为可操作的工程实践
420
420
  4. **未来展望**:AI 成为信息化世界的中心,人类专家转为"元专家"角色
421
421
 
422
422
  ### 关键洞见
@@ -428,7 +428,7 @@ Spec 本身就是**边界 + 愿力**的具现:
428
428
 
429
429
  ### 实践价值
430
430
 
431
- kiro-spec-engine 项目体现了:
431
+ scene-capability-engine 项目体现了:
432
432
  - 精确解决 session 上下文吞噬问题
433
433
  - 文档驱动 + 自动化治理
434
434
  - 高内聚、低耦合的天然实现
@@ -440,7 +440,7 @@ kiro-spec-engine 项目体现了:
440
440
  ## 项目链接
441
441
 
442
442
  - **GitHub**: https://github.com/heguangyong/scene-capability-engine
443
- - **npm**: https://www.npmjs.com/package/kiro-spec-engine
443
+ - **npm**: https://www.npmjs.com/package/scene-capability-engine
444
444
 
445
445
  如果这个项目对你有启发,欢迎 Star ⭐
446
446
 
@@ -478,7 +478,7 @@ kiro-spec-engine 项目体现了:
478
478
  ### 项目链接
479
479
  - **GitHub 源码**: https://github.com/heguangyong/scene-capability-engine
480
480
  - **GitHub 社区讨论**: https://github.com/heguangyong/scene-capability-engine/discussions/1
481
- - **npm 包**: https://www.npmjs.com/package/kiro-spec-engine
481
+ - **npm 包**: https://www.npmjs.com/package/scene-capability-engine
482
482
 
483
483
  ### 文章链接
484
484
  - **微信公众号**: https://mp.weixin.qq.com/s/GRo0XQ6GvQ03T4_FTvAsKA