Skip to content
/

SWORDSwarm

sword-swarm · SWORDOps/SWORDSwarm · ★ 24 · last commit 2026-02-05

88-agent corporate-hierarchy orchestration system with Intel NPU hardware acceleration and multi-IDE support for enterprise-grade parallel AI task execution.

Best whenAgent hierarchies should mirror corporate org charts with explicit authority chains, UUIDs, and version-controlled definitions — and hardware acceleration ma…
Skip ifFlat single-agent architecture for complex tasks, Implicit agent capabilities without formal definitions
vs seeds
bmad-method's persona-md pattern to 117 agents with a corporate hierarchy. Intel NPU hardware acceleration for the orchestration la…
Primitive shape 117 total
Subagents 117
00

Summary

SWORDSwarm — Summary

SWORDSwarm (v42.0) is a Python-based multi-agent orchestration system with 117 specialized agent definition files (in YAML+Markdown format) organized in a 4-level corporate hierarchy (Executive/Senior Management/Middle Management/Specialists), hardware acceleration via Intel NPU and AVX2/AVX-512 SIMD, a three-tier architecture (Binary/C+Rust → Hook/Python → Agent/Markdown layer), OpenAI Codex integration, and a "SWORD" invocation model where Claude Code agents can invoke orchestrators via a Python subprocess bridge.

Problem it solved: Complex enterprise AI orchestration requiring many specialized agents with clear authority chains, hardware-accelerated execution, and the ability to bolt on additional tooling (Warp terminal, Cursor, Windsurf, VS Code) via config files.

Distinctive traits: (1) 117 specialized agent .md files in a corporate hierarchy (DIRECTOR, CSO, LEADENGINEER, AGENTSMITH, ARCHITECT, etc.); (2) Intel NPU + AVX2/AVX-512 hardware acceleration (7-10x speedup claimed); (3) Three-tier architecture: C/Rust binary layer → Python hook layer → agent markdown layer; (4) Multi-IDE support via config files (.cursor, .windsurf, .warp, .vscode); (5) Described with extreme self-promotional language ("production-ready", "enterprise-grade", "military-grade optimization").

Credibility note: Many claims (82% test coverage, 95% on-time delivery rate, 98.7% deployment success rate) appear aspirational rather than verified. The repo has 24 stars and was last committed in February 2026.

differs_from_seeds: SWORDSwarm's agent definition format (YAML+Markdown with UUID, metadata, version, proactive_triggers) is closest to BMAD-METHOD's persona-md pattern but much more verbose and structured. Unlike BMAD (34 skills), SWORDSwarm has 117 agent files with explicit corporate hierarchy. No other framework in this corpus attempts hardware acceleration for agent execution.

01

Overview

SWORDSwarm — Overview

Origin

Created by SWORDOps (GitHub org: SWORDOps, alt: SWORDIntel). No license file found in GitHub API response. Default branch: maine (unusual). Version: v42.0 (from README). 24 stars, last committed February 2026.

Philosophy

From README:

"Yeet 88 agents at a problem and see what survives."

And more formally:

"Production-ready multi-agent AI orchestration system with hardware acceleration and AI-powered development tools." "Claude Agent Framework is an enterprise-grade platform for building intelligent, coordinated agent systems with unprecedented performance through Intel NPU acceleration."

The README oscillates between satirical humor ("yeet 88 agents", "i bolted warp on the side poorly") and extreme enterprise marketing claims ("military-grade optimization", "zero vulnerabilities").

Corporate hierarchy metaphor

SWORDSwarm organizes agents in a corporate structure with 4 levels:

  1. Executive Level (5 agents): DIRECTOR, CSO, LEADENGINEER, AGENTSMITH, PROJECTORCHESTRATOR
  2. Senior Management (8 division heads): ARCHITECT, PLANNER, SECURITY, INFRASTRUCTURE, etc.
  3. Middle Management: Division-specific managers
  4. Specialists (many): PYTHON-INTERNAL, CPP-INTERNAL, ASSEMBLY-INTERNAL, APT41-DEFENSE, etc.

