@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.
Files changed (64) hide show
  1. package/assets/prompts/core/standard/default/analyse.prompt.yaml +5 -5
  2. package/assets/prompts/core/standard/default/app-demo.prompt.yaml +21 -1
  3. package/assets/prompts/core/standard/default/behavior.prompt.yaml +150 -0
  4. package/assets/prompts/core/standard/default/create.prompt.yaml +3 -3
  5. package/assets/prompts/core/standard/default/materialise.prompt.yaml +804 -774
  6. package/assets/prompts/core/standard/default/realize.prompt.yaml +581 -544
  7. package/assets/prompts/core/standard/v9/analyse.prompt.yaml +5 -5
  8. package/assets/prompts/core/standard/v9/app-demo.prompt.yaml +233 -0
  9. package/assets/prompts/core/standard/v9/behavior.prompt.yaml +33 -9
  10. package/assets/prompts/core/standard/v9/create.prompt.yaml +3 -3
  11. package/assets/prompts/core/standard/v9/materialise.prompt.yaml +804 -774
  12. package/assets/prompts/core/standard/v9/realize.prompt.yaml +581 -544
  13. package/dist/libs/instance-factories/cli/templates/commander/command-generator.js +184 -0
  14. package/dist/libs/instance-factories/tools/templates/mcp/mcp-server-generator.js +289 -15
  15. package/libs/instance-factories/cli/templates/commander/command-generator.ts +184 -0
  16. package/libs/instance-factories/tools/templates/mcp/mcp-server-generator.ts +322 -16
  17. package/package.json +1 -1
  18. package/assets/prompts/core/CHANGELOG.md +0 -158
  19. package/assets/prompts/core/MIGRATION-v6-to-v7.md +0 -379
  20. package/assets/prompts/core/base-terminal-prompt.md +0 -201
  21. package/assets/prompts/core/examples/example-usage.ts +0 -140
  22. package/assets/prompts/core/schemas/prompt.schema.json +0 -309
  23. package/assets/prompts/core/schemas/prompt.schema.yaml +0 -229
  24. package/assets/prompts/core/standard/archive/v1/analyse.prompt.yaml +0 -259
  25. package/assets/prompts/core/standard/archive/v1/create.prompt.yaml +0 -302
  26. package/assets/prompts/core/standard/archive/v1/materialise.prompt.yaml +0 -328
  27. package/assets/prompts/core/standard/archive/v1/realize.prompt.yaml +0 -606
  28. package/assets/prompts/core/standard/archive/v2/README.md +0 -110
  29. package/assets/prompts/core/standard/archive/v2/analyse.prompt.yaml +0 -151
  30. package/assets/prompts/core/standard/archive/v2/create.prompt.yaml +0 -151
  31. package/assets/prompts/core/standard/archive/v2/materialise.prompt.yaml +0 -132
  32. package/assets/prompts/core/standard/archive/v2/realize.prompt.yaml +0 -147
  33. package/assets/prompts/core/standard/archive/v3/README.md +0 -279
  34. package/assets/prompts/core/standard/archive/v3/analyse.prompt.yaml +0 -309
  35. package/assets/prompts/core/standard/archive/v3/create.prompt.yaml +0 -351
  36. package/assets/prompts/core/standard/archive/v3/materialise.prompt.yaml +0 -247
  37. package/assets/prompts/core/standard/archive/v3/realize.prompt.yaml +0 -344
  38. package/assets/prompts/core/standard/archive/v4/README.md +0 -79
  39. package/assets/prompts/core/standard/archive/v4/analyse.prompt.yaml +0 -204
  40. package/assets/prompts/core/standard/archive/v4/create.prompt.yaml +0 -185
  41. package/assets/prompts/core/standard/archive/v5/README.md +0 -224
  42. package/assets/prompts/core/standard/archive/v5/analyse.prompt.yaml +0 -209
  43. package/assets/prompts/core/standard/archive/v5/create.prompt.yaml +0 -225
  44. package/assets/prompts/core/standard/archive/v5/materialise.prompt.yaml +0 -242
  45. package/assets/prompts/core/standard/archive/v5/realize.prompt.yaml +0 -336
  46. package/assets/prompts/core/standard/archive/v6/README.md +0 -187
  47. package/assets/prompts/core/standard/archive/v6/analyse.prompt.yaml +0 -219
  48. package/assets/prompts/core/standard/archive/v6/create.prompt.yaml +0 -180
  49. package/assets/prompts/core/standard/archive/v6/materialise.prompt.yaml +0 -203
  50. package/assets/prompts/core/standard/archive/v6/realize.prompt.yaml +0 -215
  51. package/assets/prompts/core/standard/archive/v7/analyse.prompt.nick.yaml +0 -144
  52. package/assets/prompts/core/standard/archive/v7/analyse.prompt.old.yaml +0 -146
  53. package/assets/prompts/core/standard/archive/v7/analyse.prompt.yaml +0 -129
  54. package/assets/prompts/core/standard/archive/v7/create.prompt.yaml +0 -146
  55. package/assets/prompts/core/standard/archive/v7/materialise.prompt.yaml +0 -297
  56. package/assets/prompts/core/standard/archive/v7/realize.prompt.yaml +0 -294
  57. package/assets/prompts/core/standard/archive/v8/README.md +0 -400
  58. package/assets/prompts/core/standard/archive/v8/analyse.prompt.yaml +0 -185
  59. package/assets/prompts/core/standard/archive/v8/create.prompt.yaml +0 -203
  60. package/assets/prompts/core/standard/archive/v8/materialise.prompt.yaml +0 -297
  61. package/assets/prompts/core/standard/archive/v8/realize.prompt.yaml +0 -294
  62. package/assets/prompts/templates/api-orchestrator-template.yaml +0 -188
  63. package/assets/prompts/templates/claude-integration-template.md +0 -121
  64. 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.**