naman10parikh/agentswarm
One YAML file, a swarm of expert agents, no idle panes.
field: unknown workflow: Security reviewFrontend & designPR / code reviewPlanning & specsTesting & TDD
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
CONTEXT TAX · EVERY TURN
up to ~7.6k tokens
Claude Code loads MCP tools on demand, so the real cost is usually lower.
Heavy · median rig: 2.3k · breakdown
GUARDRAILS
3/5
Blocks destructive commands · Pre-tool screening hook · No YOLO mode · details
Quality 86/100 Guardrails v2
Copy this rig
# review before running: this installs third-party code $ claude mcp add agentswarm -- npx -y -p github:naman10parikh/agentswarm agentswarm-mcp $ npx degit naman10parikh/agentswarm/.claude ./rig-agentswarm # inspect, then merge into .claude/
MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.
$ claude mcp add agentswarm -- npx -y -p github:naman10parikh/agentswarm agentswarm-mcp $ npx degit naman10parikh/agentswarm/.claude/skills/agent-runtime .claude/skills/agent-runtime $ npx degit naman10parikh/agentswarm/.claude/skills/anthropic-frontend-design .claude/skills/anthropic-frontend-design $ npx degit naman10parikh/agentswarm/.claude/skills/architect .claude/skills/architect $ npx degit naman10parikh/agentswarm/.claude/skills/deep-think .claude/skills/deep-think $ npx degit naman10parikh/agentswarm/.claude/skills/design-systems .claude/skills/design-systems $ npx degit naman10parikh/agentswarm/.claude/skills/ecosystem-reference .claude/skills/ecosystem-reference $ npx degit naman10parikh/agentswarm/.claude/skills/fractal-delegation .claude/skills/fractal-delegation $ npx degit naman10parikh/agentswarm/.claude/skills/harness-review .claude/skills/harness-review $ npx degit naman10parikh/agentswarm/.claude/skills/heartbeat .claude/skills/heartbeat $ npx degit naman10parikh/agentswarm/.claude/skills/integrate-resources .claude/skills/integrate-resources $ npx degit naman10parikh/agentswarm/.claude/skills/llm-council-critique .claude/skills/llm-council-critique $ npx degit naman10parikh/agentswarm/.claude/skills/loop-create .claude/skills/loop-create $ npx degit naman10parikh/agentswarm/.claude/skills/mcp-setup .claude/skills/mcp-setup $ npx degit naman10parikh/agentswarm/.claude/skills/memory-compression .claude/skills/memory-compression $ npx degit naman10parikh/agentswarm/.claude/skills/memory .claude/skills/memory $ npx degit naman10parikh/agentswarm/.claude/skills/model-routing .claude/skills/model-routing $ npx degit naman10parikh/agentswarm/.claude/skills/oss-project-scaffold .claude/skills/oss-project-scaffold $ npx degit naman10parikh/agentswarm/.claude/skills/playwright-cli .claude/skills/playwright-cli $ npx degit naman10parikh/agentswarm/.claude/skills/repo-scout .claude/skills/repo-scout $ npx degit naman10parikh/agentswarm/.claude/skills/self-improve .claude/skills/self-improve $ npx degit naman10parikh/agentswarm/.claude/skills/skill-creator .claude/skills/skill-creator $ npx degit naman10parikh/agentswarm/.claude/skills/skill-routing .claude/skills/skill-routing $ npx degit naman10parikh/agentswarm/.claude/skills/sprint .claude/skills/sprint $ npx degit naman10parikh/agentswarm/.claude/skills/test-visual .claude/skills/test-visual $ npx degit naman10parikh/agentswarm/.claude/skills/troubleshoot .claude/skills/troubleshoot $ npx degit naman10parikh/agentswarm/.claude/skills/ux-audit .claude/skills/ux-audit $ npx degit naman10parikh/agentswarm/skills/author-swarm .claude/skills/author-swarm $ npx degit naman10parikh/agentswarm/skills/debug-swarm .claude/skills/debug-swarm $ npx degit naman10parikh/agentswarm/skills/run-swarm .claude/skills/run-swarm
$ curl -fsSL --create-dirs -o .claude/agents/architect.md https://raw.githubusercontent.com/naman10parikh/agentswarm/main/.claude/agents/architect.md $ curl -fsSL --create-dirs -o .claude/agents/code-reviewer.md https://raw.githubusercontent.com/naman10parikh/agentswarm/main/.claude/agents/code-reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/loop-auditor.md https://raw.githubusercontent.com/naman10parikh/agentswarm/main/.claude/agents/loop-auditor.md $ curl -fsSL --create-dirs -o .claude/agents/performance-analyzer.md https://raw.githubusercontent.com/naman10parikh/agentswarm/main/.claude/agents/performance-analyzer.md $ curl -fsSL --create-dirs -o .claude/agents/research-agent.md https://raw.githubusercontent.com/naman10parikh/agentswarm/main/.claude/agents/research-agent.md $ curl -fsSL --create-dirs -o .claude/agents/security-reviewer.md https://raw.githubusercontent.com/naman10parikh/agentswarm/main/.claude/agents/security-reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/swarm-designer.md https://raw.githubusercontent.com/naman10parikh/agentswarm/main/.claude/agents/swarm-designer.md $ curl -fsSL --create-dirs -o .claude/agents/swarm-doctor.md https://raw.githubusercontent.com/naman10parikh/agentswarm/main/.claude/agents/swarm-doctor.md $ curl -fsSL --create-dirs -o .claude/agents/test-writer.md https://raw.githubusercontent.com/naman10parikh/agentswarm/main/.claude/agents/test-writer.md
Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/block-dangerous-commands.cjs\""
}
]
},
{
"matcher": "Read|Edit|Write|Bash",
"hooks": [
{
"type": "command",
"command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/protect-secrets.cjs\""
}
]
}
]
}
} MCP servers (1)
| server | source | est. tokens |
|---|---|---|
| github:naman10parikh/agentswarm · "agentswarm" | npm | 2.5k |
Skills (29)
agent-runtimefrontend-designarchitectdeep-thinkdesign-systemsecosystem-referencefractal-delegationharness-reviewheartbeatintegrate-resourcesllm-council-critiqueloop-createmcp-setupmemory-compressionmemorymodel-routingoss-project-scaffoldplaywright-clirepo-scoutself-improveskill-creatorskill-routingsprinttest-visualtroubleshootux-auditauthor-swarmdebug-swarmrun-swarm
Subagents (9)
| architect model: sonnet | System architect agent for evaluating trade-offs, designing APIs, reviewing schemas, and planning multi-service integration. |
| code-reviewer model: sonnet | Reviews code changes for quality, security, and alignment with Energy platform architecture. |
| agent-auditor model: sonnet | Audits agent definitions (currently .energy format) for completeness, token efficiency, and harness quality. |
| performance-analyzer model: sonnet | Analyzes code for performance bottlenecks, memory leaks, bundle size issues, and optimization opportunities. |
| research-agent model: haiku | Deep research agent for investigating topics, reading docs, searching repos, and summarizing findings. Optimized for breadth. |
| security-reviewer model: sonnet | Reviews code changes for security vulnerabilities (OWASP Top 10, secrets exposure, injection attacks, auth issues). |
| swarm-designer | Turns a multi-step goal into a validated agentswarm swarm.yaml. Splits the work into VP roles, writes each VP's prompt with its completion signal, sets depends_on so the order is right, and proves the |
| swarm-doctor | Diagnoses a running swarm that is stuck, idle, deadlocked or never finishing, and names the smallest fix. Read-only by default. Use when a swarm "isn't progressing", a VP sits idle, a dependent VP nev |
| test-writer model: sonnet | Generates comprehensive test suites for Energy platform modules. |
Hooks (3)
| event | matcher | runs |
|---|---|---|
| PreToolUse | Bash | node "$CLAUDE_PROJECT_DIR/.claude/hooks/block-dangerous-commands.cjs" |
| PreToolUse | Read|Edit|Write|Bash | node "$CLAUDE_PROJECT_DIR/.claude/hooks/protect-secrets.cjs" |
| PostToolUse | Write|Edit|Bash | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/audit-log.sh" |
Slash commands (16)
/compress/deps-audit/dx-gha/feature-dev/handoff/integrate-resources/perf-check/preserve/recover/research/resume/security-scan/start/status/validate/wrap-up
Similar rigs
naman10parikh/agentgrid
Spawn grids of coding agents (Claude, Codex, Gemini, Cursor) in one command.
Orchestrator 7.2k tok · · Q15
naman10parikh/wikimem
Self-improving memory for agents: ingest anything, query everything.
Orchestrator 6.2k tok · · Q86
naman10parikh/agent-booster
Mechanical code edits without a model: deterministic, free, offline.
Orchestrator 6.3k tok · · Q86
naman10parikh/agentmoney
Know what your AI costs: pricing and spend for Claude, GPT and Gemini.
Orchestrator 7.0k tok · · Q86