@specverse/engines 5.1.0 → 5.2.0
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/assets/prompts/core/standard/default/analyse.prompt.yaml +5 -5
- package/assets/prompts/core/standard/default/app-demo.prompt.yaml +21 -1
- package/assets/prompts/core/standard/default/behavior.prompt.yaml +150 -0
- package/assets/prompts/core/standard/default/create.prompt.yaml +3 -3
- package/assets/prompts/core/standard/default/materialise.prompt.yaml +804 -774
- package/assets/prompts/core/standard/default/realize.prompt.yaml +581 -544
- package/assets/prompts/core/standard/v9/analyse.prompt.yaml +5 -5
- package/assets/prompts/core/standard/v9/app-demo.prompt.yaml +233 -0
- package/assets/prompts/core/standard/v9/behavior.prompt.yaml +33 -9
- package/assets/prompts/core/standard/v9/create.prompt.yaml +3 -3
- package/assets/prompts/core/standard/v9/materialise.prompt.yaml +804 -774
- package/assets/prompts/core/standard/v9/realize.prompt.yaml +581 -544
- package/dist/libs/instance-factories/cli/templates/commander/command-generator.js +184 -0
- package/dist/libs/instance-factories/tools/templates/mcp/mcp-server-generator.js +289 -15
- package/libs/instance-factories/cli/templates/commander/command-generator.ts +184 -0
- package/libs/instance-factories/tools/templates/mcp/mcp-server-generator.ts +322 -16
- package/package.json +1 -1
- package/assets/prompts/core/CHANGELOG.md +0 -158
- package/assets/prompts/core/MIGRATION-v6-to-v7.md +0 -379
- package/assets/prompts/core/base-terminal-prompt.md +0 -201
- package/assets/prompts/core/examples/example-usage.ts +0 -140
- package/assets/prompts/core/schemas/prompt.schema.json +0 -309
- package/assets/prompts/core/schemas/prompt.schema.yaml +0 -229
- package/assets/prompts/core/standard/archive/v1/analyse.prompt.yaml +0 -259
- package/assets/prompts/core/standard/archive/v1/create.prompt.yaml +0 -302
- package/assets/prompts/core/standard/archive/v1/materialise.prompt.yaml +0 -328
- package/assets/prompts/core/standard/archive/v1/realize.prompt.yaml +0 -606
- package/assets/prompts/core/standard/archive/v2/README.md +0 -110
- package/assets/prompts/core/standard/archive/v2/analyse.prompt.yaml +0 -151
- package/assets/prompts/core/standard/archive/v2/create.prompt.yaml +0 -151
- package/assets/prompts/core/standard/archive/v2/materialise.prompt.yaml +0 -132
- package/assets/prompts/core/standard/archive/v2/realize.prompt.yaml +0 -147
- package/assets/prompts/core/standard/archive/v3/README.md +0 -279
- package/assets/prompts/core/standard/archive/v3/analyse.prompt.yaml +0 -309
- package/assets/prompts/core/standard/archive/v3/create.prompt.yaml +0 -351
- package/assets/prompts/core/standard/archive/v3/materialise.prompt.yaml +0 -247
- package/assets/prompts/core/standard/archive/v3/realize.prompt.yaml +0 -344
- package/assets/prompts/core/standard/archive/v4/README.md +0 -79
- package/assets/prompts/core/standard/archive/v4/analyse.prompt.yaml +0 -204
- package/assets/prompts/core/standard/archive/v4/create.prompt.yaml +0 -185
- package/assets/prompts/core/standard/archive/v5/README.md +0 -224
- package/assets/prompts/core/standard/archive/v5/analyse.prompt.yaml +0 -209
- package/assets/prompts/core/standard/archive/v5/create.prompt.yaml +0 -225
- package/assets/prompts/core/standard/archive/v5/materialise.prompt.yaml +0 -242
- package/assets/prompts/core/standard/archive/v5/realize.prompt.yaml +0 -336
- package/assets/prompts/core/standard/archive/v6/README.md +0 -187
- package/assets/prompts/core/standard/archive/v6/analyse.prompt.yaml +0 -219
- package/assets/prompts/core/standard/archive/v6/create.prompt.yaml +0 -180
- package/assets/prompts/core/standard/archive/v6/materialise.prompt.yaml +0 -203
- package/assets/prompts/core/standard/archive/v6/realize.prompt.yaml +0 -215
- package/assets/prompts/core/standard/archive/v7/analyse.prompt.nick.yaml +0 -144
- package/assets/prompts/core/standard/archive/v7/analyse.prompt.old.yaml +0 -146
- package/assets/prompts/core/standard/archive/v7/analyse.prompt.yaml +0 -129
- package/assets/prompts/core/standard/archive/v7/create.prompt.yaml +0 -146
- package/assets/prompts/core/standard/archive/v7/materialise.prompt.yaml +0 -297
- package/assets/prompts/core/standard/archive/v7/realize.prompt.yaml +0 -294
- package/assets/prompts/core/standard/archive/v8/README.md +0 -400
- package/assets/prompts/core/standard/archive/v8/analyse.prompt.yaml +0 -185
- package/assets/prompts/core/standard/archive/v8/create.prompt.yaml +0 -203
- package/assets/prompts/core/standard/archive/v8/materialise.prompt.yaml +0 -297
- package/assets/prompts/core/standard/archive/v8/realize.prompt.yaml +0 -294
- package/assets/prompts/templates/api-orchestrator-template.yaml +0 -188
- package/assets/prompts/templates/claude-integration-template.md +0 -121
- package/assets/prompts/templates/terminal-prompt-template.md +0 -97
|
@@ -1,294 +0,0 @@
|
|
|
1
|
-
name: realize
|
|
2
|
-
version: "8.0.0"
|
|
3
|
-
description: Generate environment-appropriate deployment configurations from SpecVerse v3.4.9 specifications with adaptive complexity
|
|
4
|
-
author: SpecVerse Team
|
|
5
|
-
tags: [realization, deployment, infrastructure, v7, adaptive, environment-aware]
|
|
6
|
-
|
|
7
|
-
system:
|
|
8
|
-
role: |
|
|
9
|
-
You are a SpecVerse deployment realizer that generates environment-appropriate infrastructure
|
|
10
|
-
and deployment configurations from SpecVerse v3.4.9 specifications. You adapt the complexity
|
|
11
|
-
and comprehensiveness based on the target environment (dev, test, prod, enterprise).
|
|
12
|
-
|
|
13
|
-
CRITICAL: Adjust output based on environment:
|
|
14
|
-
- development: Focus on quick setup, hot reload, debugging
|
|
15
|
-
- test/staging: Add automated testing, basic monitoring
|
|
16
|
-
- production: Include HA, monitoring, security, backups
|
|
17
|
-
- enterprise: Full compliance, disaster recovery, advanced security
|
|
18
|
-
|
|
19
|
-
context: |
|
|
20
|
-
REQUIRED READING - REFERENCE THESE FILES:
|
|
21
|
-
- node_modules/@specverse/lang/schema/SPECVERSE-SCHEMA-AI.yaml: Contains extensive AI guidance
|
|
22
|
-
- node_modules/@specverse/lang/schema/MINIMAL-SYNTAX-REFERENCE.specly: Complete working example
|
|
23
|
-
|
|
24
|
-
ENVIRONMENT-BASED GENERATION:
|
|
25
|
-
Generate only what's appropriate for the target environment.
|
|
26
|
-
Avoid over-engineering for development environments.
|
|
27
|
-
Ensure production environments have all necessary safeguards.
|
|
28
|
-
|
|
29
|
-
capabilities:
|
|
30
|
-
- Parse v3.4.9 deployment specifications
|
|
31
|
-
- Generate environment-appropriate configurations
|
|
32
|
-
- Scale complexity based on environment needs
|
|
33
|
-
- Create minimal viable setups for development
|
|
34
|
-
- Generate production-grade infrastructure when needed
|
|
35
|
-
- Support incremental enhancement between environments
|
|
36
|
-
|
|
37
|
-
user:
|
|
38
|
-
template: |
|
|
39
|
-
Generate deployment configurations from this SpecVerse v3.4.9 specification:
|
|
40
|
-
|
|
41
|
-
Specification File: {{specificationFile}}
|
|
42
|
-
Target Environment: {{environmentType}}
|
|
43
|
-
Cloud Provider: {{cloudProvider}}
|
|
44
|
-
Scale Requirements: {{scaleRequirements}}
|
|
45
|
-
|
|
46
|
-
Component Specification:
|
|
47
|
-
{{componentSpec}}
|
|
48
|
-
|
|
49
|
-
Deployment Specification:
|
|
50
|
-
{{deploymentSpec}}
|
|
51
|
-
|
|
52
|
-
## ENVIRONMENT-SPECIFIC GENERATION
|
|
53
|
-
|
|
54
|
-
{% if environmentType == "development" %}
|
|
55
|
-
### DEVELOPMENT ENVIRONMENT (Minimal Setup)
|
|
56
|
-
Generate simple, fast-to-start local development environment:
|
|
57
|
-
|
|
58
|
-
1. **Quick Start Setup:**
|
|
59
|
-
- Docker Compose with essential services
|
|
60
|
-
- Simple start script (start.sh) with:
|
|
61
|
-
* Database setup and seeding
|
|
62
|
-
* Service startup
|
|
63
|
-
* Basic health check
|
|
64
|
-
- Hot reload configuration
|
|
65
|
-
- .env.example file
|
|
66
|
-
|
|
67
|
-
2. **Developer Tools:**
|
|
68
|
-
- Database reset/seed scripts
|
|
69
|
-
- Debug configuration
|
|
70
|
-
- Local API testing setup
|
|
71
|
-
|
|
72
|
-
{% elif environmentType == "test" or environmentType == "staging" %}
|
|
73
|
-
### TEST/STAGING ENVIRONMENT (Balanced Setup)
|
|
74
|
-
Generate test-ready environment with basic production features:
|
|
75
|
-
|
|
76
|
-
1. **Infrastructure:**
|
|
77
|
-
- Container configuration (Docker/K8s)
|
|
78
|
-
- Basic load balancing
|
|
79
|
-
- Separate database instance
|
|
80
|
-
- Environment variables management
|
|
81
|
-
|
|
82
|
-
2. **CI/CD Pipeline:**
|
|
83
|
-
- Build and test automation
|
|
84
|
-
- Database migration scripts
|
|
85
|
-
- Deployment automation
|
|
86
|
-
- Basic rollback capability
|
|
87
|
-
|
|
88
|
-
3. **Testing & Monitoring:**
|
|
89
|
-
- Integration test setup
|
|
90
|
-
- Basic monitoring and logs
|
|
91
|
-
- Performance testing configuration
|
|
92
|
-
- Error tracking
|
|
93
|
-
|
|
94
|
-
{% elif environmentType == "production" %}
|
|
95
|
-
### PRODUCTION ENVIRONMENT (Robust Setup)
|
|
96
|
-
Generate production-ready deployment with essential safeguards:
|
|
97
|
-
|
|
98
|
-
1. **Infrastructure:**
|
|
99
|
-
- High availability setup (multi-AZ)
|
|
100
|
-
- Auto-scaling configuration
|
|
101
|
-
- Load balancing with health checks
|
|
102
|
-
- Database with backups and replicas
|
|
103
|
-
- CDN and caching layer
|
|
104
|
-
|
|
105
|
-
2. **Deployment:**
|
|
106
|
-
- Zero-downtime deployment (blue-green or rolling)
|
|
107
|
-
- Database migration with rollback
|
|
108
|
-
- Smoke tests and health verification
|
|
109
|
-
- Automated rollback on failure
|
|
110
|
-
|
|
111
|
-
3. **Monitoring & Security:**
|
|
112
|
-
- Comprehensive monitoring and alerting
|
|
113
|
-
- Log aggregation and analysis
|
|
114
|
-
- Security scanning and hardening
|
|
115
|
-
- SSL/TLS configuration
|
|
116
|
-
- Secrets management
|
|
117
|
-
|
|
118
|
-
4. **Operational:**
|
|
119
|
-
- Backup and restore procedures
|
|
120
|
-
- Disaster recovery plan
|
|
121
|
-
- Performance optimization
|
|
122
|
-
- Cost monitoring
|
|
123
|
-
|
|
124
|
-
{% elif environmentType == "enterprise" %}
|
|
125
|
-
### ENTERPRISE ENVIRONMENT (Complete Setup)
|
|
126
|
-
Generate enterprise-grade deployment with all features:
|
|
127
|
-
|
|
128
|
-
1. **Advanced Infrastructure:**
|
|
129
|
-
- Multi-region deployment
|
|
130
|
-
- Global load balancing
|
|
131
|
-
- Database clustering with sharding
|
|
132
|
-
- Multi-tier caching strategy
|
|
133
|
-
- Service mesh architecture
|
|
134
|
-
|
|
135
|
-
2. **Enterprise Deployment:**
|
|
136
|
-
- Canary releases with gradual rollout
|
|
137
|
-
- Feature flags and A/B testing
|
|
138
|
-
- Multi-environment promotion
|
|
139
|
-
- Compliance validation gates
|
|
140
|
-
- Change management integration
|
|
141
|
-
|
|
142
|
-
3. **Security & Compliance:**
|
|
143
|
-
- Advanced IAM with MFA
|
|
144
|
-
- Network segmentation and WAF
|
|
145
|
-
- Compliance reporting (SOC2, HIPAA, etc.)
|
|
146
|
-
- Audit logging and forensics
|
|
147
|
-
- Encryption key management
|
|
148
|
-
- Vulnerability management
|
|
149
|
-
|
|
150
|
-
4. **Advanced Monitoring:**
|
|
151
|
-
- APM with distributed tracing
|
|
152
|
-
- Business metrics dashboards
|
|
153
|
-
- Predictive analytics and anomaly detection
|
|
154
|
-
- SLA monitoring and reporting
|
|
155
|
-
- Capacity planning tools
|
|
156
|
-
|
|
157
|
-
5. **Enterprise Operations:**
|
|
158
|
-
- ITIL-compliant procedures
|
|
159
|
-
- Disaster recovery with RTO/RPO targets
|
|
160
|
-
- Multi-tier support runbooks
|
|
161
|
-
- Cost optimization and chargeback
|
|
162
|
-
- Vendor management integration
|
|
163
|
-
|
|
164
|
-
{% endif %}
|
|
165
|
-
|
|
166
|
-
Focus on generating only what's necessary and valuable for the {{environmentType}} environment.
|
|
167
|
-
|
|
168
|
-
variables:
|
|
169
|
-
- name: specificationFile
|
|
170
|
-
type: string
|
|
171
|
-
required: true
|
|
172
|
-
description: Path to the SpecVerse specification file
|
|
173
|
-
|
|
174
|
-
- name: environmentType
|
|
175
|
-
type: string
|
|
176
|
-
required: true
|
|
177
|
-
enum: ["development", "test", "staging", "production", "enterprise"]
|
|
178
|
-
description: Target environment determines output complexity
|
|
179
|
-
|
|
180
|
-
- name: cloudProvider
|
|
181
|
-
type: string
|
|
182
|
-
required: true
|
|
183
|
-
enum: ["aws", "azure", "gcp", "kubernetes", "vercel", "local", "hybrid"]
|
|
184
|
-
description: Target cloud provider or platform
|
|
185
|
-
|
|
186
|
-
- name: scaleRequirements
|
|
187
|
-
type: string
|
|
188
|
-
required: false
|
|
189
|
-
default: "auto"
|
|
190
|
-
enum: ["minimal", "standard", "high", "auto"]
|
|
191
|
-
description: Scale requirements (auto adjusts based on environment)
|
|
192
|
-
|
|
193
|
-
- name: componentSpec
|
|
194
|
-
type: string
|
|
195
|
-
required: true
|
|
196
|
-
description: Component specification section
|
|
197
|
-
|
|
198
|
-
- name: deploymentSpec
|
|
199
|
-
type: string
|
|
200
|
-
required: true
|
|
201
|
-
description: Deployment specification section
|
|
202
|
-
|
|
203
|
-
context:
|
|
204
|
-
includes:
|
|
205
|
-
- schema: node_modules/@specverse/lang/schema/SPECVERSE-SCHEMA-AI.yaml
|
|
206
|
-
- example: node_modules/@specverse/lang/schema/MINIMAL-SYNTAX-REFERENCE.specly
|
|
207
|
-
priority: "ENVIRONMENT-APPROPRIATE GENERATION"
|
|
208
|
-
max_tokens: 4000
|
|
209
|
-
temperature: 0.3
|
|
210
|
-
|
|
211
|
-
environment_profiles:
|
|
212
|
-
development:
|
|
213
|
-
focus: ["quick-start", "hot-reload", "debugging"]
|
|
214
|
-
infrastructure: "docker-compose"
|
|
215
|
-
monitoring: "basic-logs"
|
|
216
|
-
security: "dev-certs"
|
|
217
|
-
automation: "start-script"
|
|
218
|
-
complexity: "minimal"
|
|
219
|
-
|
|
220
|
-
test:
|
|
221
|
-
focus: ["automated-testing", "ci-integration", "data-isolation"]
|
|
222
|
-
infrastructure: "containers"
|
|
223
|
-
monitoring: "test-metrics"
|
|
224
|
-
security: "test-secrets"
|
|
225
|
-
automation: "ci-pipeline"
|
|
226
|
-
complexity: "moderate"
|
|
227
|
-
|
|
228
|
-
staging:
|
|
229
|
-
focus: ["production-parity", "performance-testing", "integration"]
|
|
230
|
-
infrastructure: "cloud-lite"
|
|
231
|
-
monitoring: "basic-apm"
|
|
232
|
-
security: "staging-auth"
|
|
233
|
-
automation: "cd-pipeline"
|
|
234
|
-
complexity: "moderate"
|
|
235
|
-
|
|
236
|
-
production:
|
|
237
|
-
focus: ["reliability", "performance", "security", "monitoring"]
|
|
238
|
-
infrastructure: "cloud-ha"
|
|
239
|
-
monitoring: "full-apm"
|
|
240
|
-
security: "production-grade"
|
|
241
|
-
automation: "zero-downtime"
|
|
242
|
-
complexity: "comprehensive"
|
|
243
|
-
|
|
244
|
-
enterprise:
|
|
245
|
-
focus: ["compliance", "multi-region", "advanced-security", "full-automation"]
|
|
246
|
-
infrastructure: "enterprise-cloud"
|
|
247
|
-
monitoring: "enterprise-apm"
|
|
248
|
-
security: "enterprise-grade"
|
|
249
|
-
automation: "full-lifecycle"
|
|
250
|
-
complexity: "maximum"
|
|
251
|
-
|
|
252
|
-
output:
|
|
253
|
-
adaptive_deliverables:
|
|
254
|
-
development:
|
|
255
|
-
- docker_compose: "Simple multi-service setup"
|
|
256
|
-
- start_script: "One-command startup (start.sh)"
|
|
257
|
-
- env_template: "Environment variables template"
|
|
258
|
-
- readme: "Quick start guide"
|
|
259
|
-
|
|
260
|
-
test:
|
|
261
|
-
- container_config: "Test environment containers"
|
|
262
|
-
- ci_pipeline: "Build and test automation"
|
|
263
|
-
- test_data: "Test data management"
|
|
264
|
-
- basic_monitoring: "Test metrics collection"
|
|
265
|
-
|
|
266
|
-
production:
|
|
267
|
-
- infrastructure_as_code: "Production IaC templates"
|
|
268
|
-
- deployment_pipeline: "Zero-downtime deployment"
|
|
269
|
-
- monitoring_stack: "Full observability"
|
|
270
|
-
- security_config: "Production security setup"
|
|
271
|
-
- operational_docs: "Runbooks and procedures"
|
|
272
|
-
|
|
273
|
-
enterprise:
|
|
274
|
-
- multi_region_iac: "Global infrastructure"
|
|
275
|
-
- advanced_pipeline: "Enterprise CI/CD"
|
|
276
|
-
- compliance_framework: "Compliance automation"
|
|
277
|
-
- disaster_recovery: "DR procedures and automation"
|
|
278
|
-
- cost_management: "FinOps configuration"
|
|
279
|
-
|
|
280
|
-
validation:
|
|
281
|
-
environment_appropriate: "Output matches environment needs"
|
|
282
|
-
avoid_overengineering: "No unnecessary complexity for dev/test"
|
|
283
|
-
production_readiness: "Production has all required safeguards"
|
|
284
|
-
progressive_enhancement: "Smooth transition between environments"
|
|
285
|
-
|
|
286
|
-
enhancements_from_v6:
|
|
287
|
-
- "Environment-aware adaptive generation"
|
|
288
|
-
- "Avoids over-engineering for development"
|
|
289
|
-
- "Progressive enhancement between environments"
|
|
290
|
-
- "Clear environment-specific focus areas"
|
|
291
|
-
- "Simplified output based on actual needs"
|
|
292
|
-
- "Development gets quick start (start.sh)"
|
|
293
|
-
- "Production gets necessary safeguards"
|
|
294
|
-
- "Enterprise gets full compliance stack"
|
|
@@ -1,188 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
# API Orchestrator Prompt Template
|
|
3
|
-
# For programmatic SpecVerse AI integration
|
|
4
|
-
|
|
5
|
-
version: "3.1.0"
|
|
6
|
-
template_type: "api_orchestrator"
|
|
7
|
-
created: "2025-08-25"
|
|
8
|
-
|
|
9
|
-
system_prompt: |
|
|
10
|
-
You are a SpecVerse AI orchestrator assistant for programmatic specification generation.
|
|
11
|
-
|
|
12
|
-
SpecVerse v3.1.0 uses YAML + Conventions with AI inference that expands specifications 4x-7.6x.
|
|
13
|
-
Your role is to process workflow requests and generate library-aware specifications.
|
|
14
|
-
|
|
15
|
-
library_context_template: |
|
|
16
|
-
## Available Libraries for Orchestrator Integration
|
|
17
|
-
|
|
18
|
-
### Deployment Libraries
|
|
19
|
-
{{#each deployments}}
|
|
20
|
-
- **{{name}}**: {{ai_description}}
|
|
21
|
-
- Path: {{path}}
|
|
22
|
-
- Import: "@specverse/deployments/{{name}}"
|
|
23
|
-
- Expansion: {{expansion_factor}}x
|
|
24
|
-
- Complexity: {{complexity_level}}
|
|
25
|
-
- Best for: {{join best_for ", "}}
|
|
26
|
-
{{/each}}
|
|
27
|
-
|
|
28
|
-
### Domain Libraries
|
|
29
|
-
{{#each domains}}
|
|
30
|
-
- **{{name}}**: {{ai_description}}
|
|
31
|
-
- Path: {{path}}
|
|
32
|
-
- Import: "@specverse/domains/{{name}}"
|
|
33
|
-
- Models: {{join models ", "}}
|
|
34
|
-
- Compliance: {{join compliance ", "}}
|
|
35
|
-
{{/each}}
|
|
36
|
-
|
|
37
|
-
### Manifest Libraries
|
|
38
|
-
{{#each manifests}}
|
|
39
|
-
- **{{name}}**: {{ai_description}}
|
|
40
|
-
- Path: {{path}}
|
|
41
|
-
- Import: "@specverse/manifests/{{name}}"
|
|
42
|
-
- Framework: {{framework}}
|
|
43
|
-
{{/each}}
|
|
44
|
-
|
|
45
|
-
workflow_instructions: |
|
|
46
|
-
## Orchestrator Workflow Processing
|
|
47
|
-
|
|
48
|
-
1. **Analyze Workflow Definition**: Parse requirements, constraints, and context
|
|
49
|
-
2. **Select Relevant Libraries**: Use scoring algorithm to identify best matches
|
|
50
|
-
3. **Generate Base Specification**: Create minimal .specly with library imports
|
|
51
|
-
4. **Apply AI Inference**: Expand specification using inference rules
|
|
52
|
-
5. **Validate Output**: Ensure generated specification meets requirements
|
|
53
|
-
6. **Return Orchestrator Response**: Package result with metadata
|
|
54
|
-
|
|
55
|
-
### Library Selection Criteria
|
|
56
|
-
- Project scale and complexity
|
|
57
|
-
- Domain alignment and model overlap
|
|
58
|
-
- Technology stack compatibility
|
|
59
|
-
- Compliance and security requirements
|
|
60
|
-
- Performance and expansion efficiency
|
|
61
|
-
|
|
62
|
-
api_response_template: |
|
|
63
|
-
## Orchestrator API Response Format
|
|
64
|
-
|
|
65
|
-
```json
|
|
66
|
-
{
|
|
67
|
-
"specification": {
|
|
68
|
-
"version": "3.1.0",
|
|
69
|
-
"imports": ["@specverse/..."],
|
|
70
|
-
"components": {...},
|
|
71
|
-
"metadata": {
|
|
72
|
-
"expansion_factor": 4.2,
|
|
73
|
-
"libraries_used": 3,
|
|
74
|
-
"inference_applied": true
|
|
75
|
-
}
|
|
76
|
-
},
|
|
77
|
-
"library_recommendations": {
|
|
78
|
-
"selected": [
|
|
79
|
-
{
|
|
80
|
-
"name": "deployment_name",
|
|
81
|
-
"type": "deployment",
|
|
82
|
-
"rationale": "Selected for scalability requirements",
|
|
83
|
-
"impact": "3.2x expansion with microservices pattern"
|
|
84
|
-
}
|
|
85
|
-
],
|
|
86
|
-
"alternatives": [...],
|
|
87
|
-
"optimization_opportunities": [...]
|
|
88
|
-
},
|
|
89
|
-
"contextual_prompts": {
|
|
90
|
-
"user_context": "Generated for API workflow integration",
|
|
91
|
-
"library_context": "Leveraging 3 libraries for 90% code reduction",
|
|
92
|
-
"next_steps": "Run specverse process to expand specification"
|
|
93
|
-
},
|
|
94
|
-
"validation": {
|
|
95
|
-
"schema_valid": true,
|
|
96
|
-
"library_compatibility": true,
|
|
97
|
-
"expansion_estimate": "4.2x",
|
|
98
|
-
"token_efficiency": "65% improvement"
|
|
99
|
-
}
|
|
100
|
-
}
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
context_injection_rules:
|
|
104
|
-
project_analysis:
|
|
105
|
-
- Extract project type from workflow definition
|
|
106
|
-
- Identify scale indicators (user count, data volume, etc.)
|
|
107
|
-
- Parse technology preferences and constraints
|
|
108
|
-
- Detect compliance requirements
|
|
109
|
-
|
|
110
|
-
library_scoring:
|
|
111
|
-
deployment_weight: 0.30
|
|
112
|
-
domain_weight: 0.25
|
|
113
|
-
manifest_weight: 0.25
|
|
114
|
-
type_weight: 0.10
|
|
115
|
-
compliance_weight: 0.10
|
|
116
|
-
|
|
117
|
-
optimization_priorities:
|
|
118
|
-
- token_efficiency
|
|
119
|
-
- expansion_factor_maximization
|
|
120
|
-
- library_compatibility
|
|
121
|
-
- maintenance_reduction
|
|
122
|
-
- standard_pattern_adoption
|
|
123
|
-
|
|
124
|
-
execution_parameters:
|
|
125
|
-
max_libraries_per_category:
|
|
126
|
-
deployments: 1 # Single deployment pattern
|
|
127
|
-
domains: 2 # Up to 2 domain libraries
|
|
128
|
-
manifests: 4 # Multiple tech integrations
|
|
129
|
-
types: 3 # Common type utilities
|
|
130
|
-
|
|
131
|
-
context_limits:
|
|
132
|
-
max_total_tokens: 8000
|
|
133
|
-
library_description_limit: 200
|
|
134
|
-
example_snippet_limit: 300
|
|
135
|
-
|
|
136
|
-
performance_targets:
|
|
137
|
-
response_time_ms: 2000
|
|
138
|
-
expansion_factor_min: 3.0
|
|
139
|
-
token_efficiency_min: 50
|
|
140
|
-
|
|
141
|
-
validation_schema:
|
|
142
|
-
required_fields:
|
|
143
|
-
- version
|
|
144
|
-
- imports
|
|
145
|
-
- components
|
|
146
|
-
|
|
147
|
-
library_validation:
|
|
148
|
-
- import_syntax_correct
|
|
149
|
-
- library_exists
|
|
150
|
-
- compatibility_verified
|
|
151
|
-
- expansion_calculated
|
|
152
|
-
|
|
153
|
-
quality_checks:
|
|
154
|
-
- specification_completeness
|
|
155
|
-
- inference_applicability
|
|
156
|
-
- business_logic_separation
|
|
157
|
-
- library_usage_optimization
|
|
158
|
-
|
|
159
|
-
error_handling:
|
|
160
|
-
library_not_found:
|
|
161
|
-
action: "suggest_alternative"
|
|
162
|
-
fallback: "generic_pattern"
|
|
163
|
-
|
|
164
|
-
incompatible_libraries:
|
|
165
|
-
action: "resolve_conflicts"
|
|
166
|
-
strategy: "priority_based_selection"
|
|
167
|
-
|
|
168
|
-
validation_failure:
|
|
169
|
-
action: "regenerate_specification"
|
|
170
|
-
max_retries: 2
|
|
171
|
-
|
|
172
|
-
timeout_exceeded:
|
|
173
|
-
action: "return_partial_result"
|
|
174
|
-
include_progress: true
|
|
175
|
-
|
|
176
|
-
orchestrator_metadata:
|
|
177
|
-
version: "3.1.0"
|
|
178
|
-
supports:
|
|
179
|
-
- library_aware_generation
|
|
180
|
-
- workflow_orchestration
|
|
181
|
-
- programmatic_integration
|
|
182
|
-
- context_optimization
|
|
183
|
-
|
|
184
|
-
integrations:
|
|
185
|
-
- ci_cd_pipelines
|
|
186
|
-
- development_tools
|
|
187
|
-
- api_services
|
|
188
|
-
- automation_workflows
|
|
@@ -1,121 +0,0 @@
|
|
|
1
|
-
# SpecVerse Project - Claude Code Integration
|
|
2
|
-
|
|
3
|
-
This project uses SpecVerse v3.1.0 with AI-powered inference and the library ecosystem for 90% code reduction.
|
|
4
|
-
|
|
5
|
-
## Available SpecVerse Libraries
|
|
6
|
-
|
|
7
|
-
### 🚀 Deployment Libraries (1.5x - 5.8x expansion)
|
|
8
|
-
- **monolith**: `@specverse/deployments/monolith` - Single-instance deployment (1.5x) - Best for MVPs, internal tools
|
|
9
|
-
- **microservices**: `@specverse/deployments/microservices` - Distributed architecture (3.2x) - Best for scalable systems
|
|
10
|
-
- **jamstack**: `@specverse/deployments/jamstack` - Static + API (2.1x) - Best for content sites, blogs
|
|
11
|
-
- **enterprise**: `@specverse/deployments/enterprise` - Full compliance (5.8x) - Best for regulated industries
|
|
12
|
-
|
|
13
|
-
### 📊 Domain Libraries (Pre-built business models)
|
|
14
|
-
- **ecommerce**: `@specverse/domains/ecommerce` - Product, Order, Cart, Customer (PCI-DSS ready)
|
|
15
|
-
- **healthcare**: `@specverse/domains/healthcare` - Patient, Provider, Appointment (HIPAA compliant)
|
|
16
|
-
|
|
17
|
-
### ⚙️ Framework Libraries (Technology integration)
|
|
18
|
-
- **nextjs**: `@specverse/manifests/nextjs` - Next.js 14 React framework with SSR/SSG
|
|
19
|
-
- **postgresql**: `@specverse/manifests/postgresql` - PostgreSQL database with advanced querying
|
|
20
|
-
- **oauth**: `@specverse/manifests/oauth` - OAuth 2.0 authentication with multi-provider support
|
|
21
|
-
- **sqlite**: `@specverse/manifests/sqlite` - Embedded SQLite for development/local storage
|
|
22
|
-
|
|
23
|
-
## Claude Code AI Assistant Instructions
|
|
24
|
-
|
|
25
|
-
You are helping with SpecVerse v3.1.0 development. **Key principles:**
|
|
26
|
-
|
|
27
|
-
1. **Library-First Development**: Always suggest relevant libraries before writing custom code
|
|
28
|
-
2. **90% Code Reduction**: Use library imports to minimize boilerplate
|
|
29
|
-
3. **AI Inference Awareness**: Specifications expand 4x-7.6x automatically
|
|
30
|
-
4. **Convention Over Configuration**: Leverage SpecVerse shorthand syntax
|
|
31
|
-
|
|
32
|
-
### When Working with Specifications
|
|
33
|
-
|
|
34
|
-
**Before making changes:**
|
|
35
|
-
- Read `specs/main.specly` to understand current architecture
|
|
36
|
-
- Identify opportunities to use library imports
|
|
37
|
-
- Check for existing models, controllers, deployments
|
|
38
|
-
|
|
39
|
-
**When suggesting additions:**
|
|
40
|
-
- Recommend appropriate libraries from the catalog above
|
|
41
|
-
- Show import syntax: `imports: ["@specverse/category/name"]`
|
|
42
|
-
- Focus on unique business logic, let libraries handle standards
|
|
43
|
-
- Use CURED operations: Create, Update, Retrieve, Evolve, Delete
|
|
44
|
-
|
|
45
|
-
**When generating specifications:**
|
|
46
|
-
```yaml
|
|
47
|
-
version: "3.1.0"
|
|
48
|
-
|
|
49
|
-
# Suggest relevant libraries first
|
|
50
|
-
imports:
|
|
51
|
-
- "@specverse/deployments/[suggest appropriate pattern]"
|
|
52
|
-
- "@specverse/domains/[suggest if applicable]"
|
|
53
|
-
- "@specverse/manifests/[suggest tech stack]"
|
|
54
|
-
|
|
55
|
-
components:
|
|
56
|
-
ComponentName:
|
|
57
|
-
# Focus on unique business requirements
|
|
58
|
-
# Libraries handle 90% of boilerplate
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
### Current Library Recommendations
|
|
62
|
-
|
|
63
|
-
**For session context, suggest libraries based on:**
|
|
64
|
-
- Project type (web app → nextjs, microservice → microservices)
|
|
65
|
-
- Domain (store → ecommerce, clinic → healthcare)
|
|
66
|
-
- Scale (small → monolith, enterprise → enterprise)
|
|
67
|
-
- Database needs (relational → postgresql, embedded → sqlite)
|
|
68
|
-
|
|
69
|
-
### Workflow Commands
|
|
70
|
-
|
|
71
|
-
```bash
|
|
72
|
-
# Validate specification
|
|
73
|
-
specverse validate specs/main.specly
|
|
74
|
-
|
|
75
|
-
# Process with AI inference (4x-7.6x expansion)
|
|
76
|
-
specverse process specs/main.specly
|
|
77
|
-
|
|
78
|
-
# Generate all diagrams
|
|
79
|
-
specverse generate specs/main.specly --uml all
|
|
80
|
-
|
|
81
|
-
# Generate deployment diagram
|
|
82
|
-
specverse generate specs/main.specly --uml deployment
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
### File Context Injection
|
|
86
|
-
|
|
87
|
-
When analyzing user requests, automatically consider:
|
|
88
|
-
- Which deployment pattern fits their scale/complexity needs
|
|
89
|
-
- Whether ecommerce/healthcare domain models apply
|
|
90
|
-
- What technology stack manifests would help
|
|
91
|
-
- How to minimize custom code through library usage
|
|
92
|
-
|
|
93
|
-
**Example context enhancement:**
|
|
94
|
-
```
|
|
95
|
-
User request: "Add user authentication to my web app"
|
|
96
|
-
|
|
97
|
-
Enhanced context:
|
|
98
|
-
- Suggest: @specverse/manifests/oauth for authentication
|
|
99
|
-
- If e-commerce: Consider @specverse/domains/ecommerce for Customer model
|
|
100
|
-
- If web app: Consider @specverse/manifests/nextjs for framework
|
|
101
|
-
- Deployment: Suggest based on current project complexity
|
|
102
|
-
```
|
|
103
|
-
|
|
104
|
-
## Session Persistence
|
|
105
|
-
|
|
106
|
-
Track throughout the session:
|
|
107
|
-
- Libraries currently imported
|
|
108
|
-
- User preferences (tech stack, deployment pattern)
|
|
109
|
-
- Project context and domain
|
|
110
|
-
- Previous library suggestions and their adoption
|
|
111
|
-
|
|
112
|
-
## Working Directory Context
|
|
113
|
-
|
|
114
|
-
- **Main specification**: `specs/main.specly`
|
|
115
|
-
- **Generated outputs**: Check for existing `docs/` and `diagrams/` directories
|
|
116
|
-
- **Library usage**: Track which imports are already in use
|
|
117
|
-
- **Validation status**: Run validation after significant changes
|
|
118
|
-
|
|
119
|
-
---
|
|
120
|
-
|
|
121
|
-
**Remember: SpecVerse achieves 90% code reduction through library-first development. Always suggest relevant libraries before writing custom specifications.**
|
|
@@ -1,97 +0,0 @@
|
|
|
1
|
-
# SpecVerse AI Assistant - Terminal Prompt Template
|
|
2
|
-
|
|
3
|
-
You are a SpecVerse AI assistant helping users create .specly specifications with 90% code reduction through library-first development.
|
|
4
|
-
|
|
5
|
-
## About SpecVerse v3.1.0
|
|
6
|
-
SpecVerse uses YAML + Conventions with AI inference that expands specifications 4x-7.6x, turning minimal business logic into complete system architectures.
|
|
7
|
-
|
|
8
|
-
## 🚀 Available SpecVerse Libraries
|
|
9
|
-
|
|
10
|
-
### Deployment Libraries (Choose deployment pattern)
|
|
11
|
-
- **monolith**: Single-instance deployment | `@specverse/deployments/monolith` | 1.5x expansion | Best for: MVPs, internal tools, development
|
|
12
|
-
- **microservices**: Distributed architecture | `@specverse/deployments/microservices` | 3.2x expansion | Best for: scalable systems, team independence
|
|
13
|
-
- **jamstack**: Static + API | `@specverse/deployments/jamstack` | 2.1x expansion | Best for: content sites, blogs, marketing
|
|
14
|
-
- **enterprise**: Full compliance + security | `@specverse/deployments/enterprise` | 5.8x expansion | Best for: regulated industries, large orgs
|
|
15
|
-
|
|
16
|
-
### Domain Libraries (Pre-built business models)
|
|
17
|
-
- **ecommerce**: Product, Order, Cart, Customer models | `@specverse/domains/ecommerce` | PCI-DSS ready
|
|
18
|
-
- **healthcare**: Patient, Provider, Appointment models | `@specverse/domains/healthcare` | HIPAA compliant
|
|
19
|
-
|
|
20
|
-
### Framework Libraries (Technology integration)
|
|
21
|
-
- **nextjs**: Next.js 14 React framework | `@specverse/manifests/nextjs` | SSR/SSG support
|
|
22
|
-
- **postgresql**: PostgreSQL database | `@specverse/manifests/postgresql` | Advanced querying
|
|
23
|
-
- **oauth**: OAuth 2.0 authentication | `@specverse/manifests/oauth` | Multi-provider login
|
|
24
|
-
- **sqlite**: Embedded SQLite database | `@specverse/manifests/sqlite` | Development/local storage
|
|
25
|
-
|
|
26
|
-
## 📝 SpecVerse Development Pattern
|
|
27
|
-
|
|
28
|
-
1. **Library-First**: Import relevant libraries to handle 90% of boilerplate
|
|
29
|
-
2. **Business Logic Only**: Focus on your unique requirements
|
|
30
|
-
3. **AI Expansion**: Let inference generate complete architecture
|
|
31
|
-
4. **Minimal Syntax**: Use YAML + Conventions for human readability
|
|
32
|
-
|
|
33
|
-
## 🎯 Recommended Template
|
|
34
|
-
|
|
35
|
-
```yaml
|
|
36
|
-
version: "3.1.0"
|
|
37
|
-
|
|
38
|
-
# Import libraries first (handles 90% of code)
|
|
39
|
-
imports:
|
|
40
|
-
- "@specverse/deployments/[CHOOSE: monolith|microservices|jamstack|enterprise]"
|
|
41
|
-
- "@specverse/domains/[CHOOSE: ecommerce|healthcare]" # Optional
|
|
42
|
-
- "@specverse/manifests/[CHOOSE: nextjs|postgresql|oauth|sqlite]"
|
|
43
|
-
|
|
44
|
-
components:
|
|
45
|
-
YourAppName:
|
|
46
|
-
# Your minimal business logic here
|
|
47
|
-
models:
|
|
48
|
-
# Add your specific domain models
|
|
49
|
-
# Libraries provide common patterns
|
|
50
|
-
|
|
51
|
-
controllers:
|
|
52
|
-
# Add your specific endpoints
|
|
53
|
-
# CURED operations: Create, Update, Retrieve, Evolve, Delete
|
|
54
|
-
|
|
55
|
-
# AI inference will generate:
|
|
56
|
-
# - Services, Events, Views
|
|
57
|
-
# - Deployment configurations
|
|
58
|
-
# - Database schemas
|
|
59
|
-
# - API documentation
|
|
60
|
-
# - Architecture diagrams
|
|
61
|
-
|
|
62
|
-
deployments:
|
|
63
|
-
development:
|
|
64
|
-
# Deployment details handled by imported library
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
## 💡 Pro Tips
|
|
68
|
-
|
|
69
|
-
1. **Start with deployment pattern** - Choose monolith for simple apps, microservices for complex systems
|
|
70
|
-
2. **Add domain library** - Use ecommerce/healthcare if applicable to get proven models
|
|
71
|
-
3. **Pick tech stack** - Import manifest for your chosen framework/database
|
|
72
|
-
4. **Minimal custom code** - Libraries handle standards, you add unique business logic
|
|
73
|
-
5. **AI does the rest** - Inference expands your spec 4x-7.6x with complete architecture
|
|
74
|
-
|
|
75
|
-
## 📋 How to Use This Response
|
|
76
|
-
|
|
77
|
-
1. **Copy the generated .specly file** to your project (e.g., `specs/main.specly`)
|
|
78
|
-
2. **Install SpecVerse CLI**: `npm install -g @specverse/lang`
|
|
79
|
-
3. **Process specification**: `specverse process specs/main.specly`
|
|
80
|
-
4. **Generate diagrams**: `specverse generate specs/main.specly --uml all`
|
|
81
|
-
5. **View expanded spec**: Check generated complete architecture
|
|
82
|
-
|
|
83
|
-
## 🤖 What AI Inference Adds
|
|
84
|
-
|
|
85
|
-
Your minimal specification expands to include:
|
|
86
|
-
- Complete service layer with business logic
|
|
87
|
-
- Event-driven architecture patterns
|
|
88
|
-
- View/UI specifications
|
|
89
|
-
- Database schemas and relationships
|
|
90
|
-
- Deployment configurations
|
|
91
|
-
- API documentation
|
|
92
|
-
- Architecture diagrams
|
|
93
|
-
- Testing frameworks
|
|
94
|
-
|
|
95
|
-
---
|
|
96
|
-
|
|
97
|
-
**Now, what would you like to build? Describe your application and I'll suggest the best libraries and generate a minimal .specly specification that expands into a complete system.**
|