/============================================================================/ /* WHEN-ORCHESTRATING-SWARM-USE-SWARM-ORCHESTRATION SKILL :: VERILINGUA x VERIX EDITION / /============================================================================*/

name: when-orchestrating-swarm-use-swarm-orchestration version: 1.0.0 description: | [assert|neutral] Complex multi-agent swarm orchestration with task decomposition, distributed execution, and result synthesis [ground:given] [conf:0.95] [state:confirmed] category: workflow tags:

• swarm
• orchestration
• coordination
• task-decomposition
• result-synthesis author: ruv cognitive_frame: primary: evidential goal_analysis: first_order: "Execute when-orchestrating-swarm-use-swarm-orchestration workflow" second_order: "Ensure quality and consistency" third_order: "Enable systematic workflow processes"

/----------------------------------------------------------------------------/ /* S0 META-IDENTITY / /----------------------------------------------------------------------------*/

[define|neutral] SKILL := { name: "when-orchestrating-swarm-use-swarm-orchestration", category: "workflow", version: "1.0.0", layer: L1 } [ground:given] [conf:1.0] [state:confirmed]

/----------------------------------------------------------------------------/ /* S1 COGNITIVE FRAME / /----------------------------------------------------------------------------*/

[define|neutral] COGNITIVE_FRAME := { frame: "Evidential", source: "Turkish", force: "How do you know?" } [ground:cognitive-science] [conf:0.92] [state:confirmed]

Kanitsal Cerceve (Evidential Frame Activation)

Kaynak dogrulama modu etkin.

/----------------------------------------------------------------------------/ /* S2 TRIGGER CONDITIONS / /----------------------------------------------------------------------------*/

[define|neutral] TRIGGER_POSITIVE := { keywords: ["when-orchestrating-swarm-use-swarm-orchestration", "workflow", "workflow"], context: "user needs when-orchestrating-swarm-use-swarm-orchestration capability" } [ground:given] [conf:1.0] [state:confirmed]

/----------------------------------------------------------------------------/ /* S3 CORE CONTENT / /----------------------------------------------------------------------------*/

Orchestration Skill Guidelines

When to Use This Skill

• Parallel multi-agent execution requiring concurrent task processing
• Complex implementation with 6+ independent tasks
• Theater-free development requiring 0% tolerance validation
• Dynamic agent selection from 86+ agent registry
• High-quality delivery needing Byzantine consensus validation

When NOT to Use This Skill

• Single-agent tasks with no parallelization benefit
• Simple sequential work completing in <2 hours
• Planning phase (use research-driven-planning first)
• Trivial changes to single files

Success Criteria

• [assert|neutral] Agent+skill matrix generated* with optimal assignments [ground:acceptance-criteria] [conf:0.90] [state:provisional]
• [assert|neutral] Parallel execution successful* with 8.3x speedup achieved [ground:acceptance-criteria] [conf:0.90] [state:provisional]
• [assert|neutral] Theater detection passes* with 0% theater detected [ground:acceptance-criteria] [conf:0.90] [state:provisional]
• [assert|neutral] Integration tests pass* at 100% rate [ground:acceptance-criteria] [conf:0.90] [state:provisional]
• [assert|neutral] All agents complete* with no orphaned workers [ground:acceptance-criteria] [conf:0.90] [state:provisional]

Edge Cases to Handle

• Agent failures - Implement agent health monitoring and replacement
• Task timeout - Configure per-task timeout with escalation
• Consensus failure - Have fallback from Byzantine to weighted consensus
• Resource exhaustion - Limit max parallel agents, queue excess
• Conflicting outputs - Implement merge conflict resolution strategy

Guardrails (NEVER Violate)

• [assert|emphatic] NEVER: lose agent state** - Persist agent progress to memory continuously [ground:policy] [conf:0.98] [state:confirmed]
• [assert|neutral] ALWAYS: track swarm health** - Monitor all agent statuses in real-time [ground:policy] [conf:0.98] [state:confirmed]
• [assert|neutral] ALWAYS: validate consensus** - Require 4/5 agreement for theater detection [ground:policy] [conf:0.98] [state:confirmed]
• [assert|emphatic] NEVER: skip theater audit** - Zero tolerance, any theater blocks merge [ground:policy] [conf:0.98] [state:confirmed]
• [assert|neutral] ALWAYS: cleanup workers** - Terminate agents on completion/failure [ground:policy] [conf:0.98] [state:confirmed]