Technology bet

C/Rust binary layer + Python hooks + Intel NPU acceleration — an unusual focus on hardware performance for AI orchestration (typically GPU/CPU-bound by the LLM itself, not the orchestration layer).

Target users

(Claimed) enterprise teams needing 88 specialized agents with hardware acceleration and multi-IDE support.

02

Architecture

SWORDSwarm — Architecture

Three-tier architecture

Tier 1: Binary Layer (C/Rust)
  - Hardware acceleration (Intel NPU, AVX2/AVX-512)
  - Performance-critical operations
  
Tier 2: Hook Layer (Python)
  - Python hook scripts
  - Interface between binary and agent layers
  - Orchestration logic
  
Tier 3: Agent Layer (Markdown)
  - 117 agent .md definition files
  - YAML frontmatter with metadata
  - Role descriptions and prompt content

Directory structure

SWORDSwarm/
├── agents/           # 117 agent .md files
├── orchestration/    # Orchestration scripts
│   ├── invoke.py     # Python subprocess bridge
│   ├── config.json
│   └── learning_system_tandem_orchestrator.py
├── hooks/            # Hook scripts
├── .claude/          # Claude Code integration
├── .cursor/          # Cursor IDE config
├── .windsurf/        # Windsurf config
├── .warp/            # Warp terminal config
├── .vscode/          # VS Code config
├── .mcp.json         # MCP configuration
├── config/           # System config
├── docs/             # Documentation
├── tests/            # Tests
├── benchmark/        # Performance benchmarks
├── security/         # Security configurations
├── crypto-pow/       # Crypto proof-of-work (unusual)
├── openvino/         # Intel OpenVINO integration
└── local-models/     # Local LLM model support

Required runtime

  • Python 3.11+
  • Virtual environment (venv)
  • Intel NPU (optional, for hardware acceleration)
  • OpenVINO (optional, for Intel acceleration)

Multi-IDE support

Separate config directories for: Claude Code (.claude), Cursor (.cursor), Windsurf (.windsurf), Warp (.warp), VS Code (.vscode) — enabling multi-IDE agent invocation.

03

Components

SWORDSwarm — Components

Agent definitions (117 files in agents/)

Executive Level (5 agents)

Agent Role
DIRECTOR Supreme strategic director; commands all 31 production agents
CSO Chief Security Officer
LEADENGINEER Technical leadership (CTO function)
AGENTSMITH Meta-agent for creating new agents; 98.7% deployment success claimed
PROJECTORCHESTRATOR Project coordination

Senior Management (8 agents)

ARCHITECT, PLANNER, SECURITY, INFRASTRUCTURE, DATASCIENCE, QADIRECTOR, ORCHESTRATOR, COORDINATOR

Selected specialists

PYTHON-INTERNAL, CPP-INTERNAL, C-INTERNAL, ASSEMBLY-INTERNAL, CRYPTO, CRYPTOEXPERT, AUDITOR, BASTION, AGENTSMITH, COGNITIVE_DEFENSE_AGENT, APT41-DEFENSE-AGENT, BGP-BLUE/RED/PURPLE-TEAM, CHAOS-AGENT, CISCO-AGENT, CLAUDECODE-PROMPTINJECTOR, CONSTRUCTOR, COORDINATOR, CARBON-INTERNAL-AGENT, C-MAKE-INTERNAL, CPP-GUI-INTERNAL, and 90+ more

Agent definition format (YAML+Markdown, v8.0 schema)

---
metadata:
  name: DIRECTOR
  version: 8.0.0
  uuid: d1r3c70r-3x3c-u71v-3000-57r4736y0001
  category: STRATEGIC
  priority: CRITICAL
  status: PRODUCTION
  color: "#FFD700"  # Gold - executive command authority
  emoji: "🎯"
  description: |
    ...multi-line description...
  tools:
    required:
      - Task  # MANDATORY for agent invocation
    code_operations: [Read, Write, Edit, MultiEdit]
    system_operations: [Bash, Grep, Glob, LS]
    information: [WebFetch, WebSearch]
    workflow: [TodoWrite, GitCommand]
  proactive_triggers:
    patterns: [...]
    context_triggers: [...]
    keywords: [...]
