@dragonflymcp/plugin 1.0.0

package/templates/synchronizations/archive/multi-verify.yaml.template

@@ -0,0 +1,346 @@
+# Multi-Agent Verification Synchronization Rules
+# Enables parallel verification agents for high-quality code review
+#
+# Based on research:
+# - Anthropic Multi-Agent Research: 90.2% improvement with orchestrator-worker
+# - Multi-agent consensus catches errors single agents miss
+# - Parallel verification for security, correctness, performance
+
+synchronizations:
+  # Parallel verification for high-risk implementations
+  - id: "high-risk-parallel-verify"
+    description: "Run multiple verification agents in parallel for high-risk code"
+    when:
+      concept: "implementation"
+      action: "generate"
+      status: "completed"
+    where:
+      query: "implementation.risk_level in ['high', 'critical'] OR architecture.risk != 'low'"
+    then:
+      parallel: true
+      actions:
+        - concept: "quality"
+          action: "review_security"
+          model: "sonnet"
+          inputs:
+            code: "${implementation.code}"
+            focus: "security"
+            checklist:
+              - "Input validation"
+              - "Authentication/authorization"
+              - "SQL injection"
+              - "XSS prevention"
+              - "Secrets handling"
+
+        - concept: "quality"
+          action: "review_correctness"
+          model: "sonnet"
+          inputs:
+            code: "${implementation.code}"
+            focus: "correctness"
+            checklist:
+              - "Logic errors"
+              - "Edge cases"
+              - "Error handling"
+              - "Type safety"
+              - "Contract compliance"
+
+        - concept: "quality"
+          action: "review_performance"
+          model: "sonnet"
+          inputs:
+            code: "${implementation.code}"
+            focus: "performance"
+            checklist:
+              - "Algorithm complexity"
+              - "Memory usage"
+              - "Database queries"
+              - "Network calls"
+              - "Caching opportunities"
+
+    slo_expectations:
+      expected_duration_ms: 10000
+      max_duration_ms: 60000
+      expected_cost_usd: 0.003
+      max_cost_usd: 0.01
+      success_rate_target: 0.95
+      on_timeout:
+        action: "warn"
+        continue: true
+      on_failure:
+        action: "escalate"
+        fallback: "Single-agent review"
+
+    provenance:
+      flow_id: "${flow.id}"
+      reason: "High-risk implementation requires multi-agent verification"
+
+  # Synthesize parallel review results
+  - id: "synthesize-parallel-reviews"
+    description: "Combine results from parallel verification agents"
+    when:
+      concept: "quality"
+      action: ["review_security", "review_correctness", "review_performance"]
+      status: "completed"
+    where:
+      query: "parallel.all_completed == true"
+    then:
+      - concept: "verification-synthesizer"
+        action: "synthesize"
+        model: "sonnet"
+        inputs:
+          security_review: "${parallel.review_security}"
+          correctness_review: "${parallel.review_correctness}"
+          performance_review: "${parallel.review_performance}"
+          require_consensus: true
+          threshold: 0.8
+
+    slo_expectations:
+      expected_duration_ms: 3000
+      max_duration_ms: 15000
+      expected_cost_usd: 0.001
+      max_cost_usd: 0.003
+      success_rate_target: 0.98
+      on_timeout:
+        action: "retry"
+        max_retries: 1
+      on_failure:
+        action: "escalate"
+
+    provenance:
+      flow_id: "${flow.id}"
+      reason: "Synthesizing parallel verification results"
+
+  # Handle consensus failure
+  - id: "consensus-failure"
+    description: "Escalate when verification agents disagree"
+    when:
+      concept: "verification-synthesizer"
+      action: "synthesize"
+      status: "completed"
+    where:
+      query: "synthesis.consensus_reached == false"
+    then:
+      - concept: "exploration"
+        action: "branch_explore"
+        model: "opus"
+        inputs:
+          problem: "Verification agents disagree on: ${synthesis.disagreements}"
+          constraints:
+            - "Must resolve disagreements"
+            - "Safety-critical issues take priority"
+          max_branches: 2
+
+    slo_expectations:
+      expected_duration_ms: 15000
+      max_duration_ms: 90000
+      expected_cost_usd: 0.02
+      max_cost_usd: 0.05
+      success_rate_target: 0.90
+      on_timeout:
+        action: "escalate"
+        message: "Consensus resolution timed out"
+
+    provenance:
+      flow_id: "${flow.id}"
+      reason: "Verification consensus not reached"
+
+  # Dual verification for API changes
+  - id: "api-change-dual-verify"
+    description: "Verify API changes from multiple perspectives"
+    when:
+      concept: "implementation"
+      action: "generate"
+      status: "completed"
+    where:
+      query: "implementation.changes_api == true"
+    then:
+      parallel: true
+      actions:
+        - concept: "quality"
+          action: "review_backwards_compatibility"
+          model: "sonnet"
+          inputs:
+            code: "${implementation.code}"
+            previous_api: "${implementation.previous_api}"
+            focus: "breaking_changes"
+
+        - concept: "quality"
+          action: "review_api_design"
+          model: "sonnet"
+          inputs:
+            code: "${implementation.code}"
+            focus: "api_quality"
+            checklist:
+              - "REST conventions"
+              - "Error responses"
+              - "Documentation"
+              - "Versioning"
+
+    slo_expectations:
+      expected_duration_ms: 8000
+      max_duration_ms: 30000
+      expected_cost_usd: 0.002
+      max_cost_usd: 0.006
+      success_rate_target: 0.95
+      on_timeout:
+        action: "warn"
+        continue: true
+
+    provenance:
+      flow_id: "${flow.id}"
+      reason: "API changes require compatibility and design verification"
+
+  # Database migration verification
+  - id: "migration-dual-verify"
+    description: "Verify database migrations for safety and performance"
+    when:
+      concept: "implementation"
+      action: "generate"
+      status: "completed"
+    where:
+      query: "implementation.includes_migration == true"
+    then:
+      parallel: true
+      actions:
+        - concept: "quality"
+          action: "review_migration_safety"
+          model: "sonnet"
+          inputs:
+            migration: "${implementation.migration}"
+            focus: "data_safety"
+            checklist:
+              - "Data loss prevention"
+              - "Rollback capability"
+              - "Constraint validity"
+
+        - concept: "quality"
+          action: "review_migration_performance"
+          model: "sonnet"
+          inputs:
+            migration: "${implementation.migration}"
+            focus: "performance"
+            checklist:
+              - "Lock duration"
+              - "Table size impact"
+              - "Index usage"
+
+    slo_expectations:
+      expected_duration_ms: 8000
+      max_duration_ms: 30000
+      expected_cost_usd: 0.002
+      max_cost_usd: 0.006
+      success_rate_target: 0.95
+      on_timeout:
+        action: "warn"
+        continue: true
+
+    provenance:
+      flow_id: "${flow.id}"
+      reason: "Database migrations require safety and performance verification"
+
+  # Self-verification (same model, different prompt)
+  - id: "self-verification"
+    description: "Verify implementation with different perspective"
+    when:
+      concept: "quality"
+      action: "review"
+      status: "completed"
+    where:
+      query: "review.confidence < 0.8"
+    then:
+      - concept: "quality"
+        action: "review"
+        model: "${review.model}"
+        inputs:
+          code: "${implementation.code}"
+          perspective: "devil_advocate"
+          previous_review: "${review.summary}"
+          instruction: "Find issues the previous review may have missed"
+
+    slo_expectations:
+      expected_duration_ms: 5000
+      max_duration_ms: 20000
+      expected_cost_usd: 0.001
+      max_cost_usd: 0.003
+      success_rate_target: 0.95
+      on_timeout:
+        action: "skip"
+        fallback: "Accept original review"
+
+    provenance:
+      flow_id: "${flow.id}"
+      reason: "Low confidence review triggers self-verification"
+
+  # Cross-model verification for critical code
+  - id: "critical-cross-model-verify"
+    description: "Use different models to verify critical code"
+    when:
+      concept: "implementation"
+      action: "generate"
+      status: "completed"
+    where:
+      query: "implementation.criticality == 'critical'"
+    then:
+      parallel: true
+      actions:
+        - concept: "quality"
+          action: "review"
+          model: "sonnet"
+          inputs:
+            code: "${implementation.code}"
+            depth: "thorough"
+
+        - concept: "quality"
+          action: "review"
+          model: "opus"
+          inputs:
+            code: "${implementation.code}"
+            depth: "thorough"
+            focus: "subtle_bugs"
+
+    slo_expectations:
+      expected_duration_ms: 15000
+      max_duration_ms: 60000
+      expected_cost_usd: 0.025
+      max_cost_usd: 0.06
+      success_rate_target: 0.95
+      on_timeout:
+        action: "warn"
+        continue: true
+
+    provenance:
+      flow_id: "${flow.id}"
+      reason: "Critical code verified by multiple models"
+
+  # Require unanimous approval for security-critical
+  - id: "security-unanimous-approval"
+    description: "Require all agents to approve security-critical changes"
+    when:
+      concept: "verification-synthesizer"
+      action: "synthesize"
+      status: "completed"
+    where:
+      query: "implementation.security_critical == true"
+    then:
+      - concept: "quality"
+        action: "check_unanimous"
+        model: "sonnet"
+        inputs:
+          reviews: "${synthesis.all_reviews}"
+          require: "all_approved"
+          on_failure: "block"
+
+    slo_expectations:
+      expected_duration_ms: 2000
+      max_duration_ms: 10000
+      expected_cost_usd: 0.0005
+      max_cost_usd: 0.002
+      success_rate_target: 0.99
+      on_timeout:
+        action: "block"
+        message: "Security verification timed out - blocking"
+
+    provenance:
+      flow_id: "${flow.id}"
+      reason: "Security-critical code requires unanimous approval"

package/templates/synchronizations/archive/planning-flow.yaml.template

@@ -0,0 +1,312 @@
+# Planning Flow Synchronizations
+# Integrates Chain-of-Thought planning into the workflow
+
+version: "1.0.0"
+description: |
+  Adds explicit planning phase before architecture for complex features.
+  Forces structured reasoning through Chain-of-Thought process.
+
+synchronizations:
+  # Complex story triggers planning before architecture
+  story-to-planning:
+    description: Create plan for complex stories before architecture
+    when:
+      concept: story
+      action: create
+      status: "completed"
+    where:
+      query: "story.status == 'ready' AND story.complexity == 'high'"
+    then:
+      concept: planning
+      action: create
+      model: sonnet
+      inputs:
+        context: "{{story.context}}"
+        objective: "{{story.title}}"
+        constraints: "{{story.constraints}}"
+        learnings: "{{active_learnings.architecture}}"
+    outputs:
+      path: "koan/plans/plan-{{id}}.yaml"
+    priority: high
+
+    # SLO Expectations for planning.create
+    slo_expectations:
+      expected_duration_ms: 15000      # 15 seconds for structured planning
+      max_duration_ms: 60000           # 1 minute timeout
+      expected_cost_usd: 0.003         # Sonnet for deep reasoning
+      max_cost_usd: 0.015              # Alert if exceeds
+      expected_context_tokens: 1500    # Story + constraints + learnings
+      max_context_tokens: 8000         # Warning threshold
+      success_rate_target: 0.90        # 90% of plans succeed
+
+      on_timeout:
+        action: "retry"
+        max_retries: 1
+        backoff_ms: 2000
+        on_exhausted: "escalate"
+
+      on_cost_exceeded:
+        action: "alert"
+        continue: true
+
+      on_context_exceeded:
+        action: "alert"
+        investigate: true
+
+  # Planning flows to architecture
+  planning-to-architecture:
+    description: Architecture design informed by plan
+    when:
+      concept: planning
+      action: create
+      status: "completed"
+    where:
+      query: "planning.status == 'ready' AND planning.blockers.length == 0"
+    then:
+      concept: architecture
+      action: design
+      model: opus
+      inputs:
+        story: "{{story}}"
+        plan: "{{planning}}"
+        recommended_approach: "{{planning.step_5_evaluation.recommendation}}"
+        constraints: "{{planning.step_2_constraints}}"
+        success_criteria: "{{planning.step_6_success_criteria}}"
+    outputs:
+      path: "koan/architecture/arch-{{id}}.yaml"
+    priority: high
+
+    # SLO Expectations for architecture.design (with Opus)
+    slo_expectations:
+      expected_duration_ms: 20000      # 20 seconds with Opus deep reasoning
+      max_duration_ms: 90000           # 90 seconds timeout
+      expected_cost_usd: 0.015         # Opus for complex architecture
+      max_cost_usd: 0.050              # Alert if exceeds
+      expected_context_tokens: 3000    # Story + plan + constraints
+      max_context_tokens: 15000        # Warning threshold
+      success_rate_target: 0.95        # 95% of architectures succeed
+
+      on_timeout:
+        action: "retry"
+        max_retries: 1
+        backoff_ms: 3000
+        on_exhausted: "escalate"
+
+      on_cost_exceeded:
+        action: "alert"
+        continue: true
+
+      on_context_exceeded:
+        action: "alert"
+        investigate: true
+
+  # Simple stories skip planning (existing rule)
+  story-to-arch-simple:
+    description: Direct architecture for simple stories
+    when:
+      concept: story
+      action: create
+      status: "completed"
+    where:
+      query: "story.status == 'ready' AND story.complexity != 'high'"
+    then:
+      concept: architecture
+      action: design
+      model: sonnet
+      inputs:
+        story: "{{story}}"
+    outputs:
+      path: "koan/architecture/arch-{{id}}.yaml"
+    priority: medium
+
+    # SLO Expectations for architecture.design (with Sonnet)
+    slo_expectations:
+      expected_duration_ms: 12000      # 12 seconds for simple stories
+      max_duration_ms: 60000           # 1 minute timeout
+      expected_cost_usd: 0.003         # Sonnet for standard architecture
+      max_cost_usd: 0.015              # Alert if exceeds
+      expected_context_tokens: 1100    # Story context only
+      max_context_tokens: 10000        # Warning threshold
+      success_rate_target: 0.95        # 95% of architectures succeed
+
+      on_timeout:
+        action: "retry"
+        max_retries: 1
+        backoff_ms: 2000
+        on_exhausted: "escalate"
+
+      on_cost_exceeded:
+        action: "alert"
+        continue: true
+
+      on_context_exceeded:
+        action: "alert"
+        investigate: true
+
+  # Planning blocked triggers clarification
+  planning-blocked:
+    description: Request clarification when planning is blocked
+    when:
+      concept: planning
+      action: create
+      status: "completed"
+    where:
+      query: "planning.status == 'blocked' OR planning.blockers.length > 0"
+    then:
+      concept: story
+      action: clarify
+      model: sonnet
+      inputs:
+        original_story: "{{story}}"
+        blockers: "{{planning.blockers}}"
+        clarifications_needed: "{{planning.step_3_unknowns.clarifications_needed}}"
+    outputs:
+      path: "koan/stories/story-{{id}}-clarification.yaml"
+    priority: high
+
+    # SLO Expectations for story.clarify
+    slo_expectations:
+      expected_duration_ms: 3000       # 3 seconds for clarification request
+      max_duration_ms: 20000           # 20 seconds timeout
+      expected_cost_usd: 0.000175      # Sonnet for simple task
+      max_cost_usd: 0.001              # Alert if exceeds
+      expected_context_tokens: 800     # Story + blockers
+      max_context_tokens: 3000         # Warning threshold
+      success_rate_target: 0.99        # 99% of clarifications succeed
+
+      on_timeout:
+        action: "retry"
+        max_retries: 2
+        backoff_ms: 1000
+        on_exhausted: "escalate"
+
+      on_cost_exceeded:
+        action: "alert"
+        continue: true
+
+      on_context_exceeded:
+        action: "alert"
+        investigate: true
+
+  # Complex architecture triggers Tree-of-Thoughts exploration
+  story-to-tree-of-thoughts:
+    description: |
+      Trigger Tree-of-Thoughts reasoning when architecture complexity is high,
+      multiple valid approaches exist, or risk assessment is needed.
+      Explores multiple reasoning paths before architecture design.
+    when:
+      concept: story
+      action: create
+      status: "completed"
+    where:
+      query: |
+        (story.status == 'ready') AND
+        (
+          (story.complexity == 'high' AND story.alternative_approaches.length >= 2) OR
+          (story.risk == 'high') OR
+          (story.tags contains 'architecture-decision') OR
+          (story.uncertainty == 'high')
+        )
+    then:
+      concept: tree-of-thoughts
+      action: explore
+      model: opus
+      inputs:
+        problem: "{{story.title}}"
+        context: "{{story.context}}"
+        constraints: "{{story.constraints}}"
+        success_criteria: "{{story.acceptance_criteria}}"
+        alternative_approaches: "{{story.alternative_approaches}}"
+        risk_factors: "{{story.risk_factors}}"
+      outputs:
+        path: "koan/tot/tot-{{id}}.yaml"
+      priority: high
+      slo_expectations:
+        expected_duration_ms: 45000  # Tree exploration can take 30-45 seconds
+        max_duration_ms: 90000
+        expected_cost_usd: 0.015  # Opus for deep reasoning
+        max_cost_usd: 0.050
+        success_rate_target: 0.92
+        on_timeout:
+          action: "retry"
+          max_retries: 2
+          on_exhausted: "escalate"
+
+  # Tree-of-Thoughts flows to architecture
+  tot-to-architecture:
+    description: Architecture design informed by Tree-of-Thoughts exploration
+    when:
+      concept: tree-of-thoughts
+      action: explore
+      status: "completed"
+    where:
+      query: "tot.status == 'complete' AND tot.selected_path != null"
+    then:
+      concept: architecture
+      action: design
+      model: opus
+      inputs:
+        story: "{{story}}"
+        selected_approach: "{{tot.selected_path}}"
+        exploration_rationale: "{{tot.rationale}}"
+        evaluated_alternatives: "{{tot.exploration.branches}}"
+        uncertainties: "{{tot.uncertainties}}"
+        constraints: "{{story.constraints}}"
+      outputs:
+        path: "koan/architecture/arch-{{id}}.yaml"
+      priority: high
+
+    # SLO Expectations for architecture.design (with Opus + ToT)
+    slo_expectations:
+      expected_duration_ms: 20000      # 20 seconds with Opus and ToT context
+      max_duration_ms: 90000           # 90 seconds timeout
+      expected_cost_usd: 0.015         # Opus for complex architecture
+      max_cost_usd: 0.050              # Alert if exceeds
+      expected_context_tokens: 4000    # Story + ToT exploration + alternatives
+      max_context_tokens: 20000        # Warning threshold
+      success_rate_target: 0.95        # 95% of architectures succeed
+
+      on_timeout:
+        action: "retry"
+        max_retries: 1
+        backoff_ms: 3000
+        on_exhausted: "escalate"
+
+      on_cost_exceeded:
+        action: "alert"
+        continue: true
+
+      on_context_exceeded:
+        action: "alert"
+        investigate: true
+
+# Complexity detection
+complexity_rules:
+  description: |
+    Rules for determining if a story requires planning phase.
+    Stories are marked as 'high' complexity if any of these apply:
+
+  criteria:
+    - name: multiple_systems
+      description: Story involves 3+ systems or services
+      query: "story.systems.length >= 3"
+
+    - name: security_sensitive
+      description: Story involves authentication, authorization, or sensitive data
+      query: "story.tags contains 'security' OR story.tags contains 'auth'"
+
+    - name: performance_critical
+      description: Story has specific performance requirements
+      query: "story.requirements.performance != null"
+
+    - name: integration_heavy
+      description: Story involves external API integrations
+      query: "story.integrations.length > 0"
+
+    - name: data_migration
+      description: Story involves data structure changes
+      query: "story.tags contains 'migration' OR story.tags contains 'schema-change'"
+
+    - name: high_risk
+      description: Story flagged as high risk
+      query: "story.risk == 'high'"