specweave 0.3.13 → 0.4.0

package/dist/utils/cost-reporter.js

@@ -0,0 +1,224 @@
+/**
+ * Cost Report Generation
+ *
+ * Generates human-readable cost reports with multiple export formats:
+ * - JSON (machine-readable)
+ * - CSV (spreadsheet import)
+ * - ASCII Dashboard (CLI display)
+ */
+import fs from 'fs-extra';
+export class CostReporter {
+    constructor(costTracker) {
+        this.costTracker = costTracker;
+    }
+    /**
+     * Generate cost report for a specific increment
+     *
+     * @param incrementId - Increment ID (e.g., '0003')
+     * @returns Aggregate cost report
+     */
+    generateIncrementReport(incrementId) {
+        return this.costTracker.getIncrementCost(incrementId);
+    }
+    /**
+     * Export report to JSON file
+     *
+     * @param incrementId - Increment ID
+     * @param outputPath - Output file path
+     */
+    async exportToJSON(incrementId, outputPath) {
+        const report = this.generateIncrementReport(incrementId);
+        await fs.writeJson(outputPath, report, { spaces: 2 });
+    }
+    /**
+     * Export report to CSV file
+     *
+     * @param incrementId - Increment ID
+     * @param outputPath - Output file path
+     */
+    async exportToCSV(incrementId, outputPath) {
+        const sessions = this.costTracker.getIncrementSessions(incrementId);
+        // CSV headers
+        const headers = [
+            'Session ID',
+            'Agent',
+            'Model',
+            'Command',
+            'Started At',
+            'Ended At',
+            'Input Tokens',
+            'Output Tokens',
+            'Total Tokens',
+            'Cost ($)',
+            'Savings ($)',
+        ];
+        // CSV rows
+        const rows = sessions.map((s) => [
+            s.sessionId,
+            s.agent,
+            s.model,
+            s.command || 'N/A',
+            s.startedAt,
+            s.endedAt || 'In Progress',
+            s.tokenUsage.inputTokens.toString(),
+            s.tokenUsage.outputTokens.toString(),
+            s.tokenUsage.totalTokens.toString(),
+            s.cost.toFixed(4),
+            s.savings.toFixed(4),
+        ]);
+        // Generate CSV (simple implementation, no external deps)
+        const csv = [headers.join(','), ...rows.map((row) => row.join(','))].join('\n');
+        await fs.writeFile(outputPath, csv, 'utf-8');
+    }
+    /**
+     * Generate ASCII dashboard for CLI display
+     *
+     * @param incrementId - Optional increment ID (defaults to all increments)
+     * @returns ASCII table with cost breakdown
+     */
+    generateDashboard(incrementId) {
+        if (incrementId) {
+            return this.generateIncrementDashboard(incrementId);
+        }
+        else {
+            return this.generateOverallDashboard();
+        }
+    }
+    /**
+     * Generate dashboard for a specific increment
+     */
+    generateIncrementDashboard(incrementId) {
+        const report = this.generateIncrementReport(incrementId);
+        const sessions = this.costTracker.getIncrementSessions(incrementId);
+        if (sessions.length === 0) {
+            return `No cost data for increment ${incrementId}`;
+        }
+        const lines = [];
+        // Header
+        lines.push('');
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push(`  Cost Report: Increment ${incrementId}`);
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('');
+        // Summary
+        lines.push('SUMMARY');
+        lines.push('───────────────────────────────────────────────────────────────');
+        lines.push(`  Total Cost:       $${report.totalCost.toFixed(4).padStart(10)}`);
+        lines.push(`  Total Savings:    $${report.totalSavings.toFixed(4).padStart(10)}`);
+        const baselineCost = report.totalCost + report.totalSavings;
+        const savingsPercentage = baselineCost > 0 ? (report.totalSavings / baselineCost) * 100 : 0;
+        lines.push(`  Savings %:         ${savingsPercentage.toFixed(1).padStart(10)}%`);
+        lines.push(`  Total Tokens:      ${report.totalTokens.toLocaleString().padStart(10)}`);
+        lines.push(`  Sessions:          ${report.sessionCount.toString().padStart(10)}`);
+        lines.push('');
+        // Cost by Model
+        lines.push('COST BY MODEL');
+        lines.push('───────────────────────────────────────────────────────────────');
+        for (const [model, cost] of Object.entries(report.costByModel)) {
+            const percentage = (cost / report.totalCost) * 100;
+            lines.push(`  ${model.padEnd(15)} $${cost.toFixed(4).padStart(10)}  (${percentage.toFixed(1).padStart(5)}%)`);
+        }
+        lines.push('');
+        // Cost by Agent
+        lines.push('COST BY AGENT');
+        lines.push('───────────────────────────────────────────────────────────────');
+        const sortedAgents = Object.entries(report.costByAgent).sort(([, a], [, b]) => b - a);
+        for (const [agent, cost] of sortedAgents.slice(0, 10)) {
+            // Top 10
+            const percentage = (cost / report.totalCost) * 100;
+            lines.push(`  ${agent.padEnd(25)} $${cost.toFixed(4).padStart(8)}  (${percentage.toFixed(1).padStart(5)}%)`);
+        }
+        if (sortedAgents.length > 10) {
+            lines.push(`  ... and ${sortedAgents.length - 10} more agents`);
+        }
+        lines.push('');
+        // Recent Sessions (last 5)
+        lines.push('RECENT SESSIONS');
+        lines.push('───────────────────────────────────────────────────────────────');
+        const recentSessions = sessions
+            .sort((a, b) => {
+            const timeA = new Date(a.startedAt).getTime();
+            const timeB = new Date(b.startedAt).getTime();
+            return timeB - timeA;
+        })
+            .slice(0, 5);
+        for (const session of recentSessions) {
+            const time = new Date(session.startedAt).toLocaleString();
+            lines.push(`  ${time}`);
+            lines.push(`  Agent: ${session.agent.padEnd(20)} Model: ${session.model}`);
+            lines.push(`  Cost: $${session.cost.toFixed(4).padStart(8)}    Savings: $${session.savings.toFixed(4).padStart(8)}`);
+            lines.push('');
+        }
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('');
+        return lines.join('\n');
+    }
+    /**
+     * Generate dashboard for all increments
+     */
+    generateOverallDashboard() {
+        const summary = this.costTracker.getSummary();
+        if (summary.totalSessions === 0) {
+            return 'No cost data available';
+        }
+        const lines = [];
+        // Header
+        lines.push('');
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('  SpecWeave Cost Summary - All Increments');
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('');
+        // Overall Summary
+        lines.push('OVERALL SUMMARY');
+        lines.push('───────────────────────────────────────────────────────────────');
+        lines.push(`  Total Cost:       $${summary.totalCost.toFixed(4).padStart(10)}`);
+        lines.push(`  Total Savings:    $${summary.totalSavings.toFixed(4).padStart(10)}`);
+        lines.push(`  Savings %:         ${summary.savingsPercentage.toFixed(1).padStart(10)}%`);
+        lines.push(`  Total Sessions:    ${summary.totalSessions.toString().padStart(10)}`);
+        lines.push('');
+        // Agent Stats
+        if (summary.mostExpensiveAgent) {
+            lines.push('AGENT STATS');
+            lines.push('───────────────────────────────────────────────────────────────');
+            lines.push(`  Most Expensive:    ${summary.mostExpensiveAgent}`);
+            if (summary.cheapestAgent !== summary.mostExpensiveAgent) {
+                lines.push(`  Least Expensive:   ${summary.cheapestAgent}`);
+            }
+            lines.push('');
+        }
+        // By Increment
+        const allSessions = this.costTracker.getAllSessions();
+        const incrementIds = [...new Set(allSessions.map((s) => s.increment).filter(Boolean))];
+        if (incrementIds.length > 0) {
+            lines.push('COST BY INCREMENT');
+            lines.push('───────────────────────────────────────────────────────────────');
+            for (const incrementId of incrementIds) {
+                const report = this.generateIncrementReport(incrementId);
+                lines.push(`  ${incrementId.padEnd(30)} $${report.totalCost.toFixed(4).padStart(8)}  (${report.sessionCount} sessions)`);
+            }
+            lines.push('');
+        }
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('');
+        lines.push('💡 Tip: Use "/specweave.costs 0003" to see detailed report for increment 0003');
+        lines.push('');
+        return lines.join('\n');
+    }
+    /**
+     * Generate compact one-line summary
+     *
+     * @param incrementId - Optional increment ID
+     * @returns One-line summary string
+     */
+    generateSummaryLine(incrementId) {
+        if (incrementId) {
+            const report = this.generateIncrementReport(incrementId);
+            return `Increment ${incrementId}: $${report.totalCost.toFixed(4)} cost, $${report.totalSavings.toFixed(4)} saved (${((report.totalSavings / (report.totalCost + report.totalSavings)) * 100).toFixed(1)}%)`;
+        }
+        else {
+            const summary = this.costTracker.getSummary();
+            return `Total: $${summary.totalCost.toFixed(4)} cost, $${summary.totalSavings.toFixed(4)} saved (${summary.savingsPercentage.toFixed(1)}%) across ${summary.totalSessions} sessions`;
+        }
+    }
+}
+//# sourceMappingURL=cost-reporter.js.map

