specweave 0.29.2 → 0.30.0

package/plugins/specweave/commands/specweave-costs.md

@@ -31,7 +31,7 @@ Display a comprehensive cost dashboard showing:
 ### 2. Load Cost Data
 
 ```typescript
-import { CostTracker } from '../core/cost-tracker';
+import { CostTracker } from '../core/cost/cost-tracker';
 import { CostReporter } from '../utils/cost-reporter';
 import fs from 'fs-extra';
 import path from 'path';
@@ -169,7 +169,7 @@ COST BY AGENT
 RECENT SESSIONS
 ───────────────────────────────────────────────────────────────
   2025-10-31 14:32:15
-  Agent: pm                  Model: sonnet
+  Agent: pm                  Model: opus
   Cost: $ 0.0150    Savings: $ 0.0350
 
   2025-10-31 13:15:42

package/plugins/specweave/commands/specweave-do.md

@@ -32,8 +32,8 @@ You are helping the user implement a SpecWeave increment by executing tasks from
 
 - `--model <tier>`: Optional. Override model selection for all tasks
   - `haiku`: Fast, cheap execution (3x faster, 20x cheaper than Sonnet)
-  - `sonnet`: Balanced quality and speed (default for complex tasks)
-  - `opus`: Maximum quality (rare, use only for critical decisions)
+  - `sonnet`: Balanced quality and speed
+  - `opus`: Maximum quality (default for all tasks)
   - If omitted, uses model hints from tasks.md (recommended)
 
 ---

package/plugins/specweave/hooks/lib/scheduler-startup.sh

@@ -1,7 +1,14 @@
 #!/bin/bash
-# scheduler-startup.sh - Check for due jobs on session start
-# Called from session-start hook to initialize scheduler
-set -e
+# scheduler-startup.sh - Execute due sync jobs on session start
+# Called from session-start hook to run overdue scheduled jobs
+#
+# This implements the "pragmatic hybrid" approach:
+# - No background daemon required
+# - Sync runs at Claude Code session boundaries
+# - Respects permission gates (canUpdateExternalItems, etc.)
+#
+# CRITICAL (v0.28.70): NEVER use 'set -e' in hooks - causes Claude Code crashes
+set +e
 
 # Skip if hooks disabled
 [[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
@@ -18,11 +25,14 @@ done
 # Paths
 SCHEDULED_JOBS_FILE="$PROJECT_ROOT/.specweave/state/scheduled-jobs.json"
 CONFIG_FILE="$PROJECT_ROOT/.specweave/config.json"
+LOG_FILE="$PROJECT_ROOT/.specweave/logs/scheduler.log"
+
+# Ensure logs directory exists
+mkdir -p "$PROJECT_ROOT/.specweave/logs" 2>/dev/null || true
 
 # Check if scheduler is enabled
 if [[ -f "$CONFIG_FILE" ]]; then
   # Check if sync.orchestration.scheduler.enabled is true
-  # Use node for reliable JSON parsing
   SCHEDULER_ENABLED=$(node -e "
     try {
       const config = require('$CONFIG_FILE');
@@ -36,6 +46,21 @@ if [[ -f "$CONFIG_FILE" ]]; then
   if [[ "$SCHEDULER_ENABLED" != "true" ]]; then
     exit 0
   fi
+
+  # Check autoSyncOnSessionStart (defaults to true)
+  AUTO_SYNC=$(node -e "
+    try {
+      const config = require('$CONFIG_FILE');
+      const auto = config?.sync?.orchestration?.scheduler?.autoSyncOnSessionStart ?? true;
+      console.log(auto ? 'true' : 'false');
+    } catch(e) {
+      console.log('true');
+    }
+  " 2>/dev/null || echo "true")
+
+  if [[ "$AUTO_SYNC" != "true" ]]; then
+    exit 0
+  fi
 fi
 
 # Check if scheduled jobs file exists
@@ -65,8 +90,34 @@ if [[ "$DUE_JOBS" == "[]" ]]; then
   exit 0
 fi
 
-# Log due jobs (for debugging)
-echo "📅 Due sync jobs: $DUE_JOBS" >> "$PROJECT_ROOT/.specweave/logs/scheduler.log" 2>/dev/null || true
+# Log due jobs
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+echo "[$TIMESTAMP] Session start - due jobs: $DUE_JOBS" >> "$LOG_FILE" 2>/dev/null || true
+
+# Execute due sync jobs using the TypeScript executor
+# Run in background to avoid blocking session start
+RESULT=$(node -e "
+  const { executeSessionSync } = require('$PROJECT_ROOT/node_modules/specweave/dist/core/scheduler/session-sync-executor.js');
+  executeSessionSync('$PROJECT_ROOT', { silent: false })
+    .then(r => console.log(r))
+    .catch(e => console.log(JSON.stringify({ error: e.message })));
+" 2>&1) || RESULT='{"error":"Executor not found"}'
+
+# Log result
+echo "[$TIMESTAMP] Execution result: $RESULT" >> "$LOG_FILE" 2>/dev/null || true
 
-# Output status (will be captured by hook system)
-echo "{\"continue\": true, \"systemMessage\": \"📅 Scheduled sync jobs ready to run. Use /specweave:sync-now to execute.\"}"
+# Parse result for system message
+EXECUTED_COUNT=$(echo "$RESULT" | node -e "
+  const data = JSON.parse(require('fs').readFileSync('/dev/stdin', 'utf-8'));
+  console.log(data.executedCount || 0);
+" 2>/dev/null || echo "0")
+
+SUCCESS_COUNT=$(echo "$RESULT" | node -e "
+  const data = JSON.parse(require('fs').readFileSync('/dev/stdin', 'utf-8'));
+  console.log(data.successCount || 0);
+" 2>/dev/null || echo "0")
+
+# Output status message if jobs were executed
+if [[ "$EXECUTED_COUNT" != "0" ]]; then
+  echo "{\"continue\": true, \"systemMessage\": \"📅 Session sync: $SUCCESS_COUNT/$EXECUTED_COUNT sync jobs executed successfully.\"}"
+fi

package/plugins/specweave/skills/code-reviewer/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: code-reviewer
 description: Code review expert for security vulnerabilities, performance, and best practices. Activates for review code, code review, security review, PR review, pull request review, check my code, code quality, vulnerability scan, OWASP, code analysis, static analysis.
-model: claude-sonnet-4-5-20250929
+model: claude-opus-4-5-20251101
 ---
 
 You are an elite code review expert specializing in modern code analysis techniques, AI-powered review tools, and production-grade quality assurance.

package/plugins/specweave/skills/role-orchestrator/README.md

@@ -2,7 +2,7 @@
 
 **Status**: To be developed
 **Priority**: CRITICAL (Highest priority)
-**Claude Model**: Sonnet (reasoning + efficiency)
+**Claude Model**: Opus 4.5 (best reasoning + quality)
 
 ## Purpose
 

package/plugins/specweave-ado/agents/ado-manager/AGENT.md

@@ -1,15 +1,21 @@
 ---
 name: ado-manager
+description: Azure DevOps integration specialist. Expert in ADO REST API, work item management, and SpecWeave increment synchronization. Handles Epics, Features, User Stories, bidirectional sync, and rate limiting.
 role: Azure DevOps Integration Specialist
 context: |
   You are an expert in Azure DevOps (ADO) REST API integration, work item management, and SpecWeave increment synchronization.
-  
+
   Your responsibilities:
   - Create and manage ADO work items (Epics, Features, User Stories)
   - Sync SpecWeave increment progress to ADO
   - Handle bidirectional sync (ADO ↔ SpecWeave)
   - Troubleshoot ADO API issues
   - Optimize sync performance and rate limiting
+model: claude-opus-4-5-20251101
+model_preference: opus
+cost_profile: execution
+fallback_behavior: flexible
+max_response_tokens: 2000
 ---
 
 ## 🚀 How to Invoke This Agent
@@ -22,7 +28,7 @@ context: |
 Task({
   subagent_type: "specweave-ado:ado-manager:ado-manager",
   prompt: "Your task description here",
-  model: "haiku" // optional: haiku, sonnet, opus
+  model: "opus" // default: opus (best quality)
 });
 ```
 

