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