package/dist/utils/cost-reporter.js.map

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

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

@@ -0,0 +1,70 @@
+/**
+ * Anthropic API Pricing Constants
+ *
+ * Pricing as of 2025-10-31 (verified against https://www.anthropic.com/pricing)
+ *
+ * Model Tier Mapping:
+ * - sonnet → claude-sonnet-4-5-20250929 (latest Sonnet 4.5)
+ * - haiku → claude-4-5-haiku-20250110 (latest Haiku 4.5)
+ * - opus → claude-opus-4-0-... (when released)
+ *
+ * Note: This file should be updated when Anthropic releases new models.
+ */
+/**
+ * Pricing per 1M tokens (input/output) in USD
+ */
+export declare const PRICING: {
+    readonly sonnet: {
+        readonly input: 0.000003;
+        readonly output: 0.000015;
+    };
+    readonly haiku: {
+        readonly input: 0.000001;
+        readonly output: 0.000005;
+    };
+    readonly opus: {
+        readonly input: 0.000015;
+        readonly output: 0.000075;
+    };
+};
+/**
+ * Calculate cost for a given model and token usage
+ *
+ * @param model - Model tier (sonnet, haiku, opus)
+ * @param inputTokens - Number of input tokens
+ * @param outputTokens - Number of output tokens
+ * @returns Total cost in USD
+ *
+ * @example
+ * ```typescript
+ * const cost = calculateCost('haiku', 1000, 500);
+ * // Returns: 0.0035 ($0.0035 = $0.001 input + $0.0025 output)
+ * ```
+ */
+export declare function calculateCost(model: 'sonnet' | 'haiku' | 'opus', inputTokens: number, outputTokens: number): number;
+/**
+ * Get pricing constants for a specific model
+ *
+ * @param model - Model tier
+ * @returns Pricing object with input/output costs
+ */
+export declare function getModelPricing(model: 'sonnet' | 'haiku' | 'opus'): {
+    readonly input: 0.000003;
+    readonly output: 0.000015;
+} | {
+    readonly input: 0.000001;
+    readonly output: 0.000005;
+} | {
+    readonly input: 0.000015;
+    readonly output: 0.000075;
+};
+/**
+ * Calculate cost savings vs baseline (all-Sonnet)
+ *
+ * @param actualModel - Model actually used
+ * @param inputTokens - Input tokens
+ * @param outputTokens - Output tokens
+ * @returns Savings amount in dollars (positive = saved money)
+ */
+export declare function calculateSavings(actualModel: 'sonnet' | 'haiku' | 'opus', inputTokens: number, outputTokens: number): number;
+//# sourceMappingURL=pricing-constants.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/pricing-constants.js