package/plugins/specweave-ado/agents/ado-multi-project-mapper/AGENT.md

@@ -2,7 +2,7 @@
 name: ado-multi-project-mapper
 description: Expert in mapping SpecWeave specs to multiple Azure DevOps projects with intelligent project detection and cross-project coordination. Handles project-per-team, area-path-based, and team-based strategies. Manages bidirectional sync across multiple projects.
 tools: Read, Write, Edit, Bash, Glob
-model: claude-sonnet-4-5-20250929
+model: claude-opus-4-5-20251101
 ---
 
 ## 🚀 How to Invoke This Agent
@@ -15,7 +15,7 @@ model: claude-sonnet-4-5-20250929
 Task({
   subagent_type: "specweave-ado:ado-multi-project-mapper:ado-multi-project-mapper",
   prompt: "Your task description here",
-  model: "haiku" // optional: haiku, sonnet, opus
+  model: "opus" // default: opus (best quality)
 });
 ```
 

package/plugins/specweave-ado/agents/ado-sync-judge/AGENT.md

@@ -2,7 +2,7 @@
 name: ado-sync-judge
 description: LLM Judge for verifying Azure DevOps synchronization correctness, conflict resolution, and lifecycle management. Validates that external tool status wins, increments complete strictly, and specs sync flexibly.
 tools: Read, Grep, Bash
-model: claude-sonnet-4-5-20250929
+model: claude-opus-4-5-20251101
 ---
 
 ## 🚀 How to Invoke This Agent
@@ -15,7 +15,7 @@ model: claude-sonnet-4-5-20250929
 Task({
   subagent_type: "specweave-ado:ado-sync-judge:ado-sync-judge",
   prompt: "Your task description here",
-  model: "haiku" // optional: haiku, sonnet, opus
+  model: "opus" // default: opus (best quality)
 });
 ```
 