---
[Markdown role description content]

Orchestration scripts

File Purpose
orchestration/invoke.py Python subprocess bridge for orchestrator invocation
orchestration/config.json Paths to orchestrators, venv, project root
orchestration/learning_system_tandem_orchestrator.py Learning system orchestrator

Hardware acceleration

Component Purpose
openvino/ Intel OpenVINO integration for NPU acceleration
local-models/ Local LLM model support
AVX2/AVX-512 SIMD vector operations
05

Prompts

SWORDSwarm — Prompts

Verbatim excerpt 1: DIRECTOR agent (strategic orchestrator)

---
metadata:
  name: DIRECTOR
  version: 8.0.0
  uuid: d1r3c70r-3x3c-u71v-3000-57r4736y0001
  category: STRATEGIC
  priority: CRITICAL
  status: PRODUCTION
  color: "#FFD700"
  emoji: "🎯"
  description: |
    Strategic executive orchestrator commanding all system agents through intelligent 
    multi-phase project strategies. Operates as supreme command layer with authority 
    over all 31 production agents including ProjectOrchestrator, handling complex 
    initiatives requiring 2-8 orchestration cycles with 95% on-time delivery rate.
    
    Specializes in project complexity analysis, resource optimization algorithms, 
    parallel execution orchestration, and adaptive replanning. Transforms nebulous 
    project visions into precisely orchestrated multi-phase execution plans with 
    deterministic outcomes and measurable success criteria.
  
  proactive_triggers:
    patterns:
      - "Complex project requiring multiple phases"
      - "Need strategic planning and coordination"
      - "Multi-agent orchestration required"
    context_triggers:
      - "When project scope exceeds single agent capability"
      - "When 3+ agents need coordination"
      - "When parallel execution paths available"
    keywords:
      - strategic planning
      - multi-phase project
      - orchestration
---

Prompting technique: Rich YAML metadata + freeform description. The agent's personality, authority scope, and trigger conditions are all in the frontmatter — unusually structured compared to most agent definition formats.


Verbatim excerpt 2: AGENTSMITH agent (meta-agent)

---
metadata:
  name: AGENTSMITH
  version: 8.0.0
  uuid: 461750d7-8b2f-4c4c-9e5b-5c4e1b3a2f1e
  category: CORE
  priority: CRITICAL
  status: PRODUCTION
  description: |
    Elite agent creation specialist with autonomous architecture design capabilities 
    achieving 98.7% successful agent deployment rate across all 74+ framework 
    categories. Synthesizes requirements analysis, architectural blueprints, 
    implementation scaffolding, and Python integration layers...
    
    Core responsibilities include agent requirements analysis through multi-agent 
    consultation, architectural decision making using design pattern libraries, 
    specification creation following v8.0 template standards, Python implementation 
    scaffolding with async/await patterns, testing framework integration, and 
    deployment validation with performance benchmarking achieving <200ms agent 
    response times.
  
  tools:
    required:
      - Task  # MANDATORY for agent invocation
---

Prompting technique: Self-referential meta-agent — AGENTSMITH creates other agents following the v8.0 template. The "98.7% successful deployment rate" and "<200ms agent response times" are performance specifications written into the agent's identity/self-description, intended to prime its behavior expectations.

09

Uniqueness

SWORDSwarm — Uniqueness & Positioning

differs_from_seeds

SWORDSwarm's agent definition format (YAML frontmatter + Markdown with UUID, version, proactive_triggers, tool declarations) is the most structured in this batch. The closest seed parallel is BMAD-METHOD's persona-md pattern (6 named persona files), but SWORDSwarm has 117 agents with explicit corporate hierarchy, UUIDs, color coding, and proactive trigger patterns. Unlike superpowers (14 skills, auto-triggered via SessionStart hook), SWORDSwarm's proactive triggers are specified in each agent's YAML and matched at inference time by Claude Code. The hardware acceleration (Intel NPU + OpenVINO) is unique in the entire corpus — no other framework attempts to accelerate the orchestration layer with specialized hardware. The multi-IDE config approach (.claude/, .cursor/, .windsurf/, .warp/, .vscode/) is also unique among frameworks studied.