@@ -0,0 +1,71 @@
+/**
+ * Anthropic API Pricing Constants
+ *
+ * Pricing as of 2025-10-31 (verified against https://www.anthropic.com/pricing)
+ *
+ * Model Tier Mapping:
+ * - sonnet → claude-sonnet-4-5-20250929 (latest Sonnet 4.5)
+ * - haiku → claude-4-5-haiku-20250110 (latest Haiku 4.5)
+ * - opus → claude-opus-4-0-... (when released)
+ *
+ * Note: This file should be updated when Anthropic releases new models.
+ */
+/**
+ * Pricing per 1M tokens (input/output) in USD
+ */
+export const PRICING = {
+    sonnet: {
+        input: 0.000003, // $3 per 1M input tokens
+        output: 0.000015, // $15 per 1M output tokens
+    },
+    haiku: {
+        input: 0.000001, // $1 per 1M input tokens
+        output: 0.000005, // $5 per 1M output tokens
+    },
+    opus: {
+        input: 0.000015, // $15 per 1M input tokens
+        output: 0.000075, // $75 per 1M output tokens
+    },
+};
+/**
+ * Calculate cost for a given model and token usage
+ *
+ * @param model - Model tier (sonnet, haiku, opus)
+ * @param inputTokens - Number of input tokens
+ * @param outputTokens - Number of output tokens
+ * @returns Total cost in USD
+ *
+ * @example
+ * ```typescript
+ * const cost = calculateCost('haiku', 1000, 500);
+ * // Returns: 0.0035 ($0.0035 = $0.001 input + $0.0025 output)
+ * ```
+ */
+export function calculateCost(model, inputTokens, outputTokens) {
+    const pricing = PRICING[model];
+    return (inputTokens * pricing.input) + (outputTokens * pricing.output);
+}
+/**
+ * Get pricing constants for a specific model
+ *
+ * @param model - Model tier
+ * @returns Pricing object with input/output costs
+ */
+export function getModelPricing(model) {
+    return PRICING[model];
+}
+/**
+ * Calculate cost savings vs baseline (all-Sonnet)
+ *
+ * @param actualModel - Model actually used
+ * @param inputTokens - Input tokens
+ * @param outputTokens - Output tokens
+ * @returns Savings amount in dollars (positive = saved money)
+ */
+export function calculateSavings(actualModel, inputTokens, outputTokens) {
+    const actualCost = calculateCost(actualModel, inputTokens, outputTokens);
+    const baselineCost = calculateCost('sonnet', inputTokens, outputTokens);
+    const savedAmount = baselineCost - actualCost;
+    return savedAmount;
+}
+//# sourceMappingURL=pricing-constants.js.map

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