package/plugins/specweave-ado/lib/ado-spec-commit-sync.d.ts

@@ -6,7 +6,7 @@
  */
 import { AdoClientV2 } from './ado-client-v2.js';
 import { GitCommit, GitRepository } from '../../../src/utils/git-utils.js';
-import { UserStory } from '../../../src/core/spec-task-mapper.js';
+import { UserStory } from '../../../src/core/specs/spec-task-mapper.js';
 export interface SyncOptions {
     incrementPath: string;
     dryRun?: boolean;

package/plugins/specweave-ado/lib/ado-spec-commit-sync.js

@@ -9,7 +9,7 @@ import {
 import {
   getSpecTaskMapping,
   getCompletedUserStories
-} from "../../../src/core/spec-task-mapper.js";
+} from "../../../src/core/specs/spec-task-mapper.js";
 import {
   buildUserStoryComment,
   buildCommitBatchComment,

package/plugins/specweave-ado/lib/ado-spec-commit-sync.ts

@@ -22,7 +22,7 @@ import {
   getCompletedUserStories,
   SpecTaskMapping,
   UserStory,
-} from '../../../src/core/spec-task-mapper.js';
+} from '../../../src/core/specs/spec-task-mapper.js';
 import {
   buildUserStoryComment,
   buildCommitBatchComment,

package/plugins/specweave-ado/lib/ado-spec-content-sync.js

@@ -3,7 +3,7 @@ import {
   detectContentChanges,
   hasExternalLink,
   updateSpecWithExternalLink
-} from "../../../src/core/spec-content-sync.js";
+} from "../../../src/core/specs/spec-content-sync.js";
 import { SpecIncrementMapper } from "../../../src/core/sync/spec-increment-mapper.js";
 import * as path from "path";
 import * as fs from "fs/promises";

package/plugins/specweave-ado/lib/ado-spec-content-sync.ts

@@ -18,7 +18,7 @@ import {
   updateSpecWithExternalLink,
   SpecContent,
   ContentSyncResult,
-} from '../../../src/core/spec-content-sync.js';
+} from '../../../src/core/specs/spec-content-sync.js';
 import { SyncProfile } from '../../../src/core/types/sync-profile.js';
 import { SpecIncrementMapper, TaskInfo } from '../../../src/core/sync/spec-increment-mapper.js';
 import * as path from 'path';

package/plugins/specweave-ado/lib/conflict-resolver.js

@@ -97,6 +97,93 @@ class ConflictResolver {
     this.resolutionLog.push(resolution);
     return resolution;
   }
