@specverse/engine-realize 3.5.3

package/assets/templates/frontend-only/manifests/kubernetes.specly

@@ -0,0 +1,140 @@
+# Kubernetes Implementation Manifest
+# SpecVerse v3.3 manifest specification for Kubernetes deployment
+
+manifests:
+  KubernetesManifest:
+    specVersion: "3.3.0"
+    name: "{{componentName}}KubernetesManifest"
+    version: "1.0.0"
+    description: "Kubernetes implementation manifest for {{projectName}}"
+
+    # v3.3: Deployment reference (REQUIRED)
+    deployment:
+      deploymentSource: "./specs/main.specly"
+      deploymentName: "production"
+
+    # v3.3: Default technology mappings
+    defaultMappings:
+      storage: "PostgreSQL15"
+      controller: "KubernetesApp"
+
+    # v3.3: Capability to implementation factory mappings
+    capabilityMappings:
+      - capability: "api.*"
+        instanceFactory: "KubernetesController"
+
+      - capability: "database.*"
+        instanceFactory: "KubernetesDatabase"
+
+      - capability: "networking.*"
+        instanceFactory: "KubernetesService"
+
+    # v3.3: Instance-specific mappings (optional - for fine-grained control)
+    instanceMappings:
+      - instanceName: "webApp"
+        instanceFactory: "KubernetesController"
+
+      - instanceName: "appDatabase"
+        instanceFactory: "KubernetesDatabase"
+
+      - instanceName: "webService"
+        instanceFactory: "KubernetesService"
+
+    # v3.3: Platform-specific configuration
+    configuration:
+      # Kubernetes specific settings
+      clusterVersion: "v1.28"
+
+      # Implementation factory definitions
+      implementationFactories:
+        KubernetesController:
+          type: "controller"
+          technology: "kubernetes"
+          framework: "deployment"
+          config:
+            apiVersion: "apps/v1"
+            kind: "Deployment"
+            replicas: 3
+            image: "{{projectNameKebab}}:latest"
+            containerPort: 3000
+            resources:
+              requests:
+                memory: "128Mi"
+                cpu: "100m"
+              limits:
+                memory: "256Mi"
+                cpu: "200m"
+
+        KubernetesDatabase:
+          type: "database"
+          technology: "postgresql"
+          framework: "kubernetes-operator"
+          config:
+            apiVersion: "postgresql.cnpg.io/v1"
+            kind: "Cluster"
+            instances: 3
+            postgresql:
+              parameters:
+                max_connections: "100"
+                shared_buffers: "128MB"
+            storage:
+              size: "10Gi"
+              storageClass: "fast-ssd"
+
+        KubernetesService:
+          type: "service"
+          technology: "kubernetes"
+          framework: "service"
+          config:
+            apiVersion: "v1"
+            kind: "Service"
+            serviceType: "ClusterIP"
+            ports:
+              - port: 80
+                targetPort: 3000
+                protocol: "TCP"
+
+      # Horizontal Pod Autoscaling
+      scaling:
+        horizontal:
+          enabled: true
+          minReplicas: 3
+          maxReplicas: 10
+          targetCPUUtilization: 70
+
+      # Monitoring configuration
+      monitoring:
+        prometheus: true
+        grafana: true
+        alerts:
+          - name: "high-cpu"
+            threshold: "80%"
+          - name: "high-memory"
+            threshold: "85%"
+
+      # Namespace configuration
+      namespace:
+        strategy: "environment-based"
+        name: "{{projectNameKebab}}"
+        description: "Production application namespace"
+        isolation: "strict"
+        resourceLimits:
+          cpu: "2"
+          memory: "4Gi"
+          storage: "50Gi"
+        securityPolicy: "restricted"
+
+      # AI implementation instructions
+      aiInstructions: |
+        When implementing this Kubernetes deployment:
+
+        1. **Production Ready**: Configured for production with multiple replicas
+        2. **Resource Management**: CPU and memory limits defined
+        3. **Horizontal Scaling**: HPA configured for automatic scaling
+        4. **Database**: PostgreSQL with operator for high availability
+        5. **Networking**: ClusterIP service for internal communication
+        6. **Security**: Restricted security policy and namespace isolation
+        7. **Monitoring**: Prometheus and Grafana integration
+        8. **Storage**: Persistent volumes for database data
+        9. **Health Checks**: Configure readiness and liveness probes
+        10. **Secrets**: Use Kubernetes secrets for sensitive data