@@ -0,0 +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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.3.13",
+  "version": "0.4.0",
   "description": "Replace vibe coding with spec-driven development. Smart workflow: /specweave inc auto-closes previous, /specweave build auto-resumes, /specweave progress shows status. PM-led planning, 10 agents, 35+ skills. spec-weave.com",
   "type": "module",
   "main": "dist/index.js",

package/src/agents/architect/AGENT.md

@@ -3,6 +3,9 @@ name: architect
 description: System Architect and technical design expert. Creates system architecture, technical specifications, Architecture Decision Records (ADRs), component designs, API contracts, data models, and deployment architectures. Handles design patterns, scalability planning, technology stack decisions, microservices architecture, event-driven systems, CQRS, domain-driven design. Activates for: architecture, system design, technical design, ADR, architecture decision record, design patterns, microservices, API design, data model, database schema, scalability, performance architecture, technology stack, tech stack selection, distributed systems, event-driven, CQRS, DDD, domain model, component architecture, integration patterns, CAP theorem, consistency, availability, partition tolerance.
 tools: Read, Write, Edit
 model: claude-sonnet-4-5-20250929
+model_preference: sonnet
+cost_profile: planning
+fallback_behavior: strict
 ---
 
 # Architect Agent - System Architecture & Technical Design Expert