Positioning (claimed)

  • "Enterprise-grade" multi-agent orchestration
  • "Military-grade optimization" (not independently verified)
  • Hardware-first: Intel NPU as a differentiator
  • Multi-IDE: not locked to Claude Code

Credibility concerns

Several signals suggest this is an experimental/hobbyist project despite enterprise claims:

  • 24 stars (vs 172-5542 for other frameworks in this batch)
  • Non-standard default branch (maine)
  • No license file
  • Performance metrics ("95% on-time delivery rate", "98.7% deployment success") are written into agent descriptions, not measured
  • "I bolted warp on the side poorly" (README self-assessment)
  • Last commit February 2026 (dormant)
  • No public documentation site

Observable failure modes

  • 117 agents × YAML+Markdown format = massive context injection risk
  • No memory persistence: agents cannot learn or remember across sessions
  • No git isolation: all agents operate in the same directory
  • Corporate hierarchy may create bottlenecks (DIRECTOR as single point of failure)
  • Hardware acceleration may be premature optimization (LLM inference dominates)

Inspired by

  • Corporate org chart as agent hierarchy metaphor
  • Intel NPU / OpenVINO ecosystem

Note on reliability

This report is based on accessible README and agent files only. Many claimed features (82% test coverage, CI/CD pipeline) could not be verified.

04

Workflow

SWORDSwarm — Workflow

Primary invocation via orchestration/invoke.py

# Claude Code invokes orchestrators via Python subprocess:
result = invoke_orchestrator(task="analyze code quality", orchestrator_type="production")

The Python subprocess bridge reads config.json to locate the orchestrator, activates the venv, and runs the orchestrator Python script.

Agent invocation via Claude Code Task tool

From agent YAML metadata:

tools:
  required:
    - Task  # MANDATORY for agent invocation

All agents list Task as a required tool — meaning they are invoked via Claude Code's Task tool, which spawns sub-agents. The hierarchy is:

  1. User → DIRECTOR
  2. DIRECTOR → Task(LEADENGINEER/ARCHITECT/etc.)
  3. LEADENGINEER → Task(PYTHON-INTERNAL/CPP-INTERNAL/etc.)

Proactive triggers

Each agent has proactive_triggers specifying:

  • Patterns (regex-style keywords in user prompts)
  • Context triggers (situational conditions)
  • Keywords (simpler keyword matching)

These trigger proactive invocation — Claude Code agents auto-invoke relevant SWORD agents based on conversation content.

Phases (implicit from architecture)

Phase Actor Action
Strategic planning DIRECTOR Analyzes task, allocates to division heads
Division planning ARCHITECT/PLANNER Technical architecture, detailed planning
Parallel execution Specialist agents Language-specific implementation
Quality assurance QADIRECTOR + specialists Testing, security review
Delivery COORDINATOR Integration, final checks

Approval gates

Not formally documented — the hierarchical structure implies DIRECTOR approval before execution, but no explicit gate mechanism is specified.

06

Memory Context

SWORDSwarm — Memory & Context

Agent state

  • Each agent definition is a static .md file — no runtime state per agent beyond Claude Code's own context window
  • No cross-session memory system documented (no database, no vector store)

Orchestration state

The config.json in orchestration/ stores static paths (project root, agents dir, venv, orchestrator paths). This is configuration, not runtime state.

Learning system

orchestration/learning_system_tandem_orchestrator.py suggests a learning component, but its mechanism is not documented in publicly accessible files.

Cross-session context

The multi-IDE config directories (.claude/, .cursor/, .windsurf/) may contain agent context files, but their specific content is not accessible without the actual files. The .claude/ directory is present but content not retrieved.

No explicit memory persistence

Unlike SwarmClaw (dreaming/consolidation), claude-flow (SQLite + vector), or agor (LibSQL), SWORDSwarm has no documented persistent memory system. Agent "knowledge" is encoded in the static .md files.