package/assets/templates/frontend-only/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "{{projectNameKebab}}",
+  "version": "0.1.0",
+  "description": "{{projectName}} - SpecVerse Project",
+  "scripts": {
+    "_comment_workflow": "=== Main Workflow ===",
+    "genAll": "npm run realize:all && echo '\n✅ Code generation complete!\n' && echo '📦 Installing dependencies...\n' && cd generated/code && npm install && echo '\n🗄️  Setting up database...\n' && npm run db:setup && echo '\n✅ Setup complete! Next steps:\n' && echo '   npm run app:build  # Build the project' && echo '   npm run app:test   # Run tests' && echo '   npm run app:start  # Start production server' && echo '   npm run app:dev    # Start development server\n'",
+    "app:build": "if [ -d generated/code ]; then cd generated/code && npm run build; else echo '❌ No generated code found. Run: npm run genAll'; exit 1; fi",
+    "app:test": "if [ -d generated/code ]; then cd generated/code && npm test; else echo '❌ No generated code found. Run: npm run genAll'; exit 1; fi",
+    "app:start": "if [ -d generated/code ]; then cd generated/code && npm start; else echo '❌ No generated code found. Run: npm run genAll'; exit 1; fi",
+    "app:dev": "if [ -d generated/code ]; then cd generated/code && npm run dev; else echo '❌ No generated code found. Run: npm run genAll'; exit 1; fi",
+
+    "_comment_validation": "=== Validation ===",
+    "validate": "specverse validate specs/main.specly",
+    "validate:all": "npm run validate && npm run validate:manifests",
+    "validate:manifests": "specverse validate manifests/docker-compose.specly && specverse validate manifests/kubernetes.specly",
+
+    "_comment_inference": "=== AI Inference ===",
+    "infer": "specverse infer specs/main.specly -o generated/{{projectNameKebab}}-complete.specly",
+    "infer:deployment": "specverse infer specs/main.specly --deployment --environment development -o generated/{{projectNameKebab}}-deployed.specly",
+    "infer:deployment:prod": "specverse infer specs/main.specly --deployment --environment production -o generated/{{projectNameKebab}}-deployed-prod.specly",
+
+    "_comment_generation": "=== Generation ===",
+    "generate:docs": "specverse gen docs specs/main.specly --output docs/main-docs.md",
+    "generate:diagrams": "specverse gen diagram specs/main.specly --output docs/diagrams",
+    "generate:diagram:er": "specverse gen diagram specs/main.specly -t er-diagram -o docs/diagrams/er-diagram.mmd",
+    "generate:diagram:event-flow": "specverse gen diagram specs/main.specly -t event-flow-layered -o docs/diagrams/event-flow-layered.mmd",
+    "generate:diagram:lifecycle": "specverse gen diagram specs/main.specly -t lifecycle -o docs/diagrams/lifecycle.mmd",
+    "generate:diagram:deployment": "specverse gen diagram specs/main.specly -t deployment-topology -o docs/diagrams/deployment.mmd",
+    "generate:diagram:architecture": "specverse gen diagram specs/main.specly -t model-architecture -o docs/diagrams/architecture.mmd",
+    "generate:complete": "npm run infer && npm run infer:docs",
+
+    "_comment_inference_docs": "=== Inference Documentation ===",
+    "infer:docs": "specverse gen docs generated/{{projectNameKebab}}-complete.specly --output generated/docs/complete-docs.md && specverse gen diagram generated/{{projectNameKebab}}-complete.specly --output generated/docs/complete-diagrams",
+    "infer:deployment:docs": "specverse gen docs generated/{{projectNameKebab}}-deployed.specly --output generated/docs/deployed-docs.md && specverse gen diagram generated/{{projectNameKebab}}-deployed.specly --output generated/docs/deployed-diagrams",
+    "infer:deployment:prod:docs": "specverse gen docs generated/{{projectNameKebab}}-deployed-prod.specly --output generated/docs/deployed-prod-docs.md && specverse gen diagram generated/{{projectNameKebab}}-deployed-prod.specly --output generated/docs/deployed-prod-diagrams",
+
+    "_comment_realization": "=== Code Realization (v3.3) ===",
+    "realize:orm": "specverse realize orm specs/main.specly -m manifests/implementation.yaml",
+    "realize:services": "specverse realize services specs/main.specly -m manifests/implementation.yaml",
+    "realize:routes": "specverse realize routes specs/main.specly -m manifests/implementation.yaml",
+    "realize:all": "specverse realize all specs/main.specly -m manifests/implementation.yaml -o generated/code",
+
+    "_comment_utilities": "=== Utilities ===",
+    "process": "specverse gen yaml specs/main.specly -o generated/{{projectNameKebab}}-processed.yaml",
+    "format": "specverse dev format specs/main.specly --write",
+
+    "_comment_testing": "=== Testing ===",
+    "test:all": "./scripts/test-all.sh",
+    "test:generated:compile": "cd generated/code && npx tsc --noEmit --skipLibCheck 2>&1 || echo 'TypeScript compilation check (some errors expected without npm install)'",
+    "test:generated:run": "cd generated/code && npm install && npm run db:generate && echo 'Generated code is ready to run with: npm run dev'"
+  },
+  "keywords": ["specverse", "specification", "ai", "inference"],
+  "devDependencies": {
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/assets/templates/frontend-only/scripts/test-all.sh

@@ -0,0 +1,160 @@
+#!/bin/bash
+
+# SpecVerse Comprehensive Test Script
+# Tests all commands and validates generated specifications
+
+set -e  # Exit on any error
+
+echo "🚀 Starting comprehensive SpecVerse test..."
+
+# Create necessary directories
+mkdir -p generated docs/diagrams generated/docs generated/code
+
+# Step 1: Validate original specification
+echo "📋 Step 1: Validating original specification..."
+npm run validate
+
+# Step 2: Generate complete specification and validate it
+echo "🧠 Step 2: Generating and validating complete specification..."
+npm run infer
+specverse validate generated/{{projectNameKebab}}-complete.specly
+
+# Step 3: Generate development deployment and validate it
+echo "🏗️ Step 3: Generating and validating development deployment..."
+npm run infer:deployment
+specverse validate generated/{{projectNameKebab}}-deployed.specly
+
+# Step 4: Generate production deployment and validate it
+echo "🏭 Step 4: Generating and validating production deployment..."
+npm run infer:deployment:prod
+specverse validate generated/{{projectNameKebab}}-deployed-prod.specly
+
+# Step 5: Generate documentation and diagrams for original spec
+echo "📚 Step 5: Generating docs and diagrams for original specification..."
+npm run generate:docs
+npm run generate:diagrams
+
+# Step 6: Generate documentation for all inferred specifications
+echo "📖 Step 6: Generating docs for all inferred specifications..."
+npm run infer:docs
+npm run infer:deployment:docs
+npm run infer:deployment:prod:docs
+
+# Step 7: Test YAML processing
+echo "⚙️ Step 7: Testing YAML processing..."
+npm run process
+
+# Step 8: Test v3.3 Code Realization (NEW)
+echo "🔧 Step 8: Testing v3.3 code realization..."
+echo "   → Generating complete runnable project..."
+npm run realize:all
+
+# Verify generated project structure
+echo "   → Verifying generated project..."
+if [ -f "generated/code/package.json" ]; then
+  echo "   ✅ package.json generated"
+fi
+
+if [ -f "generated/code/tsconfig.json" ]; then
+  echo "   ✅ tsconfig.json generated"
+fi
+
+if [ -f "generated/code/.env.example" ]; then
+  echo "   ✅ .env.example generated"
+fi
+
+if [ -f "generated/code/README.md" ]; then
+  echo "   ✅ README.md generated"
+fi
+
+# Check for backend structure
+if [ -d "generated/code/backend" ]; then
+  echo "   ✅ Backend directory generated"
+
+  if [ -f "generated/code/backend/src/main.ts" ]; then
+    echo "   ✅ Backend entry point (backend/src/main.ts) generated"
+  fi
+
+  # Check for ORM schema (Prisma for default template)
+  if [ -f "generated/code/backend/prisma/schema.prisma" ]; then
+    echo "   ✅ Prisma ORM schema generated"
+  elif [ -d "generated/code/backend/src/entities" ] || [ -d "generated/code/backend/src/models" ]; then
+    echo "   ✅ ORM schema generated"
+  fi
+
+  if [ -d "generated/code/backend/src/controllers" ]; then
+    echo "   ✅ Controllers generated"
+  fi
+
+  if [ -d "generated/code/backend/src/routes" ]; then
+    echo "   ✅ Route handlers generated"
+  fi
+fi
+
+# Check for frontend structure
+if [ -d "generated/code/frontend" ]; then
+  echo "   ✅ Frontend directory generated"
+
+  if [ -f "generated/code/frontend/src/main.tsx" ]; then
+    echo "   ✅ Frontend entry point (frontend/src/main.tsx) generated"
+  fi
+
+  if [ -d "generated/code/frontend/src/components" ]; then
+    echo "   ✅ React components generated"
+  fi
+fi
+
+# Check for v3.3 CURVED features in generated code
+if [ -d "generated/code/backend/src/controllers" ]; then
+  # Check for unified validation method (v3.3)
+  if grep -q "validate(.*context.*operation" generated/code/backend/src/controllers/*.ts 2>/dev/null; then
+    echo "   ✅ v3.3 unified validation method present"
+  fi
+
+  # Check for delete operation (not destroy)
+  if grep -q "async delete(id:" generated/code/backend/src/controllers/*.ts 2>/dev/null; then
+    echo "   ✅ v3.3 delete operation present (CURVED)"
+  fi
+
+  # Check for retrieveAll method (list operation)
+  if grep -q "async retrieveAll" generated/code/backend/src/controllers/*.ts 2>/dev/null; then
+    echo "   ✅ v3.3 retrieveAll method present (CURVED)"
+  fi
+fi
+
+# Check for validate endpoint in routes
+if [ -d "generated/code/backend/src/routes" ]; then
+  if grep -q "'/validate'" generated/code/backend/src/routes/*.ts 2>/dev/null; then
+    echo "   ✅ v3.3 validate endpoint present (CURVED)"
+  fi
+fi
+
+echo ""
+echo "✅ All SpecVerse commands tested successfully!"
+echo "✅ All generated specifications are valid and documented."
+echo ""
+echo "📊 Test Summary:"
+echo "   - Original specification: validated"
+echo "   - Complete specification: generated and validated"
+echo "   - Development deployment: generated and validated"
+echo "   - Production deployment: generated and validated"
+echo "   - Documentation: generated for all specifications"
+echo "   - Diagrams: generated for all specifications"
+echo "   - YAML processing: tested"
+echo "   - v3.3 Code realization: tested"
+echo "   - Complete runnable project: generated"
+echo ""
+echo "🎉 SpecVerse workflow is fully functional!"
+echo ""
+echo "💡 Next steps:"
+echo "   To run the generated full-stack application:"
+echo "   1. cd /path/to/project (if not already there)"
+echo "   2. npm run genAll (if not already run - installs deps and sets up DB)"
+echo "   3. npm run app:build (build TypeScript)"
+echo "   4. npm run app:dev:backend (Terminal 1 - starts backend on :3000)"
+echo "   5. npm run app:dev:frontend (Terminal 2 - starts frontend on :5173)"
+echo ""
+echo "   Or run 'npm run app:dev' to see detailed instructions"
+echo ""
+echo "   Backend API: http://localhost:3000/api/{{componentNameKebab}}s"
+echo "   Frontend UI: http://localhost:5173"

package/assets/templates/frontend-only/scripts/test-generated-code.sh

@@ -0,0 +1,165 @@
+#!/bin/bash
+
+# Test Generated Code Runtime Execution
+# Tests that generated code actually compiles and runs
+
+set -e  # Exit on any error
+
+echo "🧪 Testing Generated Code Execution..."
+echo ""
+
+# Check if code has been generated
+if [ ! -d "generated/code/services" ]; then
+  echo "⚠️  No generated code found. Running generators first..."
+  npm run generate:code
+fi
+
+echo "📦 Step 1: Setting up runtime environment..."
+
+# Create runtime package.json if it doesn't exist
+if [ ! -f "generated/code/package.json" ]; then
+  echo "   → Creating package.json for generated code..."
+  cat > generated/code/package.json << 'EOF'
+{
+  "name": "generated-code-runtime",
+  "version": "0.1.0",
+  "type": "module",
+  "dependencies": {
+    "@prisma/client": "^5.0.0",
+    "typeorm": "^0.3.17",
+    "reflect-metadata": "^0.1.13",
+    "better-sqlite3": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.2.0",
+    "tsx": "^3.12.0"
+  }
+}
+EOF
+fi
+
+# Create tsconfig.json if it doesn't exist
+if [ ! -f "generated/code/tsconfig.json" ]; then
+  echo "   → Creating tsconfig.json for generated code..."
+  cat > generated/code/tsconfig.json << 'EOF'
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "lib": ["ES2022"],
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": ".",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  },
+  "include": ["**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}
+EOF
+fi
+
+echo "   ✅ Runtime environment configured"
+echo ""
+
+echo "🔧 Step 2: Checking TypeScript compilation..."
+
+cd generated/code
+
+# Check if dependencies are installed
+if [ ! -d "node_modules" ]; then
+  echo "   → Installing dependencies (this may take a minute)..."
+  npm install --silent 2>&1 | grep -v "^npm WARN" || true
+fi
+
+# Try to compile TypeScript
+echo "   → Compiling TypeScript..."
+if npx tsc --noEmit 2>&1 | tee compile.log; then
+  echo "   ✅ TypeScript compilation successful"
+  COMPILE_STATUS="✅ PASSED"
+else
+  echo "   ⚠️  TypeScript compilation has errors (expected - missing runtime setup)"
+  echo "   📝 See generated/code/compile.log for details"
+  COMPILE_STATUS="⚠️  NEEDS SETUP"
+fi
+
+cd ../..
+
+echo ""
+echo "🔍 Step 3: Analyzing generated code quality..."
+
+# Check for v3.3 features in generated code
+echo "   → Checking for v3.3 features..."
+
+FEATURES_FOUND=0
+
+if grep -q "validate(data: any, context:" generated/code/services/*.ts 2>/dev/null; then
+  echo "   ✅ Unified validation method found"
+  ((FEATURES_FOUND++))
+fi
+
+if grep -q "version mismatch" generated/code/services/*.ts 2>/dev/null; then
+  echo "   ✅ Optimistic locking found"
+  ((FEATURES_FOUND++))
+fi
+
+if grep -q "deletedAt: null\|isDeleted: false" generated/code/services/*.ts 2>/dev/null; then
+  echo "   ✅ Soft delete filtering found"
+  ((FEATURES_FOUND++))
+fi
+
+if grep -q "createdAt\|updatedAt" generated/code/services/*.ts 2>/dev/null; then
+  echo "   ✅ Audit fields found"
+  ((FEATURES_FOUND++))
+fi
+
+if grep -q "EventBus\|eventBus" generated/code/services/*.ts 2>/dev/null; then
+  echo "   ✅ Event publishing found"
+  ((FEATURES_FOUND++))
+fi
+
+echo ""
+echo "📊 Step 4: Code Quality Report"
+echo "   ════════════════════════════════════════"
+
+# Count generated files
+SERVICE_COUNT=$(find generated/code/services -name "*.ts" 2>/dev/null | wc -l | tr -d ' ')
+ROUTE_COUNT=$(find generated/code/routes -name "*.js" -o -name "*.ts" 2>/dev/null | wc -l | tr -d ' ')
+
+echo "   Files Generated:"
+echo "      Services: $SERVICE_COUNT"
+echo "      Routes: $ROUTE_COUNT"
+echo ""
+echo "   v3.3 Features: $FEATURES_FOUND/5 detected"
+echo "   Compilation: $COMPILE_STATUS"
+echo ""
+
+# Show service structure
+if [ -d "generated/code/services" ] && [ -n "$(ls -A generated/code/services/*.ts 2>/dev/null)" ]; then
+  echo "   Service Structure:"
+  for file in generated/code/services/*.ts; do
+    if [ -f "$file" ]; then
+      SERVICE_NAME=$(basename "$file" .service.ts)
+      METHOD_COUNT=$(grep -c "async\s\+\w\+(.*)" "$file" || echo "0")
+      echo "      $(basename "$file"): $METHOD_COUNT methods"
+    fi
+  done
+  echo ""
+fi
+
+echo "✅ Generated Code Analysis Complete!"
+echo ""
+echo "📝 Next Steps to Run Generated Code:"
+echo "   1. cd generated/code"
+echo "   2. npm install"
+echo "   3. Set up database (Prisma: npx prisma generate && npx prisma migrate dev)"
+echo "   4. Create server entry point (services/index.ts)"
+echo "   5. npm run start:dev"
+echo ""
+echo "💡 Tip: See generated/code/compile.log for compilation details"

package/assets/templates/frontend-only/specs/main.specly

@@ -0,0 +1,57 @@
+# SpecVerse Frontend-Only Application
+# A React SPA that connects to an external API - perfect for JAMstack and frontend-first development
+#
+# To use:
+# 1. Configure API_BASE_URL in .env
+# 2. Run: npm run realize:all
+# 3. Run: cd generated/code && npm install
+# 4. Run: npm run dev
+# 5. Open: http://localhost:5173
+
+components:
+  {{componentName}}:
+    version: "1.0.0"
+    description: "{{projectName}} - Frontend Application"
+    tags: ["frontend", "react", "spa"]
+
+    models:
+      Product:
+        description: "Product from external API"
+        
+        attributes:
+          id: UUID required
+          name: String required
+          description: Text
+          price: Decimal required
+          category: String
+          inStock: Boolean default=true
+
+    views:
+      ProductListView:
+        description: "Browse all products"
+        model: Product
+        uiComponents:
+          ProductGrid: {}
+          ProductFilters: {}
+          
+      ProductDetailView:
+        description: "View product details"
+        model: Product
+        uiComponents:
+          ProductInfo: {}
+          AddToCart: {}
+
+deployments:
+  development:
+    version: "1.0.0"
+    description: "{{projectName}} development environment"
+    environment: "development"
+
+    instances:
+      controllers:
+        uiServer:
+          component: {{componentName}}
+          namespace: ui
+          scale: 1
+          advertises: [ui.*]
+          uses: [api.*]

package/assets/templates/full-stack/AI-GUIDE.md

@@ -0,0 +1,60 @@
+# SpecVerse AI Development Guide
+
+**📖 This guide has been superseded by the comprehensive guide.**
+
+## Updated Documentation Location
+
+For complete SpecVerse AI development guidance, please see:
+
+**SPECVERSE-COMPLETE-GUIDE.md** in your SpecVerse installation:
+- **Local development**: `node_modules/@specverse/lang/schema/SPECVERSE-COMPLETE-GUIDE.md`
+- **Global installation**: Run `specverse docs` to view the guide
+- **Online**: [SpecVerse Documentation](https://specverse.org/guide)
+
+The complete guide includes everything from this legacy guide plus:
+
+## Enhanced Content
+
+- **Complete structure reference** - Every schema element documented
+- **Practical examples** - From simple blog to enterprise SaaS
+- **Convention syntax patterns** - Full shorthand reference
+- **AI development workflows** - Step-by-step AI operation guidance
+- **Deployment patterns** - Real-world deployment configurations for all scales
+- **Command reference** - All CLI commands in one place
+- **Best practices** - Common pitfalls and recommendations
+- **Type reference** - Complete primitive and format types
+- **Manifest system** - Implementation guidance patterns
+
+## Quick Reference for AI Assistants
+
+### Key Principles
+1. Use conventions: `attributeName: TypeName modifiers` for 90% of attributes
+2. Component names: PascalCase (UserManagement, PaymentService)
+3. Start minimal: Let AI inference expand to complete architecture
+4. Scale appropriately: Personal ≠ Enterprise complexity
+
+### Quick Syntax Reference
+
+For working examples showing all essential SpecVerse syntax patterns:
+**`node_modules/@specverse/lang/schema/MINIMAL-SYNTAX-REFERENCE.specly`**
+
+This auto-generated file demonstrates core concepts with practical examples.
+
+### Essential Commands
+```bash
+# Validate specification
+specverse validate specs/main.specly
+
+# Generate complete architecture with AI inference
+specverse infer specs/main.specly -o specs/complete.specly
+
+# Generate all outputs
+specverse gen all specs/main.specly
+```
+
+## Migration Note
+
+The legacy AI-GUIDE.md has been archived to `archive/AI-GUIDE-legacy.md` for reference.
+
+---
+*For comprehensive guidance, see SPECVERSE-COMPLETE-GUIDE.md in your SpecVerse installation*