package/src/agents/code-reviewer.md

@@ -0,0 +1,156 @@
+---
+name: code-reviewer
+description: Elite code review expert specializing in modern AI-powered code analysis, security vulnerabilities, performance optimization, and production reliability. Masters static analysis tools, security scanning, and configuration review with 2024/2025 best practices. Use PROACTIVELY for code quality assurance.
+model: sonnet
+---
+
+You are an elite code review expert specializing in modern code analysis techniques, AI-powered review tools, and production-grade quality assurance.
+
+## Expert Purpose
+Master code reviewer focused on ensuring code quality, security, performance, and maintainability using cutting-edge analysis tools and techniques. Combines deep technical expertise with modern AI-assisted review processes, static analysis tools, and production reliability practices to deliver comprehensive code assessments that prevent bugs, security vulnerabilities, and production incidents.
+
+## Capabilities
+
+### AI-Powered Code Analysis
+- Integration with modern AI review tools (Trag, Bito, Codiga, GitHub Copilot)
+- Natural language pattern definition for custom review rules
+- Context-aware code analysis using LLMs and machine learning
+- Automated pull request analysis and comment generation
+- Real-time feedback integration with CLI tools and IDEs
+- Custom rule-based reviews with team-specific patterns
+- Multi-language AI code analysis and suggestion generation
+
+### Modern Static Analysis Tools
+- SonarQube, CodeQL, and Semgrep for comprehensive code scanning
+- Security-focused analysis with Snyk, Bandit, and OWASP tools
+- Performance analysis with profilers and complexity analyzers
+- Dependency vulnerability scanning with npm audit, pip-audit
+- License compliance checking and open source risk assessment
+- Code quality metrics with cyclomatic complexity analysis
+- Technical debt assessment and code smell detection
+
+### Security Code Review
+- OWASP Top 10 vulnerability detection and prevention
+- Input validation and sanitization review
+- Authentication and authorization implementation analysis
+- Cryptographic implementation and key management review
+- SQL injection, XSS, and CSRF prevention verification
+- Secrets and credential management assessment
+- API security patterns and rate limiting implementation
+- Container and infrastructure security code review
+
+### Performance & Scalability Analysis
+- Database query optimization and N+1 problem detection
+- Memory leak and resource management analysis
+- Caching strategy implementation review
+- Asynchronous programming pattern verification
+- Load testing integration and performance benchmark review
+- Connection pooling and resource limit configuration
+- Microservices performance patterns and anti-patterns
+- Cloud-native performance optimization techniques
+
+### Configuration & Infrastructure Review
+- Production configuration security and reliability analysis
+- Database connection pool and timeout configuration review
+- Container orchestration and Kubernetes manifest analysis
+- Infrastructure as Code (Terraform, CloudFormation) review
+- CI/CD pipeline security and reliability assessment
+- Environment-specific configuration validation
+- Secrets management and credential security review
+- Monitoring and observability configuration verification
+
+### Modern Development Practices
+- Test-Driven Development (TDD) and test coverage analysis
+- Behavior-Driven Development (BDD) scenario review
+- Contract testing and API compatibility verification
+- Feature flag implementation and rollback strategy review
+- Blue-green and canary deployment pattern analysis
+- Observability and monitoring code integration review
+- Error handling and resilience pattern implementation
+- Documentation and API specification completeness
+
+### Code Quality & Maintainability
+- Clean Code principles and SOLID pattern adherence
+- Design pattern implementation and architectural consistency
+- Code duplication detection and refactoring opportunities
+- Naming convention and code style compliance
+- Technical debt identification and remediation planning
+- Legacy code modernization and refactoring strategies
+- Code complexity reduction and simplification techniques
+- Maintainability metrics and long-term sustainability assessment
+
+### Team Collaboration & Process
+- Pull request workflow optimization and best practices
+- Code review checklist creation and enforcement
+- Team coding standards definition and compliance
+- Mentor-style feedback and knowledge sharing facilitation
+- Code review automation and tool integration
+- Review metrics tracking and team performance analysis
+- Documentation standards and knowledge base maintenance
+- Onboarding support and code review training
+
+### Language-Specific Expertise
+- JavaScript/TypeScript modern patterns and React/Vue best practices
+- Python code quality with PEP 8 compliance and performance optimization
+- Java enterprise patterns and Spring framework best practices
+- Go concurrent programming and performance optimization
+- Rust memory safety and performance critical code review
+- C# .NET Core patterns and Entity Framework optimization
+- PHP modern frameworks and security best practices
+- Database query optimization across SQL and NoSQL platforms
+
+### Integration & Automation
+- GitHub Actions, GitLab CI/CD, and Jenkins pipeline integration
+- Slack, Teams, and communication tool integration
+- IDE integration with VS Code, IntelliJ, and development environments
+- Custom webhook and API integration for workflow automation
+- Code quality gates and deployment pipeline integration
+- Automated code formatting and linting tool configuration
+- Review comment template and checklist automation
+- Metrics dashboard and reporting tool integration
+
+## Behavioral Traits
+- Maintains constructive and educational tone in all feedback
+- Focuses on teaching and knowledge transfer, not just finding issues
+- Balances thorough analysis with practical development velocity
+- Prioritizes security and production reliability above all else
+- Emphasizes testability and maintainability in every review
+- Encourages best practices while being pragmatic about deadlines
+- Provides specific, actionable feedback with code examples
+- Considers long-term technical debt implications of all changes
+- Stays current with emerging security threats and mitigation strategies
+- Champions automation and tooling to improve review efficiency
+
+## Knowledge Base
+- Modern code review tools and AI-assisted analysis platforms
+- OWASP security guidelines and vulnerability assessment techniques
+- Performance optimization patterns for high-scale applications
+- Cloud-native development and containerization best practices
+- DevSecOps integration and shift-left security methodologies
+- Static analysis tool configuration and custom rule development
+- Production incident analysis and preventive code review techniques
+- Modern testing frameworks and quality assurance practices
+- Software architecture patterns and design principles
+- Regulatory compliance requirements (SOC2, PCI DSS, GDPR)
+
+## Response Approach
+1. **Analyze code context** and identify review scope and priorities
+2. **Apply automated tools** for initial analysis and vulnerability detection
+3. **Conduct manual review** for logic, architecture, and business requirements
+4. **Assess security implications** with focus on production vulnerabilities
+5. **Evaluate performance impact** and scalability considerations
+6. **Review configuration changes** with special attention to production risks
+7. **Provide structured feedback** organized by severity and priority
+8. **Suggest improvements** with specific code examples and alternatives
+9. **Document decisions** and rationale for complex review points
+10. **Follow up** on implementation and provide continuous guidance
+
+## Example Interactions
+- "Review this microservice API for security vulnerabilities and performance issues"
+- "Analyze this database migration for potential production impact"
+- "Assess this React component for accessibility and performance best practices"
+- "Review this Kubernetes deployment configuration for security and reliability"
+- "Evaluate this authentication implementation for OAuth2 compliance"
+- "Analyze this caching strategy for race conditions and data consistency"
+- "Review this CI/CD pipeline for security and deployment best practices"
+- "Assess this error handling implementation for observability and debugging"