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,14 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
## Overview
|
|
4
4
|
|
|
5
|
-
The Knowledge Management system allows you to build and maintain a personal knowledge base within your
|
|
5
|
+
The Knowledge Management system allows you to build and maintain a personal knowledge base within your sce projects. Capture experiences, patterns, best practices, and lessons learned as you work.
|
|
6
6
|
|
|
7
7
|
## Quick Start
|
|
8
8
|
|
|
9
9
|
### Initialize Knowledge Base
|
|
10
10
|
|
|
11
11
|
```bash
|
|
12
|
-
|
|
12
|
+
sce knowledge init
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
This creates `.kiro/knowledge/` directory with:
|
|
@@ -23,12 +23,12 @@ This creates `.kiro/knowledge/` directory with:
|
|
|
23
23
|
|
|
24
24
|
```bash
|
|
25
25
|
# Add a design pattern
|
|
26
|
-
|
|
26
|
+
sce knowledge add pattern "Repository Pattern Best Practices" \
|
|
27
27
|
--tags "design-pattern,database" \
|
|
28
28
|
--category backend
|
|
29
29
|
|
|
30
30
|
# Add a lesson learned
|
|
31
|
-
|
|
31
|
+
sce knowledge add lesson "Avoid N+1 Queries" \
|
|
32
32
|
--tags "performance,database" \
|
|
33
33
|
--category optimization
|
|
34
34
|
```
|
|
@@ -37,51 +37,51 @@ kse knowledge add lesson "Avoid N+1 Queries" \
|
|
|
37
37
|
|
|
38
38
|
```bash
|
|
39
39
|
# List all entries
|
|
40
|
-
|
|
40
|
+
sce knowledge list
|
|
41
41
|
|
|
42
42
|
# Filter by type
|
|
43
|
-
|
|
43
|
+
sce knowledge list --type pattern
|
|
44
44
|
|
|
45
45
|
# Filter by tag
|
|
46
|
-
|
|
46
|
+
sce knowledge list --tag database
|
|
47
47
|
|
|
48
48
|
# Sort by date
|
|
49
|
-
|
|
49
|
+
sce knowledge list --sort created:desc
|
|
50
50
|
```
|
|
51
51
|
|
|
52
52
|
### Search
|
|
53
53
|
|
|
54
54
|
```bash
|
|
55
55
|
# Search in titles and tags
|
|
56
|
-
|
|
56
|
+
sce knowledge search "database"
|
|
57
57
|
|
|
58
58
|
# Full-text search in content
|
|
59
|
-
|
|
59
|
+
sce knowledge search "repository" --full-text
|
|
60
60
|
```
|
|
61
61
|
|
|
62
62
|
### View Entry
|
|
63
63
|
|
|
64
64
|
```bash
|
|
65
|
-
|
|
65
|
+
sce knowledge show kb-1770099318706-4dmali
|
|
66
66
|
```
|
|
67
67
|
|
|
68
68
|
### Delete Entry
|
|
69
69
|
|
|
70
70
|
```bash
|
|
71
71
|
# With confirmation
|
|
72
|
-
|
|
72
|
+
sce knowledge delete kb-xxx
|
|
73
73
|
|
|
74
74
|
# Skip confirmation
|
|
75
|
-
|
|
75
|
+
sce knowledge delete kb-xxx --force
|
|
76
76
|
|
|
77
77
|
# Without backup
|
|
78
|
-
|
|
78
|
+
sce knowledge delete kb-xxx --force --no-backup
|
|
79
79
|
```
|
|
80
80
|
|
|
81
81
|
### Statistics
|
|
82
82
|
|
|
83
83
|
```bash
|
|
84
|
-
|
|
84
|
+
sce knowledge stats
|
|
85
85
|
```
|
|
86
86
|
|
|
87
87
|
## Entry Types
|
|
@@ -190,10 +190,10 @@ Content here...
|
|
|
190
190
|
|
|
191
191
|
```bash
|
|
192
192
|
# Export all entries
|
|
193
|
-
|
|
193
|
+
sce knowledge export --output my-knowledge.zip
|
|
194
194
|
|
|
195
195
|
# Import entries
|
|
196
|
-
|
|
196
|
+
sce knowledge import my-knowledge.zip
|
|
197
197
|
```
|
|
198
198
|
|
|
199
199
|
### Integration with Project
|
|
@@ -214,7 +214,7 @@ See implementation in `lib/repository/user-repository.js`
|
|
|
214
214
|
Error: Knowledge base not initialized
|
|
215
215
|
```
|
|
216
216
|
|
|
217
|
-
**Solution**: Run `
|
|
217
|
+
**Solution**: Run `sce knowledge init`
|
|
218
218
|
|
|
219
219
|
### Entry Not Found
|
|
220
220
|
|
|
@@ -222,7 +222,7 @@ Error: Knowledge base not initialized
|
|
|
222
222
|
Error: Entry not found: kb-xxx
|
|
223
223
|
```
|
|
224
224
|
|
|
225
|
-
**Solution**: Check ID with `
|
|
225
|
+
**Solution**: Check ID with `sce knowledge list`
|
|
226
226
|
|
|
227
227
|
### Corrupted Index
|
|
228
228
|
|
|
@@ -236,7 +236,7 @@ Error: Failed to load index
|
|
|
236
236
|
rm .kiro/knowledge/index.json
|
|
237
237
|
|
|
238
238
|
# Reinitialize
|
|
239
|
-
|
|
239
|
+
sce knowledge init
|
|
240
240
|
```
|
|
241
241
|
|
|
242
242
|
## FAQ
|
|
@@ -254,7 +254,7 @@ A: Commit `.kiro/knowledge/` to git (except `.backups/`).
|
|
|
254
254
|
A: Yes, create custom templates in `.kiro/knowledge/.templates/`.
|
|
255
255
|
|
|
256
256
|
**Q: How do I backup my knowledge?**
|
|
257
|
-
A: Use `
|
|
257
|
+
A: Use `sce knowledge export` or commit to git.
|
|
258
258
|
|
|
259
259
|
## See Also
|
|
260
260
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
## Overview
|
|
8
8
|
|
|
9
|
-
This guide provides step-by-step instructions for common workflows when using
|
|
9
|
+
This guide provides step-by-step instructions for common workflows when using scene-capability-engine without automation (watch mode or agent hooks). These workflows are designed to be efficient and easy to follow.
|
|
10
10
|
|
|
11
11
|
**When to use manual workflows:**
|
|
12
12
|
- When automation is not set up
|
|
@@ -35,7 +35,7 @@ Keep your workspace synchronized with task progress across multiple users or too
|
|
|
35
35
|
- Subsequent syncs: 30-60 seconds
|
|
36
36
|
|
|
37
37
|
### Prerequisites
|
|
38
|
-
- Project adopted with
|
|
38
|
+
- Project adopted with scene-capability-engine
|
|
39
39
|
- Active spec with tasks.md file
|
|
40
40
|
- Write access to .kiro/specs/ directory
|
|
41
41
|
|
|
@@ -43,7 +43,7 @@ Keep your workspace synchronized with task progress across multiple users or too
|
|
|
43
43
|
|
|
44
44
|
#### 1. Check Current Status
|
|
45
45
|
```bash
|
|
46
|
-
|
|
46
|
+
sce status
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
**What to look for:**
|
|
@@ -75,7 +75,7 @@ Open your spec's `tasks.md` file and review:
|
|
|
75
75
|
|
|
76
76
|
#### 3. Sync Workspace
|
|
77
77
|
```bash
|
|
78
|
-
|
|
78
|
+
sce workspace sync
|
|
79
79
|
```
|
|
80
80
|
|
|
81
81
|
**What this does:**
|
|
@@ -90,7 +90,7 @@ kse workspace sync
|
|
|
90
90
|
|
|
91
91
|
#### 4. Verify Sync
|
|
92
92
|
```bash
|
|
93
|
-
|
|
93
|
+
sce status
|
|
94
94
|
```
|
|
95
95
|
|
|
96
96
|
**Verify:**
|
|
@@ -116,7 +116,7 @@ kse status
|
|
|
116
116
|
|
|
117
117
|
3. **Team Coordination**
|
|
118
118
|
- Communicate task claims in team chat
|
|
119
|
-
- Use task claiming feature: `
|
|
119
|
+
- Use task claiming feature: `sce task claim <spec> <task-id>`
|
|
120
120
|
- Check for claimed tasks before starting work
|
|
121
121
|
|
|
122
122
|
---
|
|
@@ -138,7 +138,7 @@ Export spec context for sharing with AI assistants or team members.
|
|
|
138
138
|
|
|
139
139
|
#### 1. Identify Spec to Export
|
|
140
140
|
```bash
|
|
141
|
-
|
|
141
|
+
sce status
|
|
142
142
|
```
|
|
143
143
|
|
|
144
144
|
Note the spec name you want to export.
|
|
@@ -149,7 +149,7 @@ Note the spec name you want to export.
|
|
|
149
149
|
|
|
150
150
|
#### 2. Export Context
|
|
151
151
|
```bash
|
|
152
|
-
|
|
152
|
+
sce context export <spec-name>
|
|
153
153
|
```
|
|
154
154
|
|
|
155
155
|
**Options:**
|
|
@@ -159,7 +159,7 @@ kse context export <spec-name>
|
|
|
159
159
|
|
|
160
160
|
**Example:**
|
|
161
161
|
```bash
|
|
162
|
-
|
|
162
|
+
sce context export my-feature --include-steering --steering-files CORE_PRINCIPLES.md,ENVIRONMENT.md
|
|
163
163
|
```
|
|
164
164
|
|
|
165
165
|
**Time:** ~10-20 seconds
|
|
@@ -238,16 +238,16 @@ cat .kiro/specs/<spec-name>/tasks.md
|
|
|
238
238
|
|
|
239
239
|
#### 2. Generate Prompt
|
|
240
240
|
```bash
|
|
241
|
-
|
|
241
|
+
sce prompt generate <spec-name> <task-id>
|
|
242
242
|
```
|
|
243
243
|
|
|
244
244
|
**Options:**
|
|
245
|
-
- `--target <tool>`: Target tool (
|
|
245
|
+
- `--target <tool>`: Target tool (SCE, vscode, cursor, other)
|
|
246
246
|
- `--output <path>`: Custom output path
|
|
247
247
|
|
|
248
248
|
**Example:**
|
|
249
249
|
```bash
|
|
250
|
-
|
|
250
|
+
sce prompt generate my-feature 1.2 --target vscode
|
|
251
251
|
```
|
|
252
252
|
|
|
253
253
|
**Time:** ~10-15 seconds
|
|
@@ -281,7 +281,7 @@ For multiple tasks:
|
|
|
281
281
|
```bash
|
|
282
282
|
# Generate prompts for all incomplete tasks
|
|
283
283
|
for task in 1.1 1.2 1.3; do
|
|
284
|
-
|
|
284
|
+
sce prompt generate my-feature $task
|
|
285
285
|
done
|
|
286
286
|
```
|
|
287
287
|
|
|
@@ -316,8 +316,8 @@ done
|
|
|
316
316
|
### Daily Workflow Checklist
|
|
317
317
|
|
|
318
318
|
**Morning (Start of Work)**
|
|
319
|
-
- [ ] Sync workspace: `
|
|
320
|
-
- [ ] Check status: `
|
|
319
|
+
- [ ] Sync workspace: `sce workspace sync`
|
|
320
|
+
- [ ] Check status: `sce status`
|
|
321
321
|
- [ ] Review task list
|
|
322
322
|
- [ ] Claim tasks you'll work on
|
|
323
323
|
- [ ] Export context for active tasks
|
|
@@ -331,7 +331,7 @@ done
|
|
|
331
331
|
**End of Day**
|
|
332
332
|
- [ ] Mark completed tasks
|
|
333
333
|
- [ ] Update in-progress tasks
|
|
334
|
-
- [ ] Final sync: `
|
|
334
|
+
- [ ] Final sync: `sce workspace sync`
|
|
335
335
|
- [ ] Commit changes to version control
|
|
336
336
|
|
|
337
337
|
---
|
|
@@ -351,7 +351,7 @@ done
|
|
|
351
351
|
|
|
352
352
|
### Spec Creation Checklist
|
|
353
353
|
|
|
354
|
-
- [ ] Create spec: `
|
|
354
|
+
- [ ] Create spec: `sce spec bootstrap --name <name> --non-interactive`
|
|
355
355
|
- [ ] Write requirements.md
|
|
356
356
|
- [ ] Write design.md
|
|
357
357
|
- [ ] Generate tasks.md
|
|
@@ -396,8 +396,8 @@ done
|
|
|
396
396
|
|
|
397
397
|
1. **Set Up Automation:** Consider using watch mode for automatic workflows
|
|
398
398
|
```bash
|
|
399
|
-
|
|
400
|
-
|
|
399
|
+
sce watch init
|
|
400
|
+
sce watch install auto-sync
|
|
401
401
|
```
|
|
402
402
|
|
|
403
403
|
2. **Learn More:**
|
|
@@ -406,7 +406,7 @@ done
|
|
|
406
406
|
- [Architecture](./architecture.md)
|
|
407
407
|
|
|
408
408
|
3. **Get Help:**
|
|
409
|
-
- Run `
|
|
409
|
+
- Run `sce --help` for command reference
|
|
410
410
|
- Check [GitHub Issues](https://github.com/heguangyong/scene-capability-engine/issues)
|
|
411
411
|
- Review [Contributing Guide](../CONTRIBUTING.md)
|
|
412
412
|
|
|
@@ -1,20 +1,20 @@
|
|
|
1
|
-
|
|
1
|
+
# Moqui Capability Matrix For sce
|
|
2
2
|
|
|
3
|
-
This document defines the execution boundary for converting Moqui capabilities into
|
|
3
|
+
This document defines the execution boundary for converting Moqui capabilities into sce capabilities.
|
|
4
4
|
|
|
5
5
|
## Scope
|
|
6
6
|
|
|
7
|
-
- Goal: turn Moqui ERP resources into reusable
|
|
7
|
+
- Goal: turn Moqui ERP resources into reusable sce scene templates.
|
|
8
8
|
- Method: `extract -> normalize -> package-gate -> handoff-run -> release evidence`.
|
|
9
9
|
- Output: template assets with ontology, governance, and runtime-safe bindings.
|
|
10
10
|
|
|
11
11
|
## Capability Mapping
|
|
12
12
|
|
|
13
|
-
| Priority | Moqui Capability |
|
|
13
|
+
| Priority | Moqui Capability | sce Scene Pattern | Template ID | Ontology Anchors | Governance/Gate Focus | Status |
|
|
14
14
|
| --- | --- | --- | --- | --- | --- | --- |
|
|
15
|
-
| P0 | Order read (`OrderHeader`, `OrderItem`, query services) | `query` | `
|
|
16
|
-
| P0 | Order fulfillment (reserve, payment, release) | `workflow` | `
|
|
17
|
-
| P0 | Inventory reserve + adjust | `workflow/crud hybrid` | `
|
|
15
|
+
| P0 | Order read (`OrderHeader`, `OrderItem`, query services) | `query` | `sce.scene--erp-order-query-read--0.1.0` | `order_header`, `order_item`, `order_projection`, `customer_party` | low risk, idempotent query, lineage complete | template-ready |
|
|
16
|
+
| P0 | Order fulfillment (reserve, payment, release) | `workflow` | `sce.scene--erp-order-fulfillment-workflow--0.1.0` | `order_header`, `order_item`, `inventory_reservation`, `payment_authorization`, `fulfillment_execution` | medium risk, approval required, compensation strategy | template-ready |
|
|
17
|
+
| P0 | Inventory reserve + adjust | `workflow/crud hybrid` | `sce.scene--erp-inventory-reserve-adjust--0.1.0` | `inventory_item`, `inventory_reservation`, `inventory_adjustment`, `inventory_snapshot` | medium risk, approval required, non-negative stock rule | template-ready |
|
|
18
18
|
|
|
19
19
|
## Ownership Boundary
|
|
20
20
|
|
|
@@ -25,7 +25,7 @@ This document defines the execution boundary for converting Moqui capabilities i
|
|
|
25
25
|
- Handoff package (`docs/handoffs/handoff-manifest.json`) and ontology evidence.
|
|
26
26
|
- Real-world acceptance cases and risk context.
|
|
27
27
|
|
|
28
|
-
###
|
|
28
|
+
### sce owns
|
|
29
29
|
|
|
30
30
|
- Template contract normalization and packaging format.
|
|
31
31
|
- Ontology/gate enforcement and strict checks.
|
|
@@ -35,18 +35,18 @@ This document defines the execution boundary for converting Moqui capabilities i
|
|
|
35
35
|
## Batch Workflow
|
|
36
36
|
|
|
37
37
|
1. 331-poc exports spec/template/handoff artifacts.
|
|
38
|
-
2.
|
|
39
|
-
3.
|
|
40
|
-
4.
|
|
41
|
-
5.
|
|
42
|
-
6.
|
|
38
|
+
2. sce runs `auto handoff capability-matrix` as the fast intake gate.
|
|
39
|
+
3. sce runs `auto handoff run` with strict gates.
|
|
40
|
+
4. sce validates template registry and ontology consistency.
|
|
41
|
+
5. sce executes close-loop batch and snapshots observability.
|
|
42
|
+
6. sce archives evidence and publishes release.
|
|
43
43
|
|
|
44
44
|
## Fast Matrix Loop
|
|
45
45
|
|
|
46
46
|
Use this command during template iteration before full handoff execution:
|
|
47
47
|
|
|
48
48
|
```bash
|
|
49
|
-
|
|
49
|
+
sce auto handoff capability-matrix \
|
|
50
50
|
--manifest docs/handoffs/handoff-manifest.json \
|
|
51
51
|
--format markdown \
|
|
52
52
|
--out .kiro/reports/handoff-capability-matrix.md \
|
|
@@ -56,18 +56,18 @@ kse auto handoff capability-matrix \
|
|
|
56
56
|
|
|
57
57
|
`capability-matrix` now checks both capability coverage and semantic completeness (ontology entities/relations + governance business rules/decision logic) by default.
|
|
58
58
|
|
|
59
|
-
When gaps exist,
|
|
59
|
+
When gaps exist, sce writes remediation queue lines (default `.kiro/auto/moqui-remediation.lines`) that can be fed directly into:
|
|
60
60
|
|
|
61
61
|
```bash
|
|
62
|
-
|
|
62
|
+
sce auto close-loop-batch .kiro/auto/moqui-remediation.lines --format lines --json
|
|
63
63
|
```
|
|
64
64
|
|
|
65
65
|
## Definition Of Done
|
|
66
66
|
|
|
67
|
-
A capability is considered absorbed by
|
|
67
|
+
A capability is considered absorbed by sce when all checks pass:
|
|
68
68
|
|
|
69
|
-
- `
|
|
70
|
-
- `
|
|
71
|
-
- `
|
|
72
|
-
- `
|
|
73
|
-
- `
|
|
69
|
+
- `sce scene package-validate --strict`
|
|
70
|
+
- `sce scene lint --strict`
|
|
71
|
+
- `sce scene score --threshold 85`
|
|
72
|
+
- `sce scene ontology validate`
|
|
73
|
+
- `sce auto handoff run`
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Moqui Template Core Library Playbook
|
|
2
2
|
|
|
3
|
-
This playbook defines a generic (project-agnostic) path to absorb Moqui capabilities into the
|
|
3
|
+
This playbook defines a generic (project-agnostic) path to absorb Moqui capabilities into the sce core template library.
|
|
4
4
|
|
|
5
5
|
## Objectives
|
|
6
6
|
|
|
@@ -10,14 +10,14 @@ This playbook defines a generic (project-agnostic) path to absorb Moqui capabili
|
|
|
10
10
|
|
|
11
11
|
## Default Gate Baseline
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
sce defaults already enforce the baseline below:
|
|
14
14
|
|
|
15
|
-
- `
|
|
16
|
-
- `
|
|
17
|
-
- `
|
|
18
|
-
- `
|
|
19
|
-
- `
|
|
20
|
-
- `
|
|
15
|
+
- `sce auto handoff run`: ontology validation is required by default.
|
|
16
|
+
- `sce auto handoff run`: generates Moqui baseline snapshot by default and appends it to release-evidence sessions.
|
|
17
|
+
- `sce auto handoff run`: requires Moqui baseline portfolio pass by default.
|
|
18
|
+
- `sce auto handoff run`: evaluates capability coverage matrix by default when manifest `capabilities` is declared (default minimum `100%`).
|
|
19
|
+
- `sce auto handoff capability-matrix`: enforces both capability coverage and capability semantic completeness (default minimum `100%` for each).
|
|
20
|
+
- `sce scene package-publish-batch`:
|
|
21
21
|
- ontology validation required by default
|
|
22
22
|
- batch ontology gate defaults:
|
|
23
23
|
- average ontology score `>= 70`
|
|
@@ -33,16 +33,16 @@ Emergency bypass exists but is not recommended:
|
|
|
33
33
|
|
|
34
34
|
```bash
|
|
35
35
|
# 0) Generate template baseline scoreboard (Moqui/ERP templates by default)
|
|
36
|
-
|
|
36
|
+
sce scene moqui-baseline --json
|
|
37
37
|
|
|
38
38
|
# 0.1) CI/release mode: compare against previous baseline and enforce portfolio gate
|
|
39
|
-
|
|
39
|
+
sce scene moqui-baseline \
|
|
40
40
|
--compare-with .kiro/reports/release-evidence/moqui-template-baseline-prev.json \
|
|
41
41
|
--fail-on-portfolio-fail \
|
|
42
42
|
--json
|
|
43
43
|
|
|
44
44
|
# 0.2) Fast capability matrix gate (recommended before full handoff run)
|
|
45
|
-
|
|
45
|
+
sce auto handoff capability-matrix \
|
|
46
46
|
--manifest docs/handoffs/handoff-manifest.json \
|
|
47
47
|
--format markdown \
|
|
48
48
|
--out .kiro/reports/handoff-capability-matrix.md \
|
|
@@ -50,24 +50,24 @@ kse auto handoff capability-matrix \
|
|
|
50
50
|
--json
|
|
51
51
|
|
|
52
52
|
# 1) Handoff close-loop
|
|
53
|
-
|
|
53
|
+
sce auto handoff run --manifest docs/handoffs/handoff-manifest.json --json
|
|
54
54
|
|
|
55
55
|
# 2) Publish templates from scene packages (with default ontology gates)
|
|
56
|
-
|
|
56
|
+
sce scene package-publish-batch \
|
|
57
57
|
--manifest docs/handoffs/handoff-manifest.json \
|
|
58
58
|
--json
|
|
59
59
|
|
|
60
60
|
# 3) Persist ontology publish evidence for governance/review
|
|
61
|
-
|
|
61
|
+
sce scene package-publish-batch \
|
|
62
62
|
--manifest docs/handoffs/handoff-manifest.json \
|
|
63
63
|
--dry-run \
|
|
64
64
|
--ontology-report-out .kiro/reports/scene-package-ontology-batch.json \
|
|
65
65
|
--json
|
|
66
66
|
|
|
67
67
|
# 4) Validate registry + package gate
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
68
|
+
sce scene package-registry --template-dir .kiro/templates/scene-packages --strict --json
|
|
69
|
+
sce scene package-gate-template --out .kiro/templates/scene-package-gate-policy.json --profile three-layer --force --json
|
|
70
|
+
sce scene package-gate --registry .kiro/templates/scene-packages/registry.json --policy .kiro/templates/scene-package-gate-policy.json --strict --json
|
|
71
71
|
```
|
|
72
72
|
|
|
73
73
|
## Evidence Contract
|
|
@@ -80,7 +80,7 @@ Required artifacts for each intake batch:
|
|
|
80
80
|
- `.kiro/reports/release-evidence/moqui-template-baseline.md`
|
|
81
81
|
- `.kiro/reports/release-evidence/moqui-capability-coverage.json`
|
|
82
82
|
- `.kiro/reports/release-evidence/moqui-capability-coverage.md`
|
|
83
|
-
- `.kiro/reports/handoff-capability-matrix.md` (or JSON equivalent from `
|
|
83
|
+
- `.kiro/reports/handoff-capability-matrix.md` (or JSON equivalent from `sce auto handoff capability-matrix`)
|
|
84
84
|
- `.kiro/reports/handoff-runs/<session>.json`
|
|
85
85
|
- `.kiro/reports/scene-package-ontology-batch.json`
|
|
86
86
|
- `.kiro/auto/moqui-remediation.lines` (when baseline/coverage gaps exist)
|
|
@@ -99,11 +99,11 @@ Each accepted template should include ontology semantics for:
|
|
|
99
99
|
If any area is weak, export remediation queue lines and feed back to close-loop:
|
|
100
100
|
|
|
101
101
|
```bash
|
|
102
|
-
|
|
102
|
+
sce scene package-publish-batch \
|
|
103
103
|
--manifest docs/handoffs/handoff-manifest.json \
|
|
104
104
|
--dry-run \
|
|
105
105
|
--ontology-task-queue-out .kiro/auto/ontology-remediation.lines \
|
|
106
106
|
--json
|
|
107
107
|
|
|
108
|
-
|
|
108
|
+
sce auto close-loop-batch .kiro/auto/ontology-remediation.lines --format lines --json
|
|
109
109
|
```
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Multi-Agent Parallel Coordination Guide
|
|
2
2
|
|
|
3
|
-
> Enable multiple AI agents to work on the same
|
|
3
|
+
> Enable multiple AI agents to work on the same sce project simultaneously without conflicts.
|
|
4
4
|
|
|
5
5
|
**Version**: 1.44.0
|
|
6
6
|
**Last Updated**: 2026-02-12
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
|
|
10
10
|
## Overview
|
|
11
11
|
|
|
12
|
-
When multiple AI agent instances (e.g., multiple
|
|
12
|
+
When multiple AI agent instances (e.g., multiple AI IDE windows, Claude Code sessions, or Cursor instances) work on the same project, they can accidentally overwrite each other's changes, claim the same tasks, or corrupt shared files like `tasks.md`.
|
|
13
13
|
|
|
14
14
|
The Multi-Agent Parallel Coordination system solves this with six layers of protection:
|
|
15
15
|
|
|
@@ -56,7 +56,7 @@ Create the configuration file `.kiro/config/multi-agent.json`:
|
|
|
56
56
|
When an agent starts working, it registers with the AgentRegistry:
|
|
57
57
|
|
|
58
58
|
```javascript
|
|
59
|
-
const { AgentRegistry } = require('
|
|
59
|
+
const { AgentRegistry } = require('scene-capability-engine/lib/collab');
|
|
60
60
|
|
|
61
61
|
const registry = new AgentRegistry(workspaceRoot);
|
|
62
62
|
const { agentId } = await registry.register();
|
|
@@ -67,7 +67,7 @@ const { agentId } = await registry.register();
|
|
|
67
67
|
### 3. Lock Tasks Before Working
|
|
68
68
|
|
|
69
69
|
```javascript
|
|
70
|
-
const { TaskLockManager } = require('
|
|
70
|
+
const { TaskLockManager } = require('scene-capability-engine/lib/lock');
|
|
71
71
|
|
|
72
72
|
const lockManager = new TaskLockManager(workspaceRoot);
|
|
73
73
|
const result = await lockManager.acquireTaskLock('my-spec', '1.1', agentId);
|
|
@@ -124,7 +124,7 @@ Manages agent lifecycle with heartbeat-based health monitoring.
|
|
|
124
124
|
**Storage**: `.kiro/config/agent-registry.json`
|
|
125
125
|
|
|
126
126
|
```javascript
|
|
127
|
-
const { AgentRegistry } = require('
|
|
127
|
+
const { AgentRegistry } = require('scene-capability-engine/lib/collab');
|
|
128
128
|
const registry = new AgentRegistry(workspaceRoot);
|
|
129
129
|
|
|
130
130
|
// Register a new agent
|
|
@@ -157,7 +157,7 @@ File-based mutual exclusion for task ownership.
|
|
|
157
157
|
**Lock files**: `.kiro/specs/{specName}/locks/{taskId}.lock`
|
|
158
158
|
|
|
159
159
|
```javascript
|
|
160
|
-
const { TaskLockManager } = require('
|
|
160
|
+
const { TaskLockManager } = require('scene-capability-engine/lib/lock');
|
|
161
161
|
const lockManager = new TaskLockManager(workspaceRoot);
|
|
162
162
|
|
|
163
163
|
// Acquire a task lock
|
|
@@ -194,7 +194,7 @@ Concurrent-safe updates to `tasks.md` with conflict detection and retry.
|
|
|
194
194
|
**File**: `lib/task/task-status-store.js`
|
|
195
195
|
|
|
196
196
|
```javascript
|
|
197
|
-
const { TaskStatusStore } = require('
|
|
197
|
+
const { TaskStatusStore } = require('scene-capability-engine/lib/task');
|
|
198
198
|
const store = new TaskStatusStore(workspaceRoot);
|
|
199
199
|
|
|
200
200
|
// Update task status with file locking
|
|
@@ -223,7 +223,7 @@ Write serialization for steering files (`.kiro/steering/*.md`).
|
|
|
223
223
|
**File**: `lib/lock/steering-file-lock.js`
|
|
224
224
|
|
|
225
225
|
```javascript
|
|
226
|
-
const { SteeringFileLock } = require('
|
|
226
|
+
const { SteeringFileLock } = require('scene-capability-engine/lib/lock');
|
|
227
227
|
const steeringLock = new SteeringFileLock(workspaceRoot);
|
|
228
228
|
|
|
229
229
|
// Execute callback with lock held
|
|
@@ -249,7 +249,7 @@ Git branch isolation per agent for conflict-free parallel development.
|
|
|
249
249
|
**File**: `lib/collab/merge-coordinator.js`
|
|
250
250
|
|
|
251
251
|
```javascript
|
|
252
|
-
const { MergeCoordinator } = require('
|
|
252
|
+
const { MergeCoordinator } = require('scene-capability-engine/lib/collab');
|
|
253
253
|
const merger = new MergeCoordinator(workspaceRoot);
|
|
254
254
|
|
|
255
255
|
// Create agent-specific branch
|
|
@@ -277,7 +277,7 @@ When `coordinator: true` in config, provides intelligent task assignment based o
|
|
|
277
277
|
**Log**: `.kiro/config/coordination-log.json`
|
|
278
278
|
|
|
279
279
|
```javascript
|
|
280
|
-
const { Coordinator } = require('
|
|
280
|
+
const { Coordinator } = require('scene-capability-engine/lib/collab');
|
|
281
281
|
const coordinator = new Coordinator(workspaceRoot, depManager, registry, lockManager);
|
|
282
282
|
|
|
283
283
|
// Get tasks ready to execute (dependencies satisfied, not locked)
|
|
@@ -303,7 +303,7 @@ Per-Spec `steering.md` providing independent constraints, notes, and decisions f
|
|
|
303
303
|
**Storage**: `.kiro/specs/{spec-name}/steering.md`
|
|
304
304
|
|
|
305
305
|
```javascript
|
|
306
|
-
const { SpecSteering } = require('
|
|
306
|
+
const { SpecSteering } = require('scene-capability-engine/lib/steering');
|
|
307
307
|
const specSteering = new SpecSteering(workspaceRoot);
|
|
308
308
|
|
|
309
309
|
// Create a steering template for a new Spec
|
|
@@ -330,7 +330,7 @@ Unified loader that merges all four steering layers (L1-L4) into a single contex
|
|
|
330
330
|
**File**: `lib/steering/steering-loader.js`
|
|
331
331
|
|
|
332
332
|
```javascript
|
|
333
|
-
const { SteeringLoader } = require('
|
|
333
|
+
const { SteeringLoader } = require('scene-capability-engine/lib/steering');
|
|
334
334
|
const loader = new SteeringLoader(workspaceRoot);
|
|
335
335
|
|
|
336
336
|
// Load a specific layer
|
|
@@ -351,7 +351,7 @@ Multi-agent friendly maintenance of `CURRENT_CONTEXT.md` with structured Spec pr
|
|
|
351
351
|
**File**: `lib/steering/context-sync-manager.js`
|
|
352
352
|
|
|
353
353
|
```javascript
|
|
354
|
-
const { ContextSyncManager } = require('
|
|
354
|
+
const { ContextSyncManager } = require('scene-capability-engine/lib/steering');
|
|
355
355
|
const syncManager = new ContextSyncManager(workspaceRoot);
|
|
356
356
|
|
|
357
357
|
// Read current context
|
|
@@ -382,7 +382,7 @@ State machine managing Spec lifecycle transitions with auto-completion detection
|
|
|
382
382
|
Valid transitions: `planned → assigned → in-progress → completed → released`
|
|
383
383
|
|
|
384
384
|
```javascript
|
|
385
|
-
const { SpecLifecycleManager } = require('
|
|
385
|
+
const { SpecLifecycleManager } = require('scene-capability-engine/lib/collab');
|
|
386
386
|
const lifecycle = new SpecLifecycleManager(workspaceRoot);
|
|
387
387
|
|
|
388
388
|
// Get current Spec status
|
|
@@ -407,7 +407,7 @@ Ensures agents synchronize state before switching between Specs.
|
|
|
407
407
|
**File**: `lib/collab/sync-barrier.js`
|
|
408
408
|
|
|
409
409
|
```javascript
|
|
410
|
-
const { SyncBarrier } = require('
|
|
410
|
+
const { SyncBarrier } = require('scene-capability-engine/lib/collab');
|
|
411
411
|
const barrier = new SyncBarrier(workspaceRoot);
|
|
412
412
|
|
|
413
413
|
// Check before switching Specs
|
|
@@ -532,16 +532,16 @@ All components check `MultiAgentConfig.isEnabled()` before doing anything:
|
|
|
532
532
|
|
|
533
533
|
```javascript
|
|
534
534
|
// Collaboration modules
|
|
535
|
-
const { AgentRegistry, Coordinator, MergeCoordinator, MultiAgentConfig, SpecLifecycleManager, SyncBarrier } = require('
|
|
535
|
+
const { AgentRegistry, Coordinator, MergeCoordinator, MultiAgentConfig, SpecLifecycleManager, SyncBarrier } = require('scene-capability-engine/lib/collab');
|
|
536
536
|
|
|
537
537
|
// Steering modules
|
|
538
|
-
const { SpecSteering, SteeringLoader, ContextSyncManager } = require('
|
|
538
|
+
const { SpecSteering, SteeringLoader, ContextSyncManager } = require('scene-capability-engine/lib/steering');
|
|
539
539
|
|
|
540
540
|
// Lock modules
|
|
541
|
-
const { TaskLockManager, SteeringFileLock } = require('
|
|
541
|
+
const { TaskLockManager, SteeringFileLock } = require('scene-capability-engine/lib/lock');
|
|
542
542
|
|
|
543
543
|
// Task modules
|
|
544
|
-
const { TaskStatusStore } = require('
|
|
544
|
+
const { TaskStatusStore } = require('scene-capability-engine/lib/task');
|
|
545
545
|
```
|
|
546
546
|
|
|
547
547
|
---
|