scene-capability-engine 3.0.1 → 3.0.3
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 +235 -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 +31 -16
- 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/images/wechat-qr.png +0 -0
- 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 +43 -22
- package/docs/moqui-template-core-library-playbook.md +49 -21
- 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 +1148 -106
- 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 +30 -30
- 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 +258 -2
- 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/orchestrator/orchestration-engine.js +55 -6
- 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 Any AI Tool
|
|
2
2
|
|
|
3
|
-
> Universal integration guide for
|
|
3
|
+
> Universal integration guide for sce with any AI coding assistant
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
|
|
15
15
|
## Overview
|
|
16
16
|
|
|
17
|
-
This guide shows how to use
|
|
17
|
+
This guide shows how to use sce with **any AI coding tool**, including:
|
|
18
18
|
- ChatGPT
|
|
19
19
|
- Gemini
|
|
20
20
|
- Codeium
|
|
@@ -22,7 +22,7 @@ This guide shows how to use kse with **any AI coding tool**, including:
|
|
|
22
22
|
- Amazon CodeWhisperer
|
|
23
23
|
- Any other AI assistant
|
|
24
24
|
|
|
25
|
-
**
|
|
25
|
+
**sce works with any tool that can:**
|
|
26
26
|
- Accept text input
|
|
27
27
|
- Generate code
|
|
28
28
|
- Understand context
|
|
@@ -34,7 +34,7 @@ This guide shows how to use kse with **any AI coding tool**, including:
|
|
|
34
34
|
### The Basic Workflow
|
|
35
35
|
|
|
36
36
|
```
|
|
37
|
-
1. Create Spec in
|
|
37
|
+
1. Create Spec in sce
|
|
38
38
|
↓
|
|
39
39
|
2. Export context
|
|
40
40
|
↓
|
|
@@ -54,12 +54,12 @@ This pattern works with **every AI tool**.
|
|
|
54
54
|
### Prerequisites
|
|
55
55
|
|
|
56
56
|
- **Any AI tool** (web-based, IDE plugin, or CLI)
|
|
57
|
-
- **
|
|
58
|
-
- **Project adopted** (`
|
|
57
|
+
- **sce installed** (`npm install -g scene-capability-engine`)
|
|
58
|
+
- **Project adopted** (`sce adopt`)
|
|
59
59
|
|
|
60
60
|
### No Tool-Specific Setup Required
|
|
61
61
|
|
|
62
|
-
|
|
62
|
+
sce exports plain text that any AI can understand.
|
|
63
63
|
|
|
64
64
|
---
|
|
65
65
|
|
|
@@ -68,14 +68,14 @@ kse exports plain text that any AI can understand.
|
|
|
68
68
|
### Step 1: Create Your Spec
|
|
69
69
|
|
|
70
70
|
```bash
|
|
71
|
-
|
|
71
|
+
sce spec bootstrap --name 01-00-user-login --non-interactive
|
|
72
72
|
# Edit requirements.md, design.md, tasks.md
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
### Step 2: Export Context
|
|
76
76
|
|
|
77
77
|
```bash
|
|
78
|
-
|
|
78
|
+
sce context export 01-00-user-login
|
|
79
79
|
```
|
|
80
80
|
|
|
81
81
|
This creates `.kiro/specs/01-00-user-login/context-export.md`
|
|
@@ -187,7 +187,7 @@ class AuthController {
|
|
|
187
187
|
**Workflow:**
|
|
188
188
|
```bash
|
|
189
189
|
# Export context
|
|
190
|
-
|
|
190
|
+
sce context export 01-00-user-login
|
|
191
191
|
|
|
192
192
|
# Provide to CLI tool
|
|
193
193
|
your-ai-tool --context .kiro/specs/01-00-user-login/context-export.md
|
|
@@ -270,7 +270,7 @@ After each completed task, update `tasks.md` immediately.
|
|
|
270
270
|
|
|
271
271
|
**Solution:** Use task-specific prompts
|
|
272
272
|
```bash
|
|
273
|
-
|
|
273
|
+
sce prompt generate 01-00-user-login 1.1 --max-length=5000
|
|
274
274
|
```
|
|
275
275
|
|
|
276
276
|
### No File Access
|
|
@@ -290,11 +290,11 @@ Please implement AuthService that uses this User model.
|
|
|
290
290
|
|
|
291
291
|
### No Command Execution
|
|
292
292
|
|
|
293
|
-
**Problem:** AI can't run
|
|
293
|
+
**Problem:** AI can't run sce commands
|
|
294
294
|
|
|
295
295
|
**Solution:** Run commands yourself and provide output
|
|
296
296
|
```bash
|
|
297
|
-
|
|
297
|
+
sce status
|
|
298
298
|
# Copy output
|
|
299
299
|
|
|
300
300
|
# In AI tool:
|
|
@@ -377,15 +377,15 @@ What's wrong and how do I fix it?
|
|
|
377
377
|
|
|
378
378
|
If you're building an AI coding tool, consider:
|
|
379
379
|
|
|
380
|
-
**1. Native
|
|
380
|
+
**1. Native sce Support**
|
|
381
381
|
- Read `.kiro/specs/` directory
|
|
382
382
|
- Parse requirements.md, design.md, tasks.md
|
|
383
383
|
- Update tasks.md automatically
|
|
384
384
|
|
|
385
385
|
**2. Command Execution**
|
|
386
|
-
- Allow executing `
|
|
386
|
+
- Allow executing `sce context export`
|
|
387
387
|
- Read exported context files
|
|
388
|
-
- Execute `
|
|
388
|
+
- Execute `sce task claim` and `sce task unclaim`
|
|
389
389
|
|
|
390
390
|
**3. File Watching**
|
|
391
391
|
- Watch for Spec file changes
|
|
@@ -400,7 +400,7 @@ If you're building an AI coding tool, consider:
|
|
|
400
400
|
|
|
401
401
|
## Related Documentation
|
|
402
402
|
|
|
403
|
-
- **[Quick Start Guide](../quick-start.md)** - Get started with
|
|
403
|
+
- **[Quick Start Guide](../quick-start.md)** - Get started with sce
|
|
404
404
|
- **[Integration Modes](../integration-modes.md)** - Understanding integration modes
|
|
405
405
|
- **[Spec Workflow](../spec-workflow.md)** - Creating effective Specs
|
|
406
406
|
- **[Tool-Specific Guides](../tools/)** - Guides for specific tools
|
|
@@ -409,7 +409,7 @@ If you're building an AI coding tool, consider:
|
|
|
409
409
|
|
|
410
410
|
## Summary
|
|
411
411
|
|
|
412
|
-
**
|
|
412
|
+
**sce works with any AI tool:**
|
|
413
413
|
|
|
414
414
|
**Universal workflow:**
|
|
415
415
|
1. Create Spec
|
|
@@ -433,9 +433,9 @@ If you're building an AI coding tool, consider:
|
|
|
433
433
|
|
|
434
434
|
**Start using:** 🚀
|
|
435
435
|
```bash
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
436
|
+
sce adopt
|
|
437
|
+
sce spec bootstrap --name 01-00-my-feature --non-interactive
|
|
438
|
+
sce context export 01-00-my-feature
|
|
439
439
|
# Provide context to your AI tool
|
|
440
440
|
```
|
|
441
441
|
|
package/docs/tools/kiro-guide.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
# Using
|
|
1
|
+
# Using sce with AI IDE
|
|
2
2
|
|
|
3
|
-
> Native integration guide for
|
|
3
|
+
> Native integration guide for sce with AI IDE
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
**Version**: 1.42.0
|
|
8
8
|
**Last Updated**: 2026-02-11
|
|
9
|
-
**Tool**:
|
|
9
|
+
**Tool**: AI IDE
|
|
10
10
|
**Integration Mode**: Native Integration
|
|
11
11
|
**Estimated Setup Time**: None (built-in)
|
|
12
12
|
|
|
@@ -14,17 +14,17 @@
|
|
|
14
14
|
|
|
15
15
|
## Overview
|
|
16
16
|
|
|
17
|
-
**
|
|
17
|
+
**AI IDE** is the native development environment for sce with built-in Spec-driven development support.
|
|
18
18
|
|
|
19
|
-
**
|
|
19
|
+
**sce integration with SCE** uses **Native Integration** - no manual export needed, everything is automatic.
|
|
20
20
|
|
|
21
|
-
### Why Use
|
|
21
|
+
### Why Use sce with SCE?
|
|
22
22
|
|
|
23
23
|
- ✅ **Zero setup** - Works out of the box
|
|
24
24
|
- ✅ **Fully automatic** - No manual commands needed
|
|
25
25
|
- ✅ **Seamless workflow** - AI reads Specs directly
|
|
26
26
|
- ✅ **Auto task tracking** - Tasks update automatically
|
|
27
|
-
- ✅ **Best experience** - Purpose-built for
|
|
27
|
+
- ✅ **Best experience** - Purpose-built for sce
|
|
28
28
|
|
|
29
29
|
---
|
|
30
30
|
|
|
@@ -33,10 +33,10 @@
|
|
|
33
33
|
**Mode:** Native Integration (Fully Automatic)
|
|
34
34
|
|
|
35
35
|
**How it works:**
|
|
36
|
-
1. You create Specs in
|
|
37
|
-
2.
|
|
38
|
-
3.
|
|
39
|
-
4.
|
|
36
|
+
1. You create Specs in sce
|
|
37
|
+
2. SCE AI automatically reads Spec files
|
|
38
|
+
3. SCE AI implements features based on Specs
|
|
39
|
+
4. SCE AI updates tasks.md automatically
|
|
40
40
|
5. No manual export or copy-paste needed
|
|
41
41
|
|
|
42
42
|
---
|
|
@@ -45,12 +45,12 @@
|
|
|
45
45
|
|
|
46
46
|
### Prerequisites
|
|
47
47
|
|
|
48
|
-
- **
|
|
48
|
+
- **AI IDE installed**
|
|
49
49
|
- **Project with .kiro/ directory**
|
|
50
50
|
|
|
51
51
|
### No Setup Required!
|
|
52
52
|
|
|
53
|
-
|
|
53
|
+
AI IDE automatically detects and uses sce Specs. Just start working.
|
|
54
54
|
|
|
55
55
|
---
|
|
56
56
|
|
|
@@ -58,12 +58,12 @@ Kiro IDE automatically detects and uses kse Specs. Just start working.
|
|
|
58
58
|
|
|
59
59
|
### Method 1: Natural Language (Recommended) ⭐
|
|
60
60
|
|
|
61
|
-
**Simply tell
|
|
61
|
+
**Simply tell SCE what you want:**
|
|
62
62
|
|
|
63
63
|
```
|
|
64
64
|
You: "Implement the user login feature"
|
|
65
65
|
|
|
66
|
-
|
|
66
|
+
SCE AI:
|
|
67
67
|
[Automatically reads] .kiro/specs/01-00-user-login/
|
|
68
68
|
[Understands] Requirements, Design, Tasks
|
|
69
69
|
[Implements] Code according to design
|
|
@@ -78,7 +78,7 @@ Kiro AI:
|
|
|
78
78
|
```
|
|
79
79
|
You: "Check the Spec for 01-00-user-login and implement task 2.1"
|
|
80
80
|
|
|
81
|
-
|
|
81
|
+
SCE AI:
|
|
82
82
|
[Reads Spec]
|
|
83
83
|
[Implements task 2.1]
|
|
84
84
|
[Updates tasks.md]
|
|
@@ -90,7 +90,7 @@ Kiro AI:
|
|
|
90
90
|
```
|
|
91
91
|
You: "Review the design for user login and suggest improvements"
|
|
92
92
|
|
|
93
|
-
|
|
93
|
+
SCE AI:
|
|
94
94
|
[Reads design.md]
|
|
95
95
|
[Analyzes architecture]
|
|
96
96
|
[Provides feedback]
|
|
@@ -103,11 +103,11 @@ Kiro AI:
|
|
|
103
103
|
|
|
104
104
|
### Complete Feature Implementation
|
|
105
105
|
|
|
106
|
-
**1. Create Spec (using
|
|
106
|
+
**1. Create Spec (using SCE or command line)**
|
|
107
107
|
```
|
|
108
108
|
You: "Create a new Spec for user login"
|
|
109
109
|
|
|
110
|
-
|
|
110
|
+
SCE AI:
|
|
111
111
|
[Creates] .kiro/specs/01-00-user-login/
|
|
112
112
|
[Generates] requirements.md, design.md, tasks.md templates
|
|
113
113
|
[Opens] Files for editing
|
|
@@ -117,7 +117,7 @@ Kiro AI:
|
|
|
117
117
|
```
|
|
118
118
|
You: "Help me write the requirements for user login"
|
|
119
119
|
|
|
120
|
-
|
|
120
|
+
SCE AI:
|
|
121
121
|
[Suggests] User stories
|
|
122
122
|
[Suggests] Acceptance criteria
|
|
123
123
|
[Suggests] Non-functional requirements
|
|
@@ -127,7 +127,7 @@ Kiro AI:
|
|
|
127
127
|
```
|
|
128
128
|
You: "Implement this Spec"
|
|
129
129
|
|
|
130
|
-
|
|
130
|
+
SCE AI:
|
|
131
131
|
[Reads all Spec files]
|
|
132
132
|
[Implements all tasks]
|
|
133
133
|
[Runs tests]
|
|
@@ -139,7 +139,7 @@ Kiro AI:
|
|
|
139
139
|
```
|
|
140
140
|
You: "Show me what you implemented"
|
|
141
141
|
|
|
142
|
-
|
|
142
|
+
SCE AI:
|
|
143
143
|
[Shows] File changes
|
|
144
144
|
[Shows] Completed tasks
|
|
145
145
|
[Shows] Test results
|
|
@@ -151,39 +151,39 @@ Kiro AI:
|
|
|
151
151
|
|
|
152
152
|
### 1. Automatic Spec Detection
|
|
153
153
|
|
|
154
|
-
|
|
154
|
+
SCE automatically finds and reads Specs. No need to specify paths.
|
|
155
155
|
|
|
156
156
|
```
|
|
157
157
|
You: "What Specs do we have?"
|
|
158
|
-
|
|
158
|
+
SCE: "Found 3 Specs: 01-00-user-login, 02-00-password-reset, 03-00-user-profile"
|
|
159
159
|
```
|
|
160
160
|
|
|
161
161
|
### 2. Intelligent Task Management
|
|
162
162
|
|
|
163
|
-
|
|
163
|
+
SCE tracks tasks automatically.
|
|
164
164
|
|
|
165
165
|
```
|
|
166
166
|
You: "What's the status of user login?"
|
|
167
|
-
|
|
167
|
+
SCE: "5 tasks complete, 3 in progress, 2 not started. Next: Implement rate limiting"
|
|
168
168
|
```
|
|
169
169
|
|
|
170
170
|
### 3. Design-First Development
|
|
171
171
|
|
|
172
|
-
|
|
172
|
+
SCE enforces following the design.
|
|
173
173
|
|
|
174
174
|
```
|
|
175
175
|
You: "Implement AuthController"
|
|
176
|
-
|
|
176
|
+
SCE: [Reads design.md] [Implements exactly as designed] [No deviations]
|
|
177
177
|
```
|
|
178
178
|
|
|
179
179
|
### 4. Continuous Validation
|
|
180
180
|
|
|
181
|
-
|
|
181
|
+
SCE validates against requirements.
|
|
182
182
|
|
|
183
183
|
```
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
184
|
+
SCE: "Implementation complete. Validating against requirements..."
|
|
185
|
+
SCE: "✓ All acceptance criteria met"
|
|
186
|
+
SCE: "✓ All non-functional requirements satisfied"
|
|
187
187
|
```
|
|
188
188
|
|
|
189
189
|
---
|
|
@@ -192,7 +192,7 @@ Kiro: "✓ All non-functional requirements satisfied"
|
|
|
192
192
|
|
|
193
193
|
### 1. Trust the Automation
|
|
194
194
|
|
|
195
|
-
Let
|
|
195
|
+
Let SCE handle Spec reading and task tracking. Don't manually export context.
|
|
196
196
|
|
|
197
197
|
### 2. Use Natural Language
|
|
198
198
|
|
|
@@ -255,22 +255,22 @@ Also good: "Let's work on authentication"
|
|
|
255
255
|
|
|
256
256
|
## Troubleshooting
|
|
257
257
|
|
|
258
|
-
### Issue:
|
|
258
|
+
### Issue: SCE doesn't see my Spec
|
|
259
259
|
|
|
260
260
|
**Check:**
|
|
261
261
|
1. Spec is in `.kiro/specs/` directory
|
|
262
262
|
2. Spec has requirements.md, design.md, tasks.md
|
|
263
263
|
3. Files are not empty
|
|
264
264
|
|
|
265
|
-
### Issue:
|
|
265
|
+
### Issue: SCE doesn't follow design
|
|
266
266
|
|
|
267
|
-
**This shouldn't happen with
|
|
267
|
+
**This shouldn't happen with SCE.** If it does:
|
|
268
268
|
1. Check design.md is complete and clear
|
|
269
269
|
2. Report as a bug
|
|
270
270
|
|
|
271
271
|
### Issue: Tasks not updating
|
|
272
272
|
|
|
273
|
-
**This shouldn't happen with
|
|
273
|
+
**This shouldn't happen with SCE.** If it does:
|
|
274
274
|
1. Check tasks.md file permissions
|
|
275
275
|
2. Report as a bug
|
|
276
276
|
|
|
@@ -278,7 +278,7 @@ Also good: "Let's work on authentication"
|
|
|
278
278
|
|
|
279
279
|
## Related Documentation
|
|
280
280
|
|
|
281
|
-
- **[Quick Start Guide](../quick-start.md)** - Get started with
|
|
281
|
+
- **[Quick Start Guide](../quick-start.md)** - Get started with sce
|
|
282
282
|
- **[Integration Modes](../integration-modes.md)** - Understanding integration modes
|
|
283
283
|
- **[Spec Workflow](../spec-workflow.md)** - Creating effective Specs
|
|
284
284
|
|
|
@@ -286,19 +286,19 @@ Also good: "Let's work on authentication"
|
|
|
286
286
|
|
|
287
287
|
## Summary
|
|
288
288
|
|
|
289
|
-
**
|
|
289
|
+
**SCE + sce = Perfect Integration**
|
|
290
290
|
|
|
291
291
|
**Zero setup, zero manual work:**
|
|
292
292
|
1. Create Spec
|
|
293
|
-
2. Tell
|
|
294
|
-
3.
|
|
293
|
+
2. Tell SCE what to build
|
|
294
|
+
3. SCE does everything automatically
|
|
295
295
|
4. Review and approve
|
|
296
296
|
|
|
297
|
-
**This is the ideal
|
|
297
|
+
**This is the ideal sce experience.** All other tools require workarounds because they weren't built for sce. SCE was.
|
|
298
298
|
|
|
299
299
|
**Start using:** 🚀
|
|
300
300
|
```
|
|
301
|
-
Just open
|
|
301
|
+
Just open AI IDE and say:
|
|
302
302
|
"Create a Spec for user login and implement it"
|
|
303
303
|
```
|
|
304
304
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
# Using
|
|
1
|
+
# Using sce with VS Code + Copilot
|
|
2
2
|
|
|
3
|
-
> Integration guide for
|
|
3
|
+
> Integration guide for sce with Visual Studio Code and GitHub Copilot
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -16,12 +16,12 @@
|
|
|
16
16
|
|
|
17
17
|
**VS Code + Copilot** provides AI-powered code completion and suggestions as you type.
|
|
18
18
|
|
|
19
|
-
**
|
|
19
|
+
**sce integration** uses a hybrid approach:
|
|
20
20
|
- Export context for understanding
|
|
21
21
|
- Reference Specs in code comments
|
|
22
22
|
- Copilot suggests code based on Spec files
|
|
23
23
|
|
|
24
|
-
### Why Use
|
|
24
|
+
### Why Use sce with VS Code + Copilot?
|
|
25
25
|
|
|
26
26
|
- ✅ **IDE you already use** - No need to switch tools
|
|
27
27
|
- ✅ **Inline suggestions** - AI helps as you type
|
|
@@ -35,7 +35,7 @@
|
|
|
35
35
|
**Mode:** Manual Export + Inline Context
|
|
36
36
|
|
|
37
37
|
**How it works:**
|
|
38
|
-
1. Create Specs in
|
|
38
|
+
1. Create Specs in sce
|
|
39
39
|
2. Reference Specs in code comments
|
|
40
40
|
3. Copilot reads Spec files and suggests code
|
|
41
41
|
4. Optionally export context for Copilot Chat
|
|
@@ -48,8 +48,8 @@
|
|
|
48
48
|
|
|
49
49
|
- **VS Code installed** ([Download](https://code.visualstudio.com/))
|
|
50
50
|
- **GitHub Copilot extension** ([Install](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot))
|
|
51
|
-
- **
|
|
52
|
-
- **Project adopted** by
|
|
51
|
+
- **sce installed** globally (`npm install -g scene-capability-engine`)
|
|
52
|
+
- **Project adopted** by sce (`sce adopt`)
|
|
53
53
|
|
|
54
54
|
### Step 1: Configure VS Code Settings
|
|
55
55
|
|
|
@@ -69,12 +69,12 @@ Add to `.vscode/settings.json`:
|
|
|
69
69
|
|
|
70
70
|
### Step 2: Create Workspace Snippet (Optional)
|
|
71
71
|
|
|
72
|
-
Create `.vscode/
|
|
72
|
+
Create `.vscode/sce.code-snippets`:
|
|
73
73
|
|
|
74
74
|
```json
|
|
75
75
|
{
|
|
76
|
-
"
|
|
77
|
-
"prefix": "
|
|
76
|
+
"sce Spec Reference": {
|
|
77
|
+
"prefix": "sce-ref",
|
|
78
78
|
"body": [
|
|
79
79
|
"/**",
|
|
80
80
|
" * Spec: .kiro/specs/${1:spec-name}/",
|
|
@@ -84,7 +84,7 @@ Create `.vscode/kse.code-snippets`:
|
|
|
84
84
|
" * Design: ${4:design-summary}",
|
|
85
85
|
" */"
|
|
86
86
|
],
|
|
87
|
-
"description": "Reference
|
|
87
|
+
"description": "Reference sce Spec in code"
|
|
88
88
|
}
|
|
89
89
|
}
|
|
90
90
|
```
|
|
@@ -133,7 +133,7 @@ class AuthController {
|
|
|
133
133
|
|
|
134
134
|
**Step 1: Export context**
|
|
135
135
|
```bash
|
|
136
|
-
|
|
136
|
+
sce context export 01-00-user-login
|
|
137
137
|
```
|
|
138
138
|
|
|
139
139
|
**Step 2: Open Copilot Chat** (Ctrl+Shift+I or Cmd+Shift+I)
|
|
@@ -174,7 +174,7 @@ Please help me implement the AuthController.
|
|
|
174
174
|
|
|
175
175
|
**1. Create Spec**
|
|
176
176
|
```bash
|
|
177
|
-
|
|
177
|
+
sce spec bootstrap --name 01-00-user-login --non-interactive
|
|
178
178
|
# Edit requirements.md, design.md, tasks.md
|
|
179
179
|
```
|
|
180
180
|
|
|
@@ -403,7 +403,7 @@ Copilot considers all referenced files.
|
|
|
403
403
|
|
|
404
404
|
## Related Documentation
|
|
405
405
|
|
|
406
|
-
- **[Quick Start Guide](../quick-start.md)** - Get started with
|
|
406
|
+
- **[Quick Start Guide](../quick-start.md)** - Get started with sce
|
|
407
407
|
- **[Integration Modes](../integration-modes.md)** - Understanding integration modes
|
|
408
408
|
- **[Spec Workflow](../spec-workflow.md)** - Creating effective Specs
|
|
409
409
|
|
|
@@ -411,8 +411,8 @@ Copilot considers all referenced files.
|
|
|
411
411
|
|
|
412
412
|
## Summary
|
|
413
413
|
|
|
414
|
-
**VS Code + Copilot +
|
|
415
|
-
1. Create Spec in
|
|
414
|
+
**VS Code + Copilot + sce workflow:**
|
|
415
|
+
1. Create Spec in sce
|
|
416
416
|
2. Reference Spec in code comments
|
|
417
417
|
3. Let Copilot suggest implementations
|
|
418
418
|
4. Use Copilot Chat for complex logic
|
|
@@ -433,8 +433,8 @@ Copilot considers all referenced files.
|
|
|
433
433
|
|
|
434
434
|
**Start using:** 🚀
|
|
435
435
|
```bash
|
|
436
|
-
|
|
437
|
-
|
|
436
|
+
sce adopt
|
|
437
|
+
sce spec bootstrap --name 01-00-my-feature --non-interactive
|
|
438
438
|
# Open VS Code and start coding with Spec references
|
|
439
439
|
```
|
|
440
440
|
|