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
package/docs/faq.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Frequently Asked Questions (FAQ)
|
|
2
2
|
|
|
3
|
-
> Common questions about
|
|
3
|
+
> Common questions about sce and Spec-driven development
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -23,17 +23,17 @@
|
|
|
23
23
|
|
|
24
24
|
## General Questions
|
|
25
25
|
|
|
26
|
-
### What is
|
|
26
|
+
### What is sce?
|
|
27
27
|
|
|
28
|
-
**
|
|
28
|
+
**sce** (Scene Capability Engine) is a context provider for AI-assisted development. It helps you structure your feature development using Specs (specifications) and provides that context to AI coding tools.
|
|
29
29
|
|
|
30
|
-
Think of it as a **bridge between your brain and AI tools** - you describe what you want to build in a structured way, and
|
|
30
|
+
Think of it as a **bridge between your brain and AI tools** - you describe what you want to build in a structured way, and sce formats that information so AI tools can understand and implement it effectively.
|
|
31
31
|
|
|
32
32
|
---
|
|
33
33
|
|
|
34
|
-
### Why do I need
|
|
34
|
+
### Why do I need sce?
|
|
35
35
|
|
|
36
|
-
**Without
|
|
36
|
+
**Without sce:**
|
|
37
37
|
```
|
|
38
38
|
You: "Build a user login feature"
|
|
39
39
|
AI: "Sure! Here's some code..." [generates generic code]
|
|
@@ -41,7 +41,7 @@ You: "No, I need JWT tokens and PostgreSQL"
|
|
|
41
41
|
AI: "Oh, let me rewrite..." [starts over]
|
|
42
42
|
```
|
|
43
43
|
|
|
44
|
-
**With
|
|
44
|
+
**With sce:**
|
|
45
45
|
```
|
|
46
46
|
You: [Create Spec with requirements and design]
|
|
47
47
|
You: [Export context] "Implement task 1.1"
|
|
@@ -57,9 +57,9 @@ AI: [Reads your Spec] "Here's the code following your exact design..."
|
|
|
57
57
|
|
|
58
58
|
---
|
|
59
59
|
|
|
60
|
-
### Is
|
|
60
|
+
### Is sce only for AI development?
|
|
61
61
|
|
|
62
|
-
**No!** While
|
|
62
|
+
**No!** While sce is optimized for AI-assisted development, it's useful for any development:
|
|
63
63
|
|
|
64
64
|
**For AI development:**
|
|
65
65
|
- Provides structured context to AI tools
|
|
@@ -80,11 +80,11 @@ AI: [Reads your Spec] "Here's the code following your exact design..."
|
|
|
80
80
|
|
|
81
81
|
---
|
|
82
82
|
|
|
83
|
-
### Do I need to use
|
|
83
|
+
### Do I need to use AI IDE?
|
|
84
84
|
|
|
85
|
-
**No!**
|
|
85
|
+
**No!** sce works with any AI tool:
|
|
86
86
|
|
|
87
|
-
- **
|
|
87
|
+
- **AI IDE** - Native integration (fully automatic)
|
|
88
88
|
- **Claude Code** - Manual export (copy-paste context)
|
|
89
89
|
- **ChatGPT** - Manual export
|
|
90
90
|
- **Cursor** - Manual export
|
|
@@ -96,9 +96,9 @@ See [Integration Modes](integration-modes.md) for details.
|
|
|
96
96
|
|
|
97
97
|
---
|
|
98
98
|
|
|
99
|
-
### Is
|
|
99
|
+
### Is sce free?
|
|
100
100
|
|
|
101
|
-
**Yes!**
|
|
101
|
+
**Yes!** sce is open source and free to use.
|
|
102
102
|
|
|
103
103
|
- **License:** MIT
|
|
104
104
|
- **Source code:** https://github.com/heguangyong/scene-capability-engine
|
|
@@ -107,7 +107,7 @@ See [Integration Modes](integration-modes.md) for details.
|
|
|
107
107
|
|
|
108
108
|
---
|
|
109
109
|
|
|
110
|
-
### What's the difference between
|
|
110
|
+
### What's the difference between sce and [other tool]?
|
|
111
111
|
|
|
112
112
|
See [Comparison Questions](#comparison-questions) below.
|
|
113
113
|
|
|
@@ -115,12 +115,12 @@ See [Comparison Questions](#comparison-questions) below.
|
|
|
115
115
|
|
|
116
116
|
## Integration Questions
|
|
117
117
|
|
|
118
|
-
### Which AI tools work with
|
|
118
|
+
### Which AI tools work with sce?
|
|
119
119
|
|
|
120
|
-
**All of them!**
|
|
120
|
+
**All of them!** sce provides three integration modes:
|
|
121
121
|
|
|
122
122
|
**Native Integration** (automatic):
|
|
123
|
-
-
|
|
123
|
+
- AI IDE
|
|
124
124
|
|
|
125
125
|
**Manual Export** (copy-paste):
|
|
126
126
|
- Claude Code
|
|
@@ -137,19 +137,19 @@ See [Integration Modes Guide](integration-modes.md) for details.
|
|
|
137
137
|
|
|
138
138
|
---
|
|
139
139
|
|
|
140
|
-
### How do I use
|
|
140
|
+
### How do I use sce with Claude Code?
|
|
141
141
|
|
|
142
142
|
**Quick workflow:**
|
|
143
143
|
|
|
144
144
|
1. **Create Spec:**
|
|
145
145
|
```bash
|
|
146
|
-
|
|
146
|
+
sce spec bootstrap --name 01-00-user-login --non-interactive
|
|
147
147
|
# Edit requirements.md, design.md, tasks.md
|
|
148
148
|
```
|
|
149
149
|
|
|
150
150
|
2. **Export context:**
|
|
151
151
|
```bash
|
|
152
|
-
|
|
152
|
+
sce context export 01-00-user-login
|
|
153
153
|
```
|
|
154
154
|
|
|
155
155
|
3. **Copy to clipboard:**
|
|
@@ -175,13 +175,13 @@ See [Claude Guide](tools/claude-guide.md) for detailed instructions.
|
|
|
175
175
|
|
|
176
176
|
---
|
|
177
177
|
|
|
178
|
-
### Can I use
|
|
178
|
+
### Can I use sce with GitHub Copilot?
|
|
179
179
|
|
|
180
180
|
**Yes!** Two approaches:
|
|
181
181
|
|
|
182
182
|
**Approach 1: Manual export**
|
|
183
183
|
```bash
|
|
184
|
-
|
|
184
|
+
sce context export 01-00-user-login
|
|
185
185
|
# Reference context in code comments
|
|
186
186
|
```
|
|
187
187
|
|
|
@@ -203,14 +203,14 @@ See [VS Code Guide](tools/vscode-guide.md) for details.
|
|
|
203
203
|
|
|
204
204
|
| Mode | Automation | Setup | Best For |
|
|
205
205
|
|------|-----------|-------|----------|
|
|
206
|
-
| **Native** | Fully automatic | None |
|
|
206
|
+
| **Native** | Fully automatic | None | AI IDE users |
|
|
207
207
|
| **Manual Export** | Semi-manual | None | Quick start, any tool |
|
|
208
208
|
| **Watch Mode** | Auto-refresh | 5 minutes | Active development |
|
|
209
209
|
|
|
210
210
|
**Native Integration:**
|
|
211
211
|
- AI reads Specs directly
|
|
212
212
|
- No manual export needed
|
|
213
|
-
- Only works with
|
|
213
|
+
- Only works with AI IDE
|
|
214
214
|
|
|
215
215
|
**Manual Export:**
|
|
216
216
|
- You export context manually
|
|
@@ -305,7 +305,7 @@ vim .kiro/specs/01-00-user-login/design.md
|
|
|
305
305
|
|
|
306
306
|
# If using watch mode, context auto-updates
|
|
307
307
|
# If using manual export, re-export:
|
|
308
|
-
|
|
308
|
+
sce context export 01-00-user-login
|
|
309
309
|
```
|
|
310
310
|
|
|
311
311
|
**Best practices:**
|
|
@@ -334,7 +334,7 @@ kse context export 01-00-user-login
|
|
|
334
334
|
|
|
335
335
|
**Check progress:**
|
|
336
336
|
```bash
|
|
337
|
-
|
|
337
|
+
sce status
|
|
338
338
|
```
|
|
339
339
|
|
|
340
340
|
**Output:**
|
|
@@ -345,18 +345,18 @@ Progress: 1/2 tasks complete (50%)
|
|
|
345
345
|
- [ ] 1.2 Create AuthService
|
|
346
346
|
```
|
|
347
347
|
|
|
348
|
-
**With
|
|
348
|
+
**With AI IDE:**
|
|
349
349
|
- AI updates tasks automatically
|
|
350
350
|
- No manual checkbox editing needed
|
|
351
351
|
|
|
352
352
|
---
|
|
353
353
|
|
|
354
|
-
### Can I use
|
|
354
|
+
### Can I use sce for bug fixes?
|
|
355
355
|
|
|
356
356
|
**Yes!** Create a Spec for the bug:
|
|
357
357
|
|
|
358
358
|
```bash
|
|
359
|
-
|
|
359
|
+
sce spec bootstrap --name 01-01-fix-login-timeout --non-interactive
|
|
360
360
|
```
|
|
361
361
|
|
|
362
362
|
**requirements.md:**
|
|
@@ -393,12 +393,12 @@ JWT token expiration set to 300 seconds instead of 1800 seconds
|
|
|
393
393
|
|
|
394
394
|
---
|
|
395
395
|
|
|
396
|
-
### Can I use
|
|
396
|
+
### Can I use sce for refactoring?
|
|
397
397
|
|
|
398
398
|
**Absolutely!** Specs are great for refactoring:
|
|
399
399
|
|
|
400
400
|
```bash
|
|
401
|
-
|
|
401
|
+
sce spec bootstrap --name 02-00-refactor-auth-module --non-interactive
|
|
402
402
|
```
|
|
403
403
|
|
|
404
404
|
**requirements.md:**
|
|
@@ -438,7 +438,7 @@ kse spec bootstrap --name 02-00-refactor-auth-module --non-interactive
|
|
|
438
438
|
|
|
439
439
|
### Can I customize Spec templates?
|
|
440
440
|
|
|
441
|
-
**Yes!**
|
|
441
|
+
**Yes!** sce uses templates from `.kiro/templates/`:
|
|
442
442
|
|
|
443
443
|
```bash
|
|
444
444
|
# View current templates
|
|
@@ -469,25 +469,25 @@ vim .kiro/templates/tasks.md
|
|
|
469
469
|
|
|
470
470
|
---
|
|
471
471
|
|
|
472
|
-
### Can I use
|
|
472
|
+
### Can I use sce with multiple projects?
|
|
473
473
|
|
|
474
|
-
**Yes!** Each project has its own
|
|
474
|
+
**Yes!** Each project has its own sce installation:
|
|
475
475
|
|
|
476
476
|
```bash
|
|
477
477
|
# Project 1
|
|
478
478
|
cd ~/projects/project1
|
|
479
|
-
|
|
480
|
-
|
|
479
|
+
sce adopt
|
|
480
|
+
sce spec bootstrap --name 01-00-feature-a --non-interactive
|
|
481
481
|
|
|
482
482
|
# Project 2
|
|
483
483
|
cd ~/projects/project2
|
|
484
|
-
|
|
485
|
-
|
|
484
|
+
sce adopt
|
|
485
|
+
sce spec bootstrap --name 01-00-feature-b --non-interactive
|
|
486
486
|
```
|
|
487
487
|
|
|
488
488
|
**Each project has:**
|
|
489
489
|
- Own `.kiro/` directory
|
|
490
|
-
- Own `
|
|
490
|
+
- Own `sce.json` config
|
|
491
491
|
- Own Specs
|
|
492
492
|
- Own templates
|
|
493
493
|
|
|
@@ -507,7 +507,7 @@ git push
|
|
|
507
507
|
**Via export:**
|
|
508
508
|
```bash
|
|
509
509
|
# Export Spec as single file
|
|
510
|
-
|
|
510
|
+
sce context export 01-00-user-login
|
|
511
511
|
|
|
512
512
|
# Share context-export.md
|
|
513
513
|
```
|
|
@@ -526,13 +526,13 @@ kse context export 01-00-user-login
|
|
|
526
526
|
|
|
527
527
|
```bash
|
|
528
528
|
# Main feature
|
|
529
|
-
|
|
529
|
+
sce spec bootstrap --name 01-00-user-management --non-interactive
|
|
530
530
|
|
|
531
531
|
# Sub-features
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
532
|
+
sce spec bootstrap --name 01-01-user-registration --non-interactive
|
|
533
|
+
sce spec bootstrap --name 01-02-user-login --non-interactive
|
|
534
|
+
sce spec bootstrap --name 01-03-user-profile --non-interactive
|
|
535
|
+
sce spec bootstrap --name 01-04-password-reset --non-interactive
|
|
536
536
|
```
|
|
537
537
|
|
|
538
538
|
**Or use phases in tasks.md:**
|
|
@@ -552,23 +552,23 @@ kse spec bootstrap --name 01-04-password-reset --non-interactive
|
|
|
552
552
|
|
|
553
553
|
---
|
|
554
554
|
|
|
555
|
-
### Can I use
|
|
555
|
+
### Can I use sce for non-code projects?
|
|
556
556
|
|
|
557
557
|
**Yes!** Specs work for any structured work:
|
|
558
558
|
|
|
559
559
|
**Documentation project:**
|
|
560
560
|
```bash
|
|
561
|
-
|
|
561
|
+
sce spec bootstrap --name 01-00-api-documentation --non-interactive
|
|
562
562
|
```
|
|
563
563
|
|
|
564
564
|
**Design project:**
|
|
565
565
|
```bash
|
|
566
|
-
|
|
566
|
+
sce spec bootstrap --name 02-00-ui-redesign --non-interactive
|
|
567
567
|
```
|
|
568
568
|
|
|
569
569
|
**Process improvement:**
|
|
570
570
|
```bash
|
|
571
|
-
|
|
571
|
+
sce spec bootstrap --name 03-00-ci-cd-pipeline --non-interactive
|
|
572
572
|
```
|
|
573
573
|
|
|
574
574
|
**Specs provide structure for any project** with requirements, design, and tasks.
|
|
@@ -577,101 +577,101 @@ kse spec bootstrap --name 03-00-ci-cd-pipeline --non-interactive
|
|
|
577
577
|
|
|
578
578
|
## Comparison Questions
|
|
579
579
|
|
|
580
|
-
###
|
|
580
|
+
### sce vs. GitHub Issues
|
|
581
581
|
|
|
582
582
|
**GitHub Issues:**
|
|
583
583
|
- Track bugs and feature requests
|
|
584
584
|
- Discussion and collaboration
|
|
585
585
|
- Project management
|
|
586
586
|
|
|
587
|
-
**
|
|
587
|
+
**sce:**
|
|
588
588
|
- Structure feature implementation
|
|
589
589
|
- Provide context to AI tools
|
|
590
590
|
- Document design decisions
|
|
591
591
|
|
|
592
592
|
**Use both:**
|
|
593
593
|
- GitHub Issue: "Add user login feature"
|
|
594
|
-
-
|
|
594
|
+
- sce Spec: Detailed requirements, design, tasks for implementation
|
|
595
595
|
|
|
596
596
|
---
|
|
597
597
|
|
|
598
|
-
###
|
|
598
|
+
### sce vs. Jira/Linear
|
|
599
599
|
|
|
600
600
|
**Jira/Linear:**
|
|
601
601
|
- Project management
|
|
602
602
|
- Sprint planning
|
|
603
603
|
- Team coordination
|
|
604
604
|
|
|
605
|
-
**
|
|
605
|
+
**sce:**
|
|
606
606
|
- Feature specification
|
|
607
607
|
- AI context provider
|
|
608
608
|
- Implementation documentation
|
|
609
609
|
|
|
610
610
|
**Use both:**
|
|
611
611
|
- Jira ticket: "USER-123: Implement login"
|
|
612
|
-
-
|
|
612
|
+
- sce Spec: Technical specification for implementation
|
|
613
613
|
|
|
614
614
|
---
|
|
615
615
|
|
|
616
|
-
###
|
|
616
|
+
### sce vs. Confluence/Notion
|
|
617
617
|
|
|
618
618
|
**Confluence/Notion:**
|
|
619
619
|
- General documentation
|
|
620
620
|
- Knowledge base
|
|
621
621
|
- Team wiki
|
|
622
622
|
|
|
623
|
-
**
|
|
623
|
+
**sce:**
|
|
624
624
|
- Feature-specific documentation
|
|
625
625
|
- Structured format (requirements/design/tasks)
|
|
626
626
|
- AI-optimized context
|
|
627
627
|
|
|
628
628
|
**Use both:**
|
|
629
629
|
- Confluence: Architecture overview, team processes
|
|
630
|
-
-
|
|
630
|
+
- sce: Individual feature specifications
|
|
631
631
|
|
|
632
632
|
---
|
|
633
633
|
|
|
634
|
-
###
|
|
634
|
+
### sce vs. OpenAPI/Swagger
|
|
635
635
|
|
|
636
636
|
**OpenAPI/Swagger:**
|
|
637
637
|
- API documentation
|
|
638
638
|
- API contract
|
|
639
639
|
- API testing
|
|
640
640
|
|
|
641
|
-
**
|
|
641
|
+
**sce:**
|
|
642
642
|
- Full feature specification (not just API)
|
|
643
643
|
- Requirements and design rationale
|
|
644
644
|
- Implementation tasks
|
|
645
645
|
|
|
646
646
|
**Use both:**
|
|
647
|
-
-
|
|
647
|
+
- sce design.md: Include OpenAPI spec
|
|
648
648
|
- Generate OpenAPI from implementation
|
|
649
|
-
- Reference OpenAPI in
|
|
649
|
+
- Reference OpenAPI in sce Spec
|
|
650
650
|
|
|
651
651
|
---
|
|
652
652
|
|
|
653
|
-
###
|
|
653
|
+
### sce vs. ADRs (Architecture Decision Records)
|
|
654
654
|
|
|
655
655
|
**ADRs:**
|
|
656
656
|
- Document architectural decisions
|
|
657
657
|
- Explain why decisions were made
|
|
658
658
|
- Historical record
|
|
659
659
|
|
|
660
|
-
**
|
|
660
|
+
**sce:**
|
|
661
661
|
- Document feature implementation
|
|
662
662
|
- Provide context for AI
|
|
663
663
|
- Track implementation progress
|
|
664
664
|
|
|
665
665
|
**Use both:**
|
|
666
666
|
- ADR: "We chose PostgreSQL over MongoDB"
|
|
667
|
-
-
|
|
667
|
+
- sce Spec: "User login feature uses PostgreSQL"
|
|
668
668
|
|
|
669
669
|
---
|
|
670
670
|
|
|
671
671
|
## Related Documentation
|
|
672
672
|
|
|
673
|
-
- **[Quick Start Guide](quick-start.md)** - Get started with
|
|
674
|
-
- **[Integration Modes](integration-modes.md)** - How to use
|
|
673
|
+
- **[Quick Start Guide](quick-start.md)** - Get started with sce
|
|
674
|
+
- **[Integration Modes](integration-modes.md)** - How to use sce with AI tools
|
|
675
675
|
- **[Spec Workflow](spec-workflow.md)** - Understanding Specs
|
|
676
676
|
- **[Troubleshooting](troubleshooting.md)** - Common issues and solutions
|
|
677
677
|
|
|
@@ -681,7 +681,7 @@ kse spec bootstrap --name 03-00-ci-cd-pipeline --non-interactive
|
|
|
681
681
|
|
|
682
682
|
**Ask the community:**
|
|
683
683
|
- GitHub Discussions: https://github.com/heguangyong/scene-capability-engine/discussions
|
|
684
|
-
- Discord: [Join our Discord](https://discord.gg/
|
|
684
|
+
- Discord: [Join our Discord](https://discord.gg/sce)
|
|
685
685
|
- Twitter: [@kse_dev](https://twitter.com/kse_dev)
|
|
686
686
|
|
|
687
687
|
**Report issues:**
|
|
@@ -21,9 +21,9 @@
|
|
|
21
21
|
},
|
|
22
22
|
"templates": [
|
|
23
23
|
{
|
|
24
|
-
"template_id": "
|
|
25
|
-
"template_path": ".kiro\\templates\\scene-packages\\
|
|
26
|
-
"contract_path": ".kiro\\templates\\scene-packages\\
|
|
24
|
+
"template_id": "sce.scene--erp-inventory-reserve-adjust--0.1.0",
|
|
25
|
+
"template_path": ".kiro\\templates\\scene-packages\\sce.scene--erp-inventory-reserve-adjust--0.1.0",
|
|
26
|
+
"contract_path": ".kiro\\templates\\scene-packages\\sce.scene--erp-inventory-reserve-adjust--0.1.0\\scene-package.json",
|
|
27
27
|
"ontology": {
|
|
28
28
|
"valid": true,
|
|
29
29
|
"error_count": 0
|
|
@@ -65,9 +65,9 @@
|
|
|
65
65
|
}
|
|
66
66
|
},
|
|
67
67
|
{
|
|
68
|
-
"template_id": "
|
|
69
|
-
"template_path": ".kiro\\templates\\scene-packages\\
|
|
70
|
-
"contract_path": ".kiro\\templates\\scene-packages\\
|
|
68
|
+
"template_id": "sce.scene--erp-order-fulfillment-workflow--0.1.0",
|
|
69
|
+
"template_path": ".kiro\\templates\\scene-packages\\sce.scene--erp-order-fulfillment-workflow--0.1.0",
|
|
70
|
+
"contract_path": ".kiro\\templates\\scene-packages\\sce.scene--erp-order-fulfillment-workflow--0.1.0\\scene-package.json",
|
|
71
71
|
"ontology": {
|
|
72
72
|
"valid": true,
|
|
73
73
|
"error_count": 0
|
|
@@ -109,9 +109,9 @@
|
|
|
109
109
|
}
|
|
110
110
|
},
|
|
111
111
|
{
|
|
112
|
-
"template_id": "
|
|
113
|
-
"template_path": ".kiro\\templates\\scene-packages\\
|
|
114
|
-
"contract_path": ".kiro\\templates\\scene-packages\\
|
|
112
|
+
"template_id": "sce.scene--erp-order-query-read--0.1.0",
|
|
113
|
+
"template_path": ".kiro\\templates\\scene-packages\\sce.scene--erp-order-query-read--0.1.0",
|
|
114
|
+
"contract_path": ".kiro\\templates\\scene-packages\\sce.scene--erp-order-query-read--0.1.0\\scene-package.json",
|
|
115
115
|
"ontology": {
|
|
116
116
|
"valid": true,
|
|
117
117
|
"error_count": 0
|
|
@@ -19,6 +19,6 @@
|
|
|
19
19
|
|
|
20
20
|
| Template | Score | Graph | Baseline | Gaps |
|
|
21
21
|
| --- | ---: | --- | --- | --- |
|
|
22
|
-
|
|
|
23
|
-
|
|
|
24
|
-
|
|
|
22
|
+
| sce.scene--erp-inventory-reserve-adjust--0.1.0 | 100 | valid | pass | none |
|
|
23
|
+
| sce.scene--erp-order-fulfillment-workflow--0.1.0 | 100 | valid | pass | none |
|
|
24
|
+
| sce.scene--erp-order-query-read--0.1.0 | 100 | valid | pass | none |
|