Hardware acceleration context

The Intel NPU and OpenVINO integration is for computational acceleration of the orchestration layer, not for LLM inference (the LLM runs on cloud APIs). The performance claim "7-10x speedup" likely applies to the Python orchestration code, not the AI model calls.

07

Orchestration

SWORDSwarm — Orchestration

Multi-agent support

Yes — 117 agents in a 4-level hierarchy.

Orchestration pattern

Hierarchical — strict corporate chain of command:

  • DIRECTOR dispatches to Senior Management
  • Senior Management dispatches to Middle Management
  • Middle Management dispatches to Specialists
  • All invocation via Claude Code's Task tool

Isolation mechanism

None explicitly documented. No git worktree or container isolation mentioned. Agents likely operate in the same working directory.

Multi-IDE support

Agents can be invoked from Claude Code, Cursor, Windsurf, Warp, or VS Code via their respective config directories. This is a multi-surface (not multi-model) feature.

Multi-model support

Codex integration mentioned in README. Whether different agents use different models is not documented in publicly accessible files.

Hardware acceleration

Intel NPU + AVX2/AVX-512 SIMD for the orchestration layer. The LLM calls themselves (to Claude, Codex) are not accelerated — this accelerates the Python orchestration code.

Execution mode

One-shot — invoked per task via orchestration/invoke.py subprocess.

Coordination mechanism

Corporate hierarchy: DIRECTOR → divisions → specialists. All dispatched via Claude Code's Task tool with explicit agent names in the invocation.

Claimed performance

README claims: "60% concurrency rates", "95% on-time delivery rate", "98.7% agent deployment success" — these are aspirational metrics written into agent descriptions, not measured benchmarks.

Max concurrent agents

88 (per "yeet 88 agents at a problem" tagline). 31 "production agents" per DIRECTOR description.

08

Ui Cli Surface

SWORDSwarm — UI & CLI Surface

No dedicated UI

SWORDSwarm has no web dashboard, no desktop app, and no TUI.

No dedicated CLI binary

The primary interface is the Python subprocess bridge (orchestration/invoke.py) invoked by Claude Code agents, or direct invocation from any of the supported IDEs.

Multi-IDE surface

The framework supports invocation from multiple IDEs via config directories:

IDE Config Notes
Claude Code .claude/ Primary target
Cursor .cursor/ Cursor agent integration
Windsurf .windsurf/ Windsurf agent integration
Warp terminal .warp/ Warp AI integration
VS Code .vscode/ VS Code integration

MCP configuration

.mcp.json is present — MCP server configuration, but specific servers not documented in accessible files.

Installer

.install and .uninstall directories suggest a custom install/uninstall mechanism.

Observability

  • logs/ directory for runtime logs
  • benchmark/ directory for performance benchmarks
  • No structured audit log or replay

README self-assessment

The README's claim "zero vulnerabilities, comprehensive auditing, military-grade optimization" is not backed by any public audit report or certification. The repo has 24 stars, no license file, and a non-standard default branch (maine).

Related frameworks

same archetype · same primary tool · same memory type

claude-mem (thedotmack) ★ 78k

Background worker service captures every tool call as an observation, AI-compresses sessions, and auto-injects relevant past…

pi (badlogic/earendil) ★ 55k

A minimal, hackable, multi-provider terminal coding agent that adapts to your workflows via npm-installable TypeScript Extensions…

Agent Skills (Addy Osmani) ★ 46k

Encodes senior-engineer software development lifecycle as 23 auto-routed skills and 7 slash commands for any AI coding agent.

wshobson/agents Plugin Marketplace ★ 36k

Single Markdown source for 83 domain-specialized plugins that auto-generates idiomatic artifacts for five AI coding harnesses.

TabbyML/Tabby ★ 34k

Self-hosted AI coding assistant server (alternative to GitHub Copilot) with admin dashboard, RAG-based completions, and multi-IDE…

Compound Engineering ★ 17k

Make each unit of engineering work compound into easier future work via brainstorm→plan→execute→review→learn cycles.