+  /**
+   * Compare timestamps to determine winner (Increment 0089)
+   *
+   * For pull sync, we compare local lastModified vs external ChangedDate.
+   * The more recent timestamp wins.
+   *
+   * @param localTimestamp - Local file lastModified timestamp (ISO string or null)
+   * @param externalTimestamp - External tool ChangedDate (ISO string)
+   * @returns Comparison result with winner and reasoning
+   */
+  compareTimestamps(localTimestamp, externalTimestamp) {
+    const externalDate = new Date(externalTimestamp);
+    if (!localTimestamp) {
+      return {
+        winner: "external",
+        localTimestamp: null,
+        externalTimestamp,
+        timeDiffMs: 0,
+        reason: "No local timestamp available, external wins by default"
+      };
+    }
+    const localDate = new Date(localTimestamp);
+    const timeDiffMs = externalDate.getTime() - localDate.getTime();
+    if (timeDiffMs > 0) {
+      console.log(`\u{1F4CA} Timestamp Comparison:`);
+      console.log(`   Local:    ${localTimestamp}`);
+      console.log(`   External: ${externalTimestamp}`);
+      console.log(`   \u2705 Winner: EXTERNAL (${Math.round(timeDiffMs / 6e4)}min newer)`);
+      return {
+        winner: "external",
+        localTimestamp,
+        externalTimestamp,
+        timeDiffMs,
+        reason: `External is ${Math.round(timeDiffMs / 6e4)} minutes newer`
+      };
+    }
+    if (timeDiffMs < 0) {
+      console.log(`\u{1F4CA} Timestamp Comparison:`);
+      console.log(`   Local:    ${localTimestamp}`);
+      console.log(`   External: ${externalTimestamp}`);
+      console.log(`   \u2705 Winner: LOCAL (${Math.round(Math.abs(timeDiffMs) / 6e4)}min newer)`);
+      return {
+        winner: "local",
+        localTimestamp,
+        externalTimestamp,
+        timeDiffMs,
+        reason: `Local is ${Math.round(Math.abs(timeDiffMs) / 6e4)} minutes newer`
+      };
+    }
+    return {
+      winner: "none",
+      localTimestamp,
+      externalTimestamp,
+      timeDiffMs: 0,
+      reason: "Timestamps are identical, no conflict"
+    };
+  }
+  /**
+   * Resolve conflict using timestamp comparison (Increment 0089)
+   *
+   * Combines timestamp comparison with status conflict resolution.
+   * Used by ExternalChangePuller for pull sync.
+   *
+   * @param field - The field being compared (e.g., 'status')
+   * @param localValue - Current local value
+   * @param externalValue - Value from external tool
+   * @param localTimestamp - Local lastModified timestamp
+   * @param externalTimestamp - External ChangedDate
+   * @returns Conflict resolution result
+   */
+  resolveWithTimestamp(field, localValue, externalValue, localTimestamp, externalTimestamp) {
+    const comparison = this.compareTimestamps(localTimestamp, externalTimestamp);
+    const resolution = {
+      field,
+      localValue,
+      externalValue,
+      resolution: comparison.winner === "local" ? "local" : "external",
+      resolvedValue: comparison.winner === "local" ? localValue : externalValue,
+      reason: comparison.reason,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    console.log(`\u{1F4CA} Conflict Resolved (${field}):`);
+    console.log(`   Winner: ${comparison.winner.toUpperCase()}`);
+    console.log(`   Reason: ${comparison.reason}`);
+    this.resolutionLog.push(resolution);
+    return resolution;
+  }
   /**
    * Resolve priority conflict - EXTERNAL WINS
    */

package/plugins/specweave-ado/lib/conflict-resolver.ts

@@ -24,6 +24,17 @@ export interface ConflictResolution {
   timestamp: string;
 }
 
+/**
+ * Timestamp comparison result for pull sync (Increment 0089)
+ */
+export interface TimestampComparisonResult {
+  winner: 'local' | 'external' | 'none';
+  localTimestamp: string | null;
+  externalTimestamp: string;
+  timeDiffMs: number;
+  reason: string;
+}
+
 export interface SpecMetadata {
   id: string;
   title: string;
@@ -183,6 +194,119 @@ export class ConflictResolver {
     return resolution;
   }
 
+  /**
+   * Compare timestamps to determine winner (Increment 0089)
+   *
+   * For pull sync, we compare local lastModified vs external ChangedDate.
+   * The more recent timestamp wins.
+   *
+   * @param localTimestamp - Local file lastModified timestamp (ISO string or null)
+   * @param externalTimestamp - External tool ChangedDate (ISO string)
+   * @returns Comparison result with winner and reasoning
+   */
+  public compareTimestamps(
+    localTimestamp: string | null,
+    externalTimestamp: string
+  ): TimestampComparisonResult {
+    const externalDate = new Date(externalTimestamp);
+
+    // If no local timestamp, external wins by default
+    if (!localTimestamp) {
+      return {
+        winner: 'external',
+        localTimestamp: null,
+        externalTimestamp,
+        timeDiffMs: 0,
+        reason: 'No local timestamp available, external wins by default',
+      };
+    }
+
+    const localDate = new Date(localTimestamp);
+    const timeDiffMs = externalDate.getTime() - localDate.getTime();
+
+    // External is more recent → external wins
+    if (timeDiffMs > 0) {
+      console.log(`📊 Timestamp Comparison:`);
+      console.log(`   Local:    ${localTimestamp}`);
+      console.log(`   External: ${externalTimestamp}`);
+      console.log(`   ✅ Winner: EXTERNAL (${Math.round(timeDiffMs / 60000)}min newer)`);
+
+      return {
+        winner: 'external',
+        localTimestamp,
+        externalTimestamp,
+        timeDiffMs,
+        reason: `External is ${Math.round(timeDiffMs / 60000)} minutes newer`,
+      };
+    }
+
+    // Local is more recent → local wins (don't overwrite local changes)
+    if (timeDiffMs < 0) {
+      console.log(`📊 Timestamp Comparison:`);
+      console.log(`   Local:    ${localTimestamp}`);
+      console.log(`   External: ${externalTimestamp}`);
+      console.log(`   ✅ Winner: LOCAL (${Math.round(Math.abs(timeDiffMs) / 60000)}min newer)`);
+
+      return {
+        winner: 'local',
+        localTimestamp,
+        externalTimestamp,
+        timeDiffMs,
+        reason: `Local is ${Math.round(Math.abs(timeDiffMs) / 60000)} minutes newer`,
+      };
+    }
+
+    // Same timestamp → no conflict
+    return {
+      winner: 'none',
+      localTimestamp,
+      externalTimestamp,
+      timeDiffMs: 0,
+      reason: 'Timestamps are identical, no conflict',
+    };
+  }
+
+  /**
+   * Resolve conflict using timestamp comparison (Increment 0089)
+   *
+   * Combines timestamp comparison with status conflict resolution.
+   * Used by ExternalChangePuller for pull sync.
+   *
+   * @param field - The field being compared (e.g., 'status')
+   * @param localValue - Current local value
+   * @param externalValue - Value from external tool
+   * @param localTimestamp - Local lastModified timestamp
+   * @param externalTimestamp - External ChangedDate
+   * @returns Conflict resolution result
+   */
+  public resolveWithTimestamp(
+    field: string,
+    localValue: any,
+    externalValue: any,
+    localTimestamp: string | null,
+    externalTimestamp: string
+  ): ConflictResolution {
+    const comparison = this.compareTimestamps(localTimestamp, externalTimestamp);
+
+    const resolution: ConflictResolution = {
+      field,
+      localValue,
+      externalValue,
+      resolution: comparison.winner === 'local' ? 'local' : 'external',
+      resolvedValue: comparison.winner === 'local' ? localValue : externalValue,
+      reason: comparison.reason,
+      timestamp: new Date().toISOString(),
+    };
+
+    // Log the resolution
+    console.log(`📊 Conflict Resolved (${field}):`);
+    console.log(`   Winner: ${comparison.winner.toUpperCase()}`);
+    console.log(`   Reason: ${comparison.reason}`);
+
+    this.resolutionLog.push(resolution);
+    return resolution;
+  }
+
   /**
    * Resolve priority conflict - EXTERNAL WINS
    */

package/plugins/specweave-ado/skills/specweave-ado-mapper/SKILL.md

@@ -2,7 +2,7 @@
 name: specweave-ado-mapper
 description: Expert in bidirectional conversion between SpecWeave increments and Azure DevOps (ADO) Epics/Features/User Stories/Tasks. Handles export (increment → ADO), import (ADO → increment), and bidirectional sync with conflict resolution. Activates for ADO sync, Azure DevOps sync, work item creation, import from ADO.
 tools: Read, Write, Edit, Bash
-model: claude-sonnet-4-5-20250929
+model: claude-opus-4-5-20251101
 ---
 
 # Specweave Ado Mapper Skill

package/plugins/specweave-backend/agents/database-optimizer/AGENT.md

@@ -1,8 +1,8 @@
 ---
 name: database-optimizer
 description: Expert database optimizer specializing in modern performance tuning, query optimization, and scalable architectures. Masters advanced indexing, N+1 resolution, multi-tier caching, partitioning strategies, and cloud database optimization. Handles complex query analysis, migration strategies, and performance monitoring. Use PROACTIVELY for database optimization, performance issues, or scalability challenges.
-model: claude-haiku-4-5-20251001
-model_preference: sonnet
+model: claude-opus-4-5-20251101
+model_preference: opus
 cost_profile: planning
 fallback_behavior: strict
 ---
@@ -17,7 +17,7 @@ fallback_behavior: strict
 Task({
   subagent_type: "specweave-backend:database-optimizer:database-optimizer",
   prompt: "Your task description here",
-  model: "haiku" // optional: haiku, sonnet, opus
+  model: "opus" // default: opus (best quality)
 });
 ```
 

package/plugins/specweave-backend/skills/dotnet-backend/SKILL.md

@@ -2,7 +2,7 @@
 name: dotnet-backend
 description: .NET/C# backend developer for ASP.NET Core APIs with Entity Framework Core. Builds REST APIs, minimal APIs, gRPC services, authentication with Identity/JWT, authorization, database operations, background services, SignalR real-time features. Activates for: .NET, C#, ASP.NET Core, Entity Framework Core, EF Core, .NET Core, minimal API, Web API, gRPC, authentication .NET, Identity, JWT .NET, authorization, LINQ, async/await C#, background service, IHostedService, SignalR, SQL Server, PostgreSQL .NET, dependency injection, middleware .NET.
 tools: Read, Write, Edit, Bash
-model: claude-sonnet-4-5-20250929
+model: claude-opus-4-5-20251101
 ---
 
 # .NET Backend Agent - ASP.NET Core & Enterprise API Expert

package/plugins/specweave-backend/skills/nodejs-backend/SKILL.md

@@ -2,7 +2,7 @@
 name: nodejs-backend
 description: Node.js/TypeScript backend developer. Builds Express.js, Fastify, NestJS APIs with Prisma ORM, TypeORM, Mongoose. Implements REST APIs, GraphQL, authentication (JWT, session, OAuth), authorization, database operations, background jobs, WebSockets, real-time features, API validation, error handling, middleware. Activates for: Node.js, NodeJS, Express, Fastify, NestJS, TypeScript backend, API, REST API, GraphQL, Prisma, TypeORM, Mongoose, MongoDB, PostgreSQL with Node, MySQL with Node, authentication backend, JWT, passport.js, bcrypt, async/await, promises, middleware, error handling, validation, Zod, class-validator, background jobs, Bull, BullMQ, Redis, WebSocket, Socket.io, real-time.
 tools: Read, Write, Edit, Bash
-model: claude-sonnet-4-5-20250929
+model: claude-opus-4-5-20251101
 ---
 
 # Node.js Backend Agent - API & Server Development Expert

package/plugins/specweave-backend/skills/python-backend/SKILL.md

@@ -2,7 +2,7 @@
 name: python-backend
 description: Python backend developer for FastAPI, Django, Flask APIs with SQLAlchemy, Django ORM, Pydantic validation. Implements REST APIs, async operations, database integration, authentication, data processing with pandas/numpy, machine learning integration, background tasks with Celery, API documentation with OpenAPI/Swagger. Activates for: Python, Python backend, FastAPI, Django, Flask, SQLAlchemy, Django ORM, Pydantic, async Python, asyncio, uvicorn, REST API Python, authentication Python, pandas, numpy, data processing, machine learning, ML API, Celery, Redis Python, PostgreSQL Python, MongoDB Python, type hints, Python typing.
 tools: Read, Write, Edit, Bash
-model: claude-sonnet-4-5-20250929
+model: claude-opus-4-5-20251101
 ---
 
 # Python Backend Agent - API & Data Processing Expert

package/plugins/specweave-confluent/agents/confluent-architect/AGENT.md

@@ -1,6 +1,11 @@
 ---
 name: confluent-architect
 description: Confluent Cloud architecture specialist. Expert in eCKU sizing, cluster linking, multi-region strategies, Schema Registry HA, ksqlDB deployment, Stream Governance, and cost optimization. Activates for confluent cloud architecture, ecku sizing, cluster linking, multi-region kafka, schema registry ha, stream governance, cost optimization.
+model: claude-opus-4-5-20251101
+model_preference: opus
+cost_profile: planning
+fallback_behavior: strict
+max_response_tokens: 2000
 ---
 
 ## 🚀 How to Invoke This Agent
@@ -13,7 +18,7 @@ description: Confluent Cloud architecture specialist. Expert in eCKU sizing, clu
 Task({
   subagent_type: "specweave-confluent:confluent-architect:confluent-architect",
   prompt: "Your task description here",
-  model: "haiku" // optional: haiku, sonnet, opus
+  model: "opus" // default: opus (best quality)
 });
 ```
 

package/plugins/specweave-diagrams/agents/diagrams-architect/AGENT.md

@@ -2,7 +2,7 @@
 name: diagrams-architect
 description: Expert in creating Mermaid diagrams following C4 Model conventions. Generates C4 Context/Container/Component diagrams, sequence diagrams, ER diagrams, and deployment diagrams with correct syntax and placement.
 tools: Read, Write, Edit
-model: claude-sonnet-4-5-20250929
+model: claude-opus-4-5-20251101
 model_preference: auto
 cost_profile: hybrid
 fallback_behavior: auto
@@ -18,7 +18,7 @@ fallback_behavior: auto
 Task({
   subagent_type: "specweave-diagrams:diagrams-architect:diagrams-architect",
   prompt: "Your task description here",
-  model: "haiku" // optional: haiku, sonnet, opus
+  model: "opus" // default: opus (best quality)
 });
 ```
 

package/plugins/specweave-diagrams/skills/diagrams-architect/SKILL.md

@@ -2,7 +2,7 @@
 name: diagrams-architect
 description: Expert in creating Mermaid diagrams following C4 Model and SpecWeave conventions. Specializes in system architecture, sequence diagrams, ER diagrams, and deployment diagrams. Activates for diagram creation, architecture visualization, data modeling, sequence flows, C4 diagrams, HLD, LLD.
 tools: Read, Write, Edit
-model: claude-sonnet-4-5-20250929
+model: claude-opus-4-5-20251101
 ---
 
 # Diagrams Architect Skill

package/plugins/specweave-frontend/agents/frontend-architect/AGENT.md

@@ -8,6 +8,10 @@ tools:
   - Bash
   - Glob
   - Grep
+model: claude-opus-4-5-20251101
+model_preference: opus
+cost_profile: planning
+fallback_behavior: strict
 max_response_tokens: 2000
 ---
 

package/plugins/specweave-github/agents/github-manager/AGENT.md

@@ -52,7 +52,7 @@ GitHub issues MUST use living docs format:
 Task({
   subagent_type: "specweave-github:github-manager:SpecWeave Sync",
   prompt: "Your task description here",
-  model: "haiku" // optional: haiku, sonnet, opus
+  model: "opus" // default: opus (best quality)
 });
 ```
 

package/plugins/specweave-github/agents/github-task-splitter/AGENT.md

@@ -1,3 +1,13 @@
+---
+name: github-task-splitter
+description: Expert agent for splitting SpecWeave tasks across multiple GitHub repositories based on architecture patterns. Analyzes task dependencies across services and creates tracking issues in multiple repositories for multi-repo architectures.
+model: claude-opus-4-5-20251101
+model_preference: opus
+cost_profile: planning
+fallback_behavior: strict
+max_response_tokens: 2000
+---
+
 # GitHub Task Splitter Agent
 
 Expert agent for splitting SpecWeave tasks across multiple GitHub repositories based on architecture patterns.
@@ -12,7 +22,7 @@ Expert agent for splitting SpecWeave tasks across multiple GitHub repositories b
 Task({
   subagent_type: "specweave-github:github-task-splitter:github-task-splitter",
   prompt: "Split tasks for increment 0015-shopping-cart across frontend, backend, and shared repositories",
-  model: "haiku" // optional: haiku, sonnet, opus
+  model: "opus" // default: opus (best quality)
 });
 ```