specweave 0.22.0 → 0.22.2

package/dist/src/core/workflow/workflow-orchestrator.js

@@ -0,0 +1,195 @@
+/**
+ * Workflow Orchestrator - Core orchestration logic for /specweave:next
+ *
+ * Coordinates workflow execution by detecting current phase and
+ * invoking appropriate commands.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/workflow-orchestrator
+ * @since v0.22.0
+ */
+import { PhaseDetector } from './phase-detector.js';
+import { WorkflowPhase } from './types.js';
+import { ActiveIncrementManager } from '../increment/active-increment-manager.js';
+/**
+ * Workflow Orchestrator - Coordinates intelligent workflow execution
+ *
+ * This is a simplified initial implementation focusing on core phase detection.
+ * Full autonomous execution will be added in future tasks.
+ */
+export class WorkflowOrchestrator {
+    constructor() {
+        this.phaseDetector = new PhaseDetector();
+        this.activeIncrementManager = new ActiveIncrementManager();
+    }
+    /**
+     * Execute next step in workflow (interactive mode)
+     *
+     * Detects current phase and suggests/executes appropriate action.
+     *
+     * @param incrementId - Optional increment ID (auto-detects if not provided)
+     * @param options - Execution options
+     * @returns Workflow execution result
+     */
+    async executeNext(incrementId, options = {}) {
+        try {
+            // Phase 1: Detect current workflow phase
+            const detection = await this.detectCurrentPhase(incrementId);
+            // Phase 2: Determine action based on phase and confidence
+            const action = this.determineAction(detection, options);
+            // Format reasoning from detection evidence
+            const reasoning = this.formatReasoning(detection);
+            // Phase 3: Execute action (or return suggestion)
+            if (options.dryRun) {
+                return {
+                    success: true,
+                    phase: detection.phase,
+                    confidence: detection.confidence,
+                    action: action.description,
+                    reasoning: `[DRY RUN] Would execute: ${action.description}\n\n${reasoning}`
+                };
+            }
+            // For now, return suggestion (actual execution will be added in later tasks)
+            return {
+                success: true,
+                phase: detection.phase,
+                confidence: detection.confidence,
+                action: action.description,
+                command: action.command,
+                reasoning
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                phase: WorkflowPhase.UNKNOWN,
+                confidence: 0,
+                error: error instanceof Error ? error.message : String(error),
+                reasoning: 'Failed to detect workflow phase or execute action'
+            };
+        }
+    }
+    /**
+     * Format reasoning from phase detection result
+     */
+    formatReasoning(detection) {
+        const parts = [];
+        // Add suggestion reason if present
+        if (detection.suggestionReason) {
+            parts.push(detection.suggestionReason);
+        }
+        // Add evidence summary
+        if (detection.evidence && detection.evidence.length > 0) {
+            parts.push('\nEvidence:');
+            detection.evidence.forEach(ev => {
+                parts.push(`- ${ev.description} (${(ev.weight * 100).toFixed(0)}% weight)`);
+            });
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Detect current workflow phase for increment
+     *
+     * @param incrementId - Increment ID (auto-detects if not provided)
+     * @returns Phase detection result
+     */
+    async detectCurrentPhase(incrementId) {
+        // If no increment ID provided, try to auto-detect active increment
+        if (!incrementId) {
+            incrementId = await this.detectActiveIncrement();
+        }
+        // Build detection context
+        const context = {
+            userPrompt: 'Detect current workflow phase',
+            incrementId,
+            workingDirectory: process.cwd()
+        };
+        // Detect phase using PhaseDetector
+        return this.phaseDetector.detect(context);
+    }
+    /**
+     * Auto-detect active increment
+     *
+     * @returns Increment ID or throws if none found
+     */
+    async detectActiveIncrement() {
+        const activeIds = this.activeIncrementManager.getActive();
+        if (activeIds.length === 0) {
+            throw new Error('No active increments found. Use /specweave:increment to create one.');
+        }
+        if (activeIds.length === 1) {
+            return activeIds[0];
+        }
+        // Multiple active increments - return primary (first)
+        console.log(`Multiple active increments detected: ${activeIds.join(', ')}`);
+        console.log(`Using primary increment: ${activeIds[0]}`);
+        return activeIds[0];
+    }
+    /**
+     * Determine action based on phase and confidence
+     *
+     * @param detection - Phase detection result
+     * @param options - Execution options
+     * @returns Suggested action
+     */
+    determineAction(detection, options) {
+        const { phase, confidence } = detection;
+        // Low confidence - prompt user
+        if (confidence < 0.7 && !options.force) {
+            return {
+                description: `Phase detection confidence is low (${(confidence * 100).toFixed(0)}%). Please specify action manually.`,
+                command: undefined
+            };
+        }
+        // Map phase to action
+        switch (phase) {
+            case WorkflowPhase.PLAN_GENERATION:
+                return {
+                    description: 'Generate implementation plan',
+                    command: '/specweave:plan'
+                };
+            case WorkflowPhase.IMPLEMENTATION:
+                return {
+                    description: 'Execute tasks',
+                    command: '/specweave:do'
+                };
+            case WorkflowPhase.TESTING:
+                return {
+                    description: 'Run tests',
+                    command: 'npm test'
+                };
+            case WorkflowPhase.REVIEW:
+                return {
+                    description: 'Run quality assessment',
+                    command: '/specweave:qa'
+                };
+            case WorkflowPhase.COMPLETION:
+                return {
+                    description: 'Close increment',
+                    command: '/specweave:done'
+                };
+            case WorkflowPhase.SPEC_WRITING:
+                return {
+                    description: 'Complete spec.md and generate plan',
+                    command: '/specweave:plan'
+                };
+            case WorkflowPhase.TASK_BREAKDOWN:
+                return {
+                    description: 'Create tasks and start implementation',
+                    command: '/specweave:do'
+                };
+            case WorkflowPhase.DOCUMENTATION:
+                return {
+                    description: 'Update living documentation',
+                    command: '/specweave:sync-docs update'
+                };
+            default:
+                return {
+                    description: 'Phase detection unclear - please specify action manually',
+                    command: undefined
+                };
+        }
+    }
+}
+//# sourceMappingURL=workflow-orchestrator.js.map

package/dist/src/core/workflow/workflow-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-orchestrator.js","sourceRoot":"","sources":["../../../../src/core/workflow/workflow-orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/src/init/architecture/types.d.ts

@@ -199,6 +199,11 @@ export declare const ArchitectureRecommendationSchema: z.ZodObject<{
         description?: string;
     }[];
     infrastructure?: string[];
+    alternatives?: {
+        architecture?: "serverless" | "traditional-monolith" | "microservices" | "modular-monolith" | "jamstack" | "hybrid";
+        pros?: string[];
+        cons?: string[];
+    }[];
     rationale?: string;
     costEstimate?: {
         at1K?: string;
@@ -214,11 +219,6 @@ export declare const ArchitectureRecommendationSchema: z.ZodObject<{
         duration?: string;
     }[];
     methodology?: "agile" | "waterfall";
-    alternatives?: {
-        architecture?: "serverless" | "traditional-monolith" | "microservices" | "modular-monolith" | "jamstack" | "hybrid";
-        pros?: string[];
-        cons?: string[];
-    }[];
 }, {
     architecture?: "serverless" | "traditional-monolith" | "microservices" | "modular-monolith" | "jamstack" | "hybrid";
     projects?: {
@@ -227,6 +227,11 @@ export declare const ArchitectureRecommendationSchema: z.ZodObject<{
         description?: string;
     }[];
     infrastructure?: string[];
+    alternatives?: {
+        architecture?: "serverless" | "traditional-monolith" | "microservices" | "modular-monolith" | "jamstack" | "hybrid";
+        pros?: string[];
+        cons?: string[];
+    }[];
     rationale?: string;
     costEstimate?: {
         at1K?: string;
@@ -242,10 +247,5 @@ export declare const ArchitectureRecommendationSchema: z.ZodObject<{
         duration?: string;
     }[];
     methodology?: "agile" | "waterfall";
-    alternatives?: {
-        architecture?: "serverless" | "traditional-monolith" | "microservices" | "modular-monolith" | "jamstack" | "hybrid";
-        pros?: string[];
-        cons?: string[];
-    }[];
 }>;
 //# sourceMappingURL=types.d.ts.map

package/dist/src/metrics/dora-calculator.js

@@ -94,12 +94,12 @@ async function main() {
         const client = new GitHubClient(config);
         const result = await calculateDORAMetrics(client);
         // Write JSON file
-        const jsonOutputPath = path.join(process.cwd(), 'metrics', 'dora-latest.json');
+        const jsonOutputPath = path.join(process.cwd(), '.specweave', 'metrics', 'dora-latest.json');
         writeMetricsJSON(result.metrics, jsonOutputPath);
         // Generate and write markdown report
         console.log('\n📝 Generating detailed report...');
         const report = generateMarkdownReport(result.metrics, result.releases, result.issues);
-        const reportOutputPath = path.join(process.cwd(), 'metrics', 'dora-report.md');
+        const reportOutputPath = path.join(process.cwd(), '.specweave', 'metrics', 'dora-report.md');
         writeReport(report, reportOutputPath);
         console.log('\n🎉 DORA metrics calculation complete!');
         console.log(`   📊 JSON: ${jsonOutputPath}`);

package/dist/src/metrics/dora-calculator.js.map

@@ -1 +1 @@
-{"version":3,"file":"dora-calculator.js","sourceRoot":"","sources":["../../../src/metrics/dora-calculator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dora-calculator.js","sourceRoot":"","sources":["../../../src/metrics/dora-calculator.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/pricing-constants.d.ts

@@ -64,7 +64,10 @@ export declare function getModelPricing(model: 'sonnet' | 'haiku' | 'opus'): {
  * @param actualModel - Model actually used
  * @param inputTokens - Input tokens
  * @param outputTokens - Output tokens
- * @returns Savings amount in dollars (positive = saved money)
+ * @returns Object with savedAmount (dollars) and savedPercent (percentage)
  */
-export declare function calculateSavings(actualModel: 'sonnet' | 'haiku' | 'opus', inputTokens: number, outputTokens: number): number;
+export declare function calculateSavings(actualModel: 'sonnet' | 'haiku' | 'opus', inputTokens: number, outputTokens: number): {
+    savedAmount: number;
+    savedPercent: number;
+};
 //# sourceMappingURL=pricing-constants.d.ts.map

package/dist/src/utils/pricing-constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pricing-constants.d.ts","sourceRoot":"","sources":["../../../src/utils/pricing-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;CAaV,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,EAClC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAGR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM;;;;;;;;;EAEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,EACxC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAMR"}
+{"version":3,"file":"pricing-constants.d.ts","sourceRoot":"","sources":["../../../src/utils/pricing-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;CAaV,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,EAClC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAGR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM;;;;;;;;;EAEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,EACxC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAO/C"}

package/dist/src/utils/pricing-constants.js

@@ -60,12 +60,13 @@ export function getModelPricing(model) {
  * @param actualModel - Model actually used
  * @param inputTokens - Input tokens
  * @param outputTokens - Output tokens
- * @returns Savings amount in dollars (positive = saved money)
+ * @returns Object with savedAmount (dollars) and savedPercent (percentage)
  */
 export function calculateSavings(actualModel, inputTokens, outputTokens) {
     const actualCost = calculateCost(actualModel, inputTokens, outputTokens);
     const baselineCost = calculateCost('sonnet', inputTokens, outputTokens);
     const savedAmount = baselineCost - actualCost;
-    return savedAmount;
+    const savedPercent = baselineCost > 0 ? (savedAmount / baselineCost) * 100 : 0;
+    return { savedAmount, savedPercent };
 }
 //# sourceMappingURL=pricing-constants.js.map

package/dist/src/utils/pricing-constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"pricing-constants.js","sourceRoot":"","sources":["../../../src/utils/pricing-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ,EAAI,yBAAyB;QAC5C,MAAM,EAAE,QAAQ,EAAG,2BAA2B;KAC/C;IACD,KAAK,EAAE;QACL,KAAK,EAAE,QAAQ,EAAI,yBAAyB;QAC5C,MAAM,EAAE,QAAQ,EAAG,0BAA0B;KAC9C;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,QAAQ,EAAI,0BAA0B;QAC7C,MAAM,EAAE,QAAQ,EAAG,2BAA2B;KAC/C;CACO,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAkC,EAClC,WAAmB,EACnB,YAAoB;IAEpB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAkC;IAChE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAwC,EACxC,WAAmB,EACnB,YAAoB;IAEpB,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IACxE,MAAM,WAAW,GAAG,YAAY,GAAG,UAAU,CAAC;IAE9C,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"pricing-constants.js","sourceRoot":"","sources":["../../../src/utils/pricing-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ,EAAI,yBAAyB;QAC5C,MAAM,EAAE,QAAQ,EAAG,2BAA2B;KAC/C;IACD,KAAK,EAAE;QACL,KAAK,EAAE,QAAQ,EAAI,yBAAyB;QAC5C,MAAM,EAAE,QAAQ,EAAG,0BAA0B;KAC9C;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,QAAQ,EAAI,0BAA0B;QAC7C,MAAM,EAAE,QAAQ,EAAG,2BAA2B;KAC/C;CACO,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAkC,EAClC,WAAmB,EACnB,YAAoB;IAEpB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAkC;IAChE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAwC,EACxC,WAAmB,EACnB,YAAoB;IAEpB,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IACxE,MAAM,WAAW,GAAG,YAAY,GAAG,UAAU,CAAC;IAC9C,MAAM,YAAY,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;AACvC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.22.0",
+  "version": "0.22.2",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",
@@ -97,13 +97,13 @@
     "@types/inquirer": "^9.0.7",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.10.0",
-    "@vitest/coverage-v8": "^2.1.0",
-    "@vitest/ui": "^2.1.0",
+    "@vitest/coverage-v8": "^2.1.9",
+    "@vitest/ui": "^2.1.9",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "dotenv": "^17.2.3",
     "gray-matter": "^4.0.3",
     "typescript": "^5.3.0",
-    "vitest": "^2.1.0"
+    "vitest": "^2.1.9"
   }
 }

package/plugins/specweave/agents/infrastructure/AGENT.md

@@ -60,24 +60,38 @@ I generate Terraform configurations for 5 serverless platforms:
 
 ### 2. Template Engine Integration
 
-I use the **TerraformTemplateEngine** to render Handlebars templates:
-
-**Template Location**: `plugins/specweave/iac-templates/{platform-id}/`
-
-**Template Files**:
-- `main.tf.hbs` - Core infrastructure resources
-- `variables.tf.hbs` - Input variables with defaults
-- `outputs.tf.hbs` - Output values (URLs, ARNs, IDs)
-- `provider.tf.hbs` - Cloud provider configuration
-- `iam.tf.hbs` - IAM roles, policies, service accounts (security)
-- `README.md.hbs` - Deployment instructions and documentation
-
-**Custom Helpers**:
-- `{{snakeCase name}}` - Convert to snake_case
-- `{{kebabCase name}}` - Convert to kebab-case
-- `{{tfList items}}` - Format as Terraform list
-- `{{tfMap obj}}` - Format as Terraform map
+I use the **TerraformTemplateEngine** to render Handlebars templates with full serverless platform support:
+
+**Template Location**: `plugins/specweave/templates/iac/{platform}/`
+
+**Supported Platforms**:
+- `aws-lambda/` - AWS Lambda + API Gateway + DynamoDB
+- `azure-functions/` - Azure Functions + Cosmos DB
+- `gcp-cloud-functions/` - GCP Cloud Functions + Firestore
+- `firebase/` - Firebase Hosting + Functions + Firestore
+- `supabase/` - Supabase (PostgreSQL + Auth + Storage)
+
+**Template Files** (each platform has):
+- `templates/main.tf.hbs` - Core infrastructure resources
+- `templates/variables.tf.hbs` - Input variables with defaults
+- `templates/outputs.tf.hbs` - Output values (URLs, ARNs, IDs)
+- `templates/providers.tf.hbs` - Cloud provider configuration
+- `templates/iam.tf.hbs` - IAM roles, policies, service accounts (AWS/GCP)
+- `templates/README.md.hbs` - Deployment instructions and cost estimates
+- `templates/environments/dev.tfvars.hbs` - Development config (free tier optimized)
+- `templates/environments/staging.tfvars.hbs` - Staging config
+- `templates/environments/prod.tfvars.hbs` - Production config (HA, backup)
+- `defaults.json` - Default values for template variables
+
+**Custom Handlebars Helpers**:
+- `{{snakeCase name}}` - Convert to snake_case (e.g., "myFunction" → "my_function")
+- `{{kebabCase name}}` - Convert to kebab-case (e.g., "myFunction" → "my-function")
+- `{{tfList items}}` - Format array as Terraform list (e.g., ["a","b"] → `["a", "b"]`)
+- `{{tfMap obj}}` - Format object as Terraform map
 - `{{#if (eq var "value")}}...{{/if}}` - Conditional rendering
+- `{{#each items}}...{{/each}}` - Loop over arrays
+- `{{multiply a b}}` - Arithmetic operations
+- `{{add a b}}` - Addition for cost calculations
 
 ### 3. Environment-Specific Configurations
 
@@ -156,37 +170,65 @@ Architect Agent: → Recommends: AWS Lambda for startup project
 
 Infrastructure Agent (me):
   1. Load Templates:
-     - Locate: plugins/specweave/iac-templates/aws-lambda/
-     - Read: main.tf.hbs, variables.tf.hbs, outputs.tf.hbs, provider.tf.hbs, iam.tf.hbs, README.md.hbs
+     - Locate: plugins/specweave/templates/iac/aws-lambda/
+     - Read all template files:
+       * templates/main.tf.hbs
+       * templates/variables.tf.hbs
+       * templates/outputs.tf.hbs
+       * templates/providers.tf.hbs
+       * templates/iam.tf.hbs
+       * templates/README.md.hbs
+       * templates/environments/*.tfvars.hbs
 
   2. Merge Defaults:
-     - Load: aws-lambda/defaults.json
-     - Merge: defaults + project metadata
-     - Result: Complete variable set
+     - Load: defaults.json from aws-lambda/
+     - Merge: defaults + architect recommendation metadata
+     - Result: Complete variable set with all required values
 
   3. Render Templates:
-     - Use: TerraformTemplateEngine
-     - Render: Each .hbs file → .tf file
-     - Apply: Custom helpers (snakeCase, conditionals)
+     - Use: Handlebars template engine
+     - Render: Each .hbs file → corresponding output file
+     - Apply: Custom helpers (snakeCase, tfList, conditionals, loops)
+     - Substitute: All {{variableName}} placeholders with actual values
 
   4. Generate Environment Configs:
-     - Load: environments/dev.defaults.json
-     - Generate: environments/dev.tfvars
-     - Load: environments/staging.defaults.json
-     - Generate: environments/staging.tfvars
-     - Load: environments/prod.defaults.json
-     - Generate: environments/prod.tfvars
+     - Dev environment:
+       * Render: templates/environments/dev.tfvars.hbs → dev.tfvars
+       * Optimize: Free tier settings (min resources, pay-per-request)
+     - Staging environment:
+       * Render: templates/environments/staging.tfvars.hbs → staging.tfvars
+       * Balance: Performance vs cost
+     - Production environment:
+       * Render: templates/environments/prod.tfvars.hbs → prod.tfvars
+       * Maximize: Availability, backup, multi-region
 
   5. Write Files:
-     - Create: .infrastructure/aws-lambda/ directory
-     - Write: main.tf, variables.tf, outputs.tf, provider.tf, iam.tf
-     - Write: README.md (deployment instructions)
-     - Write: environments/*.tfvars
+     - Create: .infrastructure/aws-lambda/ directory in project root
+     - Write Terraform files:
+       * main.tf (infrastructure resources)
+       * variables.tf (input variables)
+       * outputs.tf (output values)
+       * providers.tf (AWS provider config)
+       * iam.tf (IAM roles and policies)
+     - Write documentation:
+       * README.md (deployment instructions, cost estimates, troubleshooting)
+     - Write environment configs:
+       * environments/dev.tfvars
+       * environments/staging.tfvars
+       * environments/prod.tfvars
 
   6. Output Summary:
      ✅ Generated 9 files in .infrastructure/aws-lambda/
-     📄 Review files before deploying
-     🚀 Next steps: terraform init → plan → apply
+     📄 Review generated files:
+        - main.tf: Lambda, API Gateway, DynamoDB resources
+        - iam.tf: Least-privilege IAM roles
+        - README.md: Deployment guide with cost estimates
+     💰 Estimated cost (dev): $0/month (free tier)
+     🚀 Next steps:
+        1. Review infrastructure files
+        2. Run: terraform init
+        3. Run: terraform plan -var-file="environments/dev.tfvars"
+        4. Run: terraform apply -var-file="environments/dev.tfvars"
 ```
 
 ### Workflow 2: Multi-Environment Deployment
@@ -239,12 +281,12 @@ Infrastructure Agent:
 **My Process**:
 ```
 1. Load Templates:
-   ✅ plugins/specweave/iac-templates/aws-lambda/main.tf.hbs
-   ✅ plugins/specweave/iac-templates/aws-lambda/variables.tf.hbs
-   ✅ plugins/specweave/iac-templates/aws-lambda/outputs.tf.hbs
-   ✅ plugins/specweave/iac-templates/aws-lambda/provider.tf.hbs
-   ✅ plugins/specweave/iac-templates/aws-lambda/iam.tf.hbs
-   ✅ plugins/specweave/iac-templates/aws-lambda/README.md.hbs
+   ✅ plugins/specweave/templates/iac/aws-lambda/main.tf.hbs
+   ✅ plugins/specweave/templates/iac/aws-lambda/variables.tf.hbs
+   ✅ plugins/specweave/templates/iac/aws-lambda/outputs.tf.hbs
+   ✅ plugins/specweave/templates/iac/aws-lambda/provider.tf.hbs
+   ✅ plugins/specweave/templates/iac/aws-lambda/iam.tf.hbs
+   ✅ plugins/specweave/templates/iac/aws-lambda/README.md.hbs
 
 2. Render with Variables:
    - projectName: "my-startup-api"
@@ -362,7 +404,7 @@ import { TerraformTemplateEngine } from '@specweave/core/iac/template-engine';
 
 const engine = new TerraformTemplateEngine();
 const result = await engine.render({
-  templatePath: 'plugins/specweave/iac-templates/aws-lambda',
+  templatePath: 'plugins/specweave/templates/iac/aws-lambda',
   variables: {
     projectName: 'my-api',
     functionName: 'my-handler',
@@ -406,7 +448,7 @@ const platformTemplateMap = {
   'supabase': 'supabase'
 };
 
-const templateDir = `plugins/specweave/iac-templates/${platformTemplateMap[platformId]}`;
+const templateDir = `plugins/specweave/templates/iac/${platformTemplateMap[platformId]}`;
 ```
 
 **Required Files**:
@@ -694,7 +736,7 @@ for (const env of environments) {
 **Solution**:
 ```bash
 # Verify template exists
-ls plugins/specweave/iac-templates/aws-lambda/
+ls plugins/specweave/templates/iac/aws-lambda/
 
 # Check platform ID mapping
 # Valid IDs: aws-lambda, azure-functions, gcp-cloud-functions, firebase, supabase

package/plugins/specweave/agents/pm/AGENT.md

@@ -10,6 +10,50 @@ fallback_behavior: strict
 
 # PM Agent - Product Manager AI Assistant
 
+## ⛔ CRITICAL: Increment Folder Structure (MANDATORY)
+
+**ALL files created by this agent MUST follow this structure**:
+
+### Allowed Files in Increment Root
+**ONLY these 3 files are allowed** in `.specweave/increments/####-name/`:
+1. ✅ `spec.md` - Specification
+2. ✅ `plan.md` - Implementation plan
+3. ✅ `tasks.md` - Tasks with embedded tests
+
+### ALL Other Files Go in Subfolders
+
+**MANDATORY subfolder organization**:
+```
+.specweave/increments/####-name/
+├── spec.md              # ✅ ONLY core file 1
+├── plan.md              # ✅ ONLY core file 2
+├── tasks.md             # ✅ ONLY core file 3
+├── reports/             # ✅ ALL reports here
+│   ├── PM-VALIDATION-REPORT.md
+│   ├── COMPLETION-SUMMARY.md
+│   ├── SESSION-NOTES.md
+│   └── ANALYSIS-*.md
+├── scripts/             # ✅ ALL scripts here
+│   └── helper-*.sh
+└── logs/                # ✅ ALL logs here
+    └── execution.log
+```
+
+**When writing ANY file**:
+- ❌ **NEVER** write `.md` files to increment root (except spec.md, plan.md, tasks.md)
+- ✅ **ALWAYS** write reports to `reports/` subfolder
+- ✅ **ALWAYS** write scripts to `scripts/` subfolder
+- ✅ **ALWAYS** write logs to `logs/` subfolder
+
+**Example correct paths**:
+- ✅ `.specweave/increments/0001-auth/reports/PM-VALIDATION-REPORT.md`
+- ✅ `.specweave/increments/0001-auth/reports/COMPLETION-SUMMARY.md`
+- ❌ `.specweave/increments/0001-auth/PM-VALIDATION-REPORT.md` (WRONG!)
+
+**This is NON-NEGOTIABLE**. Violations will be flagged and files will be moved by maintainers.
+
+---
+
 ## 📚 Required Reading (LOAD FIRST)
 
 **CRITICAL**: Before planning features or increments, read these guides:
@@ -1164,10 +1208,23 @@ When creating metadata.json, extract values from spec.md frontmatter:
 - `priority`: Look for `priority: P1|P2|P3`
 - `testMode`: Look for `test_mode: TDD|BDD|Standard` (default: "TDD")
 - `coverageTarget`: Look for `coverage_target: 80|85|90|95|100` (default: 95)
-- `epic`: Look for `epic: FS-YY-MM-DD` (optional)
+- `epic`: **CRITICAL - Format depends on increment type**:
+  - **Greenfield** (SpecWeave-native): Leave EMPTY (auto-generated as `FS-{increment-number}` during sync)
+  - **Brownfield** (imported from Jira/GitHub/ADO): Use `epic: FS-YY-MM-DD-name` + add `imported: true`
 
 **DO NOT hardcode values** - always extract from spec.md when possible!
 
+**⛔ CRITICAL: Epic Field Rules**
+
+When creating spec.md frontmatter:
+- **NEW increments** (greenfield): DO NOT add `epic:` field (leave it empty for auto-generation)
+- **Imported work** (brownfield): Add `epic: FS-YY-MM-DD-name` AND `imported: true`
+
+**Why this matters**:
+- Greenfield increments use `FS-{increment-number}` format (e.g., `FS-031`, `FS-043`)
+- Brownfield increments use `FS-YY-MM-DD-name` format (e.g., `FS-25-11-14-jira-epic`)
+- Mixing formats pollutes living docs and breaks feature tracking
+
 ### Code Reference (TypeScript Pseudocode)
 
 This is what you're executing with Read/Write tools:

package/plugins/specweave/commands/specweave-archive-features.md

@@ -1,5 +1,5 @@
 ---
-name: specweave-archive-features
+name: specweave:archive-features
 description: Archive features and epics when all related increments are archived
 ---
 

package/plugins/specweave/commands/specweave-archive-increments.md

@@ -1,5 +1,5 @@
 ---
-name: specweave-archive-increments
+name: specweave:archive-increments
 description: Archive completed increments to keep workspace clean
 ---
 

package/plugins/specweave/commands/specweave-check-hooks.md

@@ -1,3 +1,8 @@
+---
+name: specweave:check-hooks
+description: Comprehensive health check for hooks - detects import errors, runtime failures, performance issues, and provides auto-fix suggestions
+---
+
 # Check Hook Health
 
 **Command**: `/specweave:check-hooks`