Evidence-Based Validation

• Check all agent statuses - Verify each agent completed successfully
• Validate parallel execution - Confirm tasks ran concurrently, not sequentially
• Measure speedup - Calculate actual speedup vs sequential baseline
• Audit theater detection - Run 6-agent consensus, verify 0% detection
• Verify integration - Execute sandbox tests, confirm 100% pass rate

Swarm Orchestration SOP

Kanitsal Cerceve (Evidential Frame Activation)

Kaynak dogrulama modu etkin.

Overview

This skill implements complex multi-agent swarm orchestration with intelligent task decomposition, distributed execution, progress monitoring, and result synthesis. It enables coordinated execution of complex workflows across multiple specialized agents.

Agents & Responsibilities

task-orchestrator

Role: Central orchestration and task decomposition Responsibilities:

• Decompose complex tasks into subtasks
• Assign tasks to appropriate agents
• Monitor execution progress
• Synthesize results from multiple agents

hierarchical-coordinator

Role: Hierarchical task delegation and coordination Responsibilities:

• Manage task hierarchy
• Coordinate parent-child task relationships
• Handle task dependencies
• Ensure proper execution order

adaptive-coordinator

Role: Dynamic workload balancing and optimization Responsibilities:

• Monitor agent workloads
• Rebalance task assignments
• Optimize resource allocation
• Adapt to changing conditions

Phase 1: Plan Orchestration

Objective

Analyze complex task requirements and cr

/----------------------------------------------------------------------------/ /* S4 SUCCESS CRITERIA / /----------------------------------------------------------------------------*/

[define|neutral] SUCCESS_CRITERIA := { primary: "Skill execution completes successfully", quality: "Output meets quality thresholds", verification: "Results validated against requirements" } [ground:given] [conf:1.0] [state:confirmed]

/----------------------------------------------------------------------------/ /* S5 MCP INTEGRATION / /----------------------------------------------------------------------------*/

[define|neutral] MCP_INTEGRATION := { memory_mcp: "Store execution results and patterns", tools: ["mcp__memory-mcp__memory_store", "mcp__memory-mcp__vector_search"] } [ground:witnessed:mcp-config] [conf:0.95] [state:confirmed]

/----------------------------------------------------------------------------/ /* S6 MEMORY NAMESPACE / /----------------------------------------------------------------------------*/

[define|neutral] MEMORY_NAMESPACE := { pattern: "skills/workflow/when-orchestrating-swarm-use-swarm-orchestration/{project}/{timestamp}", store: ["executions", "decisions", "patterns"], retrieve: ["similar_tasks", "proven_patterns"] } [ground:system-policy] [conf:1.0] [state:confirmed]

[define|neutral] MEMORY_TAGGING := { WHO: "when-orchestrating-swarm-use-swarm-orchestration-{session_id}", WHEN: "ISO8601_timestamp", PROJECT: "{project_name}", WHY: "skill-execution" } [ground:system-policy] [conf:1.0] [state:confirmed]

/----------------------------------------------------------------------------/ /* S7 SKILL COMPLETION VERIFICATION / /----------------------------------------------------------------------------*/

[direct|emphatic] COMPLETION_CHECKLIST := { agent_spawning: "Spawn agents via Task()", registry_validation: "Use registry agents only", todowrite_called: "Track progress with TodoWrite", work_delegation: "Delegate to specialized agents" } [ground:system-policy] [conf:1.0] [state:confirmed]

/----------------------------------------------------------------------------/ /* S8 ABSOLUTE RULES / /----------------------------------------------------------------------------*/

[direct|emphatic] RULE_NO_UNICODE := forall(output): NOT(unicode_outside_ascii) [ground:windows-compatibility] [conf:1.0] [state:confirmed]

[direct|emphatic] RULE_EVIDENCE := forall(claim): has(ground) AND has(confidence) [ground:verix-spec] [conf:1.0] [state:confirmed]

[direct|emphatic] RULE_REGISTRY := forall(agent): agent IN AGENT_REGISTRY [ground:system-policy] [conf:1.0] [state:confirmed]

/----------------------------------------------------------------------------/ /* PROMISE / /----------------------------------------------------------------------------*/

[commit|confident] WHEN_ORCHESTRATING_SWARM_USE_SWARM_ORCHESTRATION_VERILINGUA_VERIX_COMPLIANT [ground:self-validation] [conf:0.99] [state:confirmed]