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.
- package/CHANGELOG.md +233 -233
- package/LICENSE +2 -2
- package/README.md +8 -11
- package/README.zh.md +7 -10
- package/bin/kse.js +1 -1
- package/bin/sce.js +1 -1
- package/bin/sco.js +1 -1
- package/docs/331-poc-adaptation-roadmap.md +25 -25
- package/docs/331-poc-dual-track-integration-guide.md +26 -26
- package/docs/331-poc-weekly-delivery-checklist.md +8 -8
- package/docs/OFFLINE_INSTALL.md +10 -10
- package/docs/README.md +24 -24
- package/docs/adopt-migration-guide.md +51 -51
- package/docs/adoption-guide.md +56 -56
- package/docs/agent-hooks-analysis.md +52 -52
- package/docs/architecture.md +6 -6
- package/docs/articles/ai-driven-development-philosophy-and-practice-review.md +4 -4
- package/docs/articles/ai-driven-development-philosophy-and-practice.en.md +9 -9
- package/docs/articles/ai-driven-development-philosophy-and-practice.md +10 -10
- package/docs/autonomous-control-guide.md +89 -89
- package/docs/command-reference.md +11 -11
- package/docs/community.md +4 -4
- package/docs/cross-tool-guide.md +47 -47
- package/docs/developer-guide.md +5 -5
- package/docs/document-governance.md +91 -91
- package/docs/environment-management-guide.md +53 -53
- package/docs/examples/add-export-command/design.md +2 -2
- package/docs/examples/add-export-command/requirements.md +5 -5
- package/docs/examples/add-export-command/tasks.md +2 -2
- package/docs/faq.md +69 -69
- package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.json +9 -9
- package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.md +3 -3
- package/docs/integration-modes.md +60 -60
- package/docs/integration-philosophy.md +48 -48
- package/docs/knowledge-management-guide.md +21 -21
- package/docs/manual-workflows-guide.md +20 -20
- package/docs/moqui-capability-matrix.md +22 -22
- package/docs/moqui-template-core-library-playbook.md +20 -20
- package/docs/multi-agent-coordination-guide.md +19 -19
- package/docs/multi-repo-management-guide.md +93 -93
- package/docs/quick-start-with-ai-tools.md +36 -36
- package/docs/quick-start.md +16 -16
- package/docs/release-checklist.md +7 -7
- package/docs/releases/v1.46.2-validation.md +1 -1
- package/docs/releases/v1.46.2.md +10 -10
- package/docs/scene-runtime-guide.md +42 -42
- package/docs/spec-collaboration-guide.md +43 -43
- package/docs/spec-locking-guide.md +26 -26
- package/docs/spec-numbering-guide.md +6 -6
- package/docs/spec-workflow.md +25 -25
- package/docs/steering-strategy-guide.md +36 -36
- package/docs/team-collaboration-guide.md +23 -23
- package/docs/testing-strategy.md +2 -2
- package/docs/tools/claude-guide.md +26 -26
- package/docs/tools/cursor-guide.md +31 -31
- package/docs/tools/generic-guide.md +22 -22
- package/docs/tools/kiro-guide.md +43 -43
- package/docs/tools/vscode-guide.md +18 -18
- package/docs/tools/windsurf-guide.md +50 -50
- package/docs/troubleshooting.md +116 -116
- package/docs/upgrade-guide.md +49 -49
- package/docs/value-observability-guide.md +6 -6
- package/docs/zh/README.md +22 -22
- package/docs/zh/quick-start.md +34 -34
- package/docs/zh/release-checklist.md +6 -6
- package/docs/zh/releases/v1.46.2-validation.md +1 -1
- package/docs/zh/releases/v1.46.2.md +9 -9
- package/docs/zh/spec-numbering-guide.md +6 -6
- package/docs/zh/tools/claude-guide.md +14 -14
- package/docs/zh/tools/cursor-guide.md +18 -18
- package/docs/zh/tools/generic-guide.md +40 -40
- package/docs/zh/tools/kiro-guide.md +50 -50
- package/docs/zh/tools/vscode-guide.md +20 -20
- package/docs/zh/tools/windsurf-guide.md +49 -49
- package/docs/zh/value-observability-guide.md +6 -6
- package/docs//344/272/244/344/273/230/346/270/205/345/215/225.md +4 -4
- package/lib/adoption/adoption-logger.js +1 -1
- package/lib/adoption/adoption-strategy.js +3 -3
- package/lib/adoption/detection-engine.js +1 -1
- package/lib/adoption/error-formatter.js +17 -17
- package/lib/adoption/progress-reporter.js +2 -2
- package/lib/adoption/smart-orchestrator.js +2 -2
- package/lib/adoption/strategy-selector.js +2 -2
- package/lib/adoption/summary-generator.js +3 -3
- package/lib/auto/autonomous-engine.js +2 -2
- package/lib/auto/close-loop-runner.js +9 -9
- package/lib/backup/backup-system.js +2 -2
- package/lib/collab/collab-manager.js +2 -2
- package/lib/commands/adopt.js +16 -16
- package/lib/commands/auto.js +93 -93
- package/lib/commands/collab.js +8 -8
- package/lib/commands/docs.js +26 -26
- package/lib/commands/doctor.js +2 -2
- package/lib/commands/env.js +14 -14
- package/lib/commands/knowledge.js +13 -13
- package/lib/commands/lock.js +6 -6
- package/lib/commands/ops.js +19 -19
- package/lib/commands/orchestrate.js +5 -5
- package/lib/commands/prompt.js +3 -3
- package/lib/commands/rollback.js +4 -4
- package/lib/commands/scene.js +29 -29
- package/lib/commands/spec-bootstrap.js +1 -1
- package/lib/commands/spec-gate.js +1 -1
- package/lib/commands/spec-pipeline.js +1 -1
- package/lib/commands/task.js +1 -1
- package/lib/commands/templates.js +27 -27
- package/lib/commands/upgrade.js +8 -8
- package/lib/commands/value.js +4 -4
- package/lib/commands/watch.js +9 -9
- package/lib/commands/workflows.js +5 -5
- package/lib/commands/workspace-multi.js +17 -17
- package/lib/commands/workspace.js +5 -5
- package/lib/context/context-exporter.js +1 -1
- package/lib/context/prompt-generator.js +1 -1
- package/lib/data/moqui-capability-lexicon.json +1 -1
- package/lib/environment/environment-manager.js +1 -1
- package/lib/gitignore/gitignore-detector.js +4 -4
- package/lib/gitignore/gitignore-integration.js +2 -2
- package/lib/gitignore/gitignore-transformer.js +3 -3
- package/lib/gitignore/layered-rules-template.js +2 -2
- package/lib/governance/diagnostic-engine.js +4 -4
- package/lib/governance/doc-reference-checker.js +1 -1
- package/lib/governance/hooks-manager.js +5 -5
- package/lib/governance/reporter.js +1 -1
- package/lib/knowledge/knowledge-manager.js +6 -6
- package/lib/orchestrator/agent-spawner.js +1 -1
- package/lib/orchestrator/bootstrap-prompt-builder.js +2 -2
- package/lib/repo/config-manager.js +2 -2
- package/lib/repo/handlers/init-handler.js +3 -3
- package/lib/scene-runtime/audit-emitter.js +2 -2
- package/lib/scene-runtime/binding-plugin-loader.js +1 -1
- package/lib/scene-runtime/moqui-adapter.js +2 -2
- package/lib/scene-runtime/moqui-extractor.js +3 -3
- package/lib/scene-runtime/scene-loader.js +3 -3
- package/lib/scene-runtime/scene-template-linter.js +1 -1
- package/lib/scene-runtime/templates/scene-template-erp-query-v0.1.yaml +1 -1
- package/lib/scene-runtime/templates/scene-template-hybrid-shadow-v0.1.yaml +1 -1
- package/lib/spec/multi-spec-orchestrate.js +1 -1
- package/lib/spec-gate/rules/default-rules.js +1 -1
- package/lib/steering/adoption-config.js +1 -1
- package/lib/steering/compliance-auto-fixer.js +1 -1
- package/lib/steering/compliance-cache.js +3 -3
- package/lib/steering/compliance-error-reporter.js +1 -1
- package/lib/steering/index.js +1 -1
- package/lib/steering/steering-manager.js +7 -7
- package/lib/task/task-claimer.js +2 -1
- package/lib/templates/metadata-collector.js +6 -6
- package/lib/templates/template-creator.js +2 -2
- package/lib/templates/template-exporter.js +12 -12
- package/lib/upgrade/migration-engine.js +4 -4
- package/lib/utils/tool-detector.js +25 -25
- package/lib/utils/validation.js +3 -3
- package/lib/version/version-checker.js +13 -13
- package/lib/version/version-manager.js +7 -7
- package/lib/watch/presets.js +4 -4
- package/lib/workspace/multi/path-utils.js +1 -1
- package/lib/workspace/multi/workspace-context-resolver.js +9 -9
- package/lib/workspace/multi/workspace-registry.js +2 -2
- package/lib/workspace/multi/workspace-state-manager.js +1 -1
- package/lib/workspace/multi/workspace.js +1 -1
- package/lib/workspace/workspace-sync.js +1 -1
- package/locales/en.json +1 -1
- package/locales/zh.json +1 -1
- package/package.json +3 -5
- package/template/.kiro/README.md +40 -40
- package/template/.kiro/specs/SPEC_WORKFLOW_GUIDE.md +3 -3
- package/template/.kiro/steering/CORE_PRINCIPLES.md +3 -3
- package/template/.kiro/steering/ENVIRONMENT.md +2 -2
- package/template/README.md +3 -3
- /package/bin/{kiro-spec-engine.js → scene-capability-engine.js} +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
# Using
|
|
1
|
+
# Using sce with Windsurf
|
|
2
2
|
|
|
3
|
-
> Complete guide to integrating
|
|
3
|
+
> Complete guide to integrating sce with Windsurf for automated AI-assisted development
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -16,17 +16,17 @@
|
|
|
16
16
|
|
|
17
17
|
**Windsurf** is an AI coding agent that can execute commands, modify files, and interact with your development environment autonomously.
|
|
18
18
|
|
|
19
|
-
**
|
|
20
|
-
- **Native-like**: Windsurf can execute
|
|
19
|
+
**sce integration with Windsurf** supports all three modes:
|
|
20
|
+
- **Native-like**: Windsurf can execute sce commands directly
|
|
21
21
|
- **Manual Export**: Traditional export and paste workflow
|
|
22
22
|
- **Watch Mode**: Automatic context updates
|
|
23
23
|
|
|
24
|
-
### Why Use
|
|
24
|
+
### Why Use sce with Windsurf?
|
|
25
25
|
|
|
26
|
-
- ✅ **Fully automated** - Windsurf can run
|
|
26
|
+
- ✅ **Fully automated** - Windsurf can run sce commands itself
|
|
27
27
|
- ✅ **Command execution** - No manual copy-paste needed
|
|
28
28
|
- ✅ **File modification** - Windsurf updates tasks.md automatically
|
|
29
|
-
- ✅ **Best automation** - Most seamless
|
|
29
|
+
- ✅ **Best automation** - Most seamless sce integration after SCE
|
|
30
30
|
|
|
31
31
|
---
|
|
32
32
|
|
|
@@ -36,17 +36,17 @@
|
|
|
36
36
|
|
|
37
37
|
**How it works:**
|
|
38
38
|
1. You tell Windsurf what to build
|
|
39
|
-
2. Windsurf executes `
|
|
39
|
+
2. Windsurf executes `sce context export` automatically
|
|
40
40
|
3. Windsurf reads the exported context
|
|
41
41
|
4. Windsurf implements the feature
|
|
42
42
|
5. Windsurf updates tasks.md automatically
|
|
43
43
|
|
|
44
44
|
**Example:**
|
|
45
45
|
```
|
|
46
|
-
You: "Implement the user login feature using
|
|
46
|
+
You: "Implement the user login feature using sce"
|
|
47
47
|
|
|
48
48
|
Windsurf:
|
|
49
|
-
[Executes]
|
|
49
|
+
[Executes] sce context export 01-00-user-login
|
|
50
50
|
[Reads] .kiro/specs/01-00-user-login/context-export.md
|
|
51
51
|
[Implements] Code according to design
|
|
52
52
|
[Updates] tasks.md with completed tasks
|
|
@@ -55,7 +55,7 @@ Windsurf:
|
|
|
55
55
|
### Mode 2: Watch Mode + Windsurf
|
|
56
56
|
|
|
57
57
|
**How it works:**
|
|
58
|
-
1. Start
|
|
58
|
+
1. Start sce watch mode
|
|
59
59
|
2. Edit Specs, context auto-updates
|
|
60
60
|
3. Windsurf always has latest context
|
|
61
61
|
4. Fully automated workflow
|
|
@@ -67,37 +67,37 @@ Windsurf:
|
|
|
67
67
|
### Prerequisites
|
|
68
68
|
|
|
69
69
|
- **Windsurf installed** ([Download](https://windsurf.ai/))
|
|
70
|
-
- **
|
|
71
|
-
- **Project adopted** by
|
|
70
|
+
- **sce installed** globally (`npm install -g scene-capability-engine`)
|
|
71
|
+
- **Project adopted** by sce (`sce adopt`)
|
|
72
72
|
|
|
73
73
|
### Step 1: Configure Windsurf System Prompt
|
|
74
74
|
|
|
75
75
|
Add to Windsurf's system prompt or project instructions:
|
|
76
76
|
|
|
77
77
|
```markdown
|
|
78
|
-
#
|
|
78
|
+
# sce Integration
|
|
79
79
|
|
|
80
|
-
This project uses
|
|
80
|
+
This project uses sce (Scene Capability Engine) for spec-driven development.
|
|
81
81
|
|
|
82
82
|
## Before Implementing Features
|
|
83
83
|
|
|
84
|
-
1. Check if a Spec exists: `
|
|
85
|
-
2. Export Spec context: `
|
|
84
|
+
1. Check if a Spec exists: `sce status`
|
|
85
|
+
2. Export Spec context: `sce context export <spec-name>`
|
|
86
86
|
3. Read the exported context file
|
|
87
87
|
4. Follow the design document exactly
|
|
88
88
|
5. Update tasks.md when completing tasks
|
|
89
89
|
|
|
90
|
-
##
|
|
90
|
+
## sce Commands
|
|
91
91
|
|
|
92
|
-
- `
|
|
93
|
-
- `
|
|
94
|
-
- `
|
|
95
|
-
- `
|
|
92
|
+
- `sce status` - Show project status and available Specs
|
|
93
|
+
- `sce context export <spec-name>` - Export Spec context
|
|
94
|
+
- `sce task claim <spec-name> <task-id>` - Claim a task
|
|
95
|
+
- `sce prompt generate <spec-name> <task-id>` - Generate task prompt
|
|
96
96
|
|
|
97
97
|
## Workflow
|
|
98
98
|
|
|
99
99
|
When user asks to implement a feature:
|
|
100
|
-
1. Run `
|
|
100
|
+
1. Run `sce context export <spec-name>`
|
|
101
101
|
2. Read `.kiro/specs/<spec-name>/context-export.md`
|
|
102
102
|
3. Implement according to design
|
|
103
103
|
4. Update `.kiro/specs/<spec-name>/tasks.md` (change [ ] to [x])
|
|
@@ -106,7 +106,7 @@ When user asks to implement a feature:
|
|
|
106
106
|
|
|
107
107
|
User: "Implement user login"
|
|
108
108
|
You should:
|
|
109
|
-
1. `
|
|
109
|
+
1. `sce context export 01-00-user-login`
|
|
110
110
|
2. Read context file
|
|
111
111
|
3. Implement AuthController, AuthService, etc.
|
|
112
112
|
4. Update tasks.md: `- [x] 1.1 Create AuthController`
|
|
@@ -115,9 +115,9 @@ You should:
|
|
|
115
115
|
### Step 2: Enable Watch Mode (Optional)
|
|
116
116
|
|
|
117
117
|
```bash
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
118
|
+
sce watch init
|
|
119
|
+
sce watch install context-export
|
|
120
|
+
sce watch start
|
|
121
121
|
```
|
|
122
122
|
|
|
123
123
|
---
|
|
@@ -128,16 +128,16 @@ kse watch start
|
|
|
128
128
|
|
|
129
129
|
**Step 1: Tell Windsurf what to build**
|
|
130
130
|
```
|
|
131
|
-
You: "I need to implement the user login feature. Use
|
|
131
|
+
You: "I need to implement the user login feature. Use sce to get the Spec and implement it."
|
|
132
132
|
```
|
|
133
133
|
|
|
134
134
|
**Step 2: Windsurf executes automatically**
|
|
135
135
|
```
|
|
136
136
|
Windsurf:
|
|
137
|
-
[Executes]
|
|
137
|
+
[Executes] sce status
|
|
138
138
|
[Output] Found Spec: 01-00-user-login
|
|
139
139
|
|
|
140
|
-
[Executes]
|
|
140
|
+
[Executes] sce context export 01-00-user-login
|
|
141
141
|
[Output] Context exported to context-export.md
|
|
142
142
|
|
|
143
143
|
[Reads] .kiro/specs/01-00-user-login/context-export.md
|
|
@@ -166,10 +166,10 @@ Windsurf:
|
|
|
166
166
|
|
|
167
167
|
**More control over implementation:**
|
|
168
168
|
```
|
|
169
|
-
You: "Use
|
|
169
|
+
You: "Use sce to get the user login Spec, then implement task 1.1 only"
|
|
170
170
|
|
|
171
171
|
Windsurf:
|
|
172
|
-
[Executes]
|
|
172
|
+
[Executes] sce context export 01-00-user-login
|
|
173
173
|
[Reads] context
|
|
174
174
|
[Implements] Only task 1.1
|
|
175
175
|
[Updates] tasks.md
|
|
@@ -186,7 +186,7 @@ Windsurf:
|
|
|
186
186
|
**Setup once, use forever:**
|
|
187
187
|
```bash
|
|
188
188
|
# Terminal 1: Start watch mode
|
|
189
|
-
|
|
189
|
+
sce watch start
|
|
190
190
|
|
|
191
191
|
# Terminal 2: Work with Windsurf
|
|
192
192
|
# Edit Specs → Context auto-updates → Windsurf always has latest
|
|
@@ -202,7 +202,7 @@ kse watch start
|
|
|
202
202
|
|
|
203
203
|
**1. Create Spec**
|
|
204
204
|
```bash
|
|
205
|
-
|
|
205
|
+
sce spec bootstrap --name 01-00-user-login --non-interactive
|
|
206
206
|
# Edit requirements.md, design.md, tasks.md
|
|
207
207
|
```
|
|
208
208
|
|
|
@@ -211,7 +211,7 @@ kse spec bootstrap --name 01-00-user-login --non-interactive
|
|
|
211
211
|
You: "I've created a Spec for user login at .kiro/specs/01-00-user-login/
|
|
212
212
|
|
|
213
213
|
Please:
|
|
214
|
-
1. Use
|
|
214
|
+
1. Use sce to export the context
|
|
215
215
|
2. Read the requirements and design
|
|
216
216
|
3. Implement all tasks in order
|
|
217
217
|
4. Update tasks.md as you complete each task
|
|
@@ -241,11 +241,11 @@ Windsurf:
|
|
|
241
241
|
|
|
242
242
|
## Tips & Best Practices
|
|
243
243
|
|
|
244
|
-
### 1. Let Windsurf Execute
|
|
244
|
+
### 1. Let Windsurf Execute sce Commands
|
|
245
245
|
|
|
246
246
|
**Good:**
|
|
247
247
|
```
|
|
248
|
-
"Use
|
|
248
|
+
"Use sce to get the Spec for user login and implement it"
|
|
249
249
|
```
|
|
250
250
|
|
|
251
251
|
**Not as good:**
|
|
@@ -263,7 +263,7 @@ Windsurf:
|
|
|
263
263
|
### 3. Use Task Claiming
|
|
264
264
|
|
|
265
265
|
```
|
|
266
|
-
"Before implementing, claim task 1.1 using:
|
|
266
|
+
"Before implementing, claim task 1.1 using: sce task claim 01-00-user-login 1.1"
|
|
267
267
|
```
|
|
268
268
|
|
|
269
269
|
### 4. Request Progress Updates
|
|
@@ -276,7 +276,7 @@ Windsurf:
|
|
|
276
276
|
|
|
277
277
|
```bash
|
|
278
278
|
# Keep watch mode running
|
|
279
|
-
|
|
279
|
+
sce watch start
|
|
280
280
|
|
|
281
281
|
# Tell Windsurf
|
|
282
282
|
"The Spec context auto-updates. Just read the latest context-export.md file"
|
|
@@ -329,9 +329,9 @@ kse watch start
|
|
|
329
329
|
|
|
330
330
|
## Troubleshooting
|
|
331
331
|
|
|
332
|
-
### Issue: Windsurf doesn't know about
|
|
332
|
+
### Issue: Windsurf doesn't know about sce
|
|
333
333
|
|
|
334
|
-
**Solution:** Add
|
|
334
|
+
**Solution:** Add sce instructions to system prompt (see Setup section)
|
|
335
335
|
|
|
336
336
|
### Issue: Windsurf doesn't update tasks.md
|
|
337
337
|
|
|
@@ -354,34 +354,34 @@ to:
|
|
|
354
354
|
|
|
355
355
|
## Related Documentation
|
|
356
356
|
|
|
357
|
-
- **[Quick Start Guide](../quick-start.md)** - Get started with
|
|
357
|
+
- **[Quick Start Guide](../quick-start.md)** - Get started with sce
|
|
358
358
|
- **[Integration Modes](../integration-modes.md)** - Understanding integration modes
|
|
359
|
-
- **[Command Reference](../command-reference.md)** - All
|
|
359
|
+
- **[Command Reference](../command-reference.md)** - All sce commands
|
|
360
360
|
|
|
361
361
|
---
|
|
362
362
|
|
|
363
363
|
## Summary
|
|
364
364
|
|
|
365
|
-
**Windsurf +
|
|
365
|
+
**Windsurf + sce = Most Automated Workflow**
|
|
366
366
|
|
|
367
367
|
**Key advantages:**
|
|
368
|
-
- ✅ Windsurf executes
|
|
368
|
+
- ✅ Windsurf executes sce commands automatically
|
|
369
369
|
- ✅ No manual copy-paste needed
|
|
370
370
|
- ✅ Automatic task tracking
|
|
371
371
|
- ✅ Full feature implementation with minimal intervention
|
|
372
372
|
|
|
373
373
|
**Best practices:**
|
|
374
|
-
- Configure system prompt with
|
|
375
|
-
- Let Windsurf execute
|
|
374
|
+
- Configure system prompt with sce instructions
|
|
375
|
+
- Let Windsurf execute sce commands
|
|
376
376
|
- Use watch mode for auto-updates
|
|
377
377
|
- Request progress updates
|
|
378
378
|
- Review before approving changes
|
|
379
379
|
|
|
380
380
|
**Start using:** 🚀
|
|
381
381
|
```bash
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
# Tell Windsurf: "Use
|
|
382
|
+
sce adopt
|
|
383
|
+
sce spec bootstrap --name 01-00-my-feature --non-interactive
|
|
384
|
+
# Tell Windsurf: "Use sce to implement 01-00-my-feature"
|
|
385
385
|
```
|
|
386
386
|
|
|
387
387
|
---
|