1---2name: pentest-agent-orchestrator3description: Use when orchestrate 35 specialized Claude Code subagents for offensive security. Use when planning a pentest, routing tasks to specialist agents, or conducting multi-phase security assessments.4license: Apache-2.05---678# Pentest Agent Orchestrator910## Overview111235 specialized Claude Code subagents for offensive security, adapted from [0xSteph/pentest-ai-agents](https://github.com/0xSteph/pentest-ai-agents). No servers or dependencies required — copy agents to `~/.claude/agents/` and they are immediately available. Each agent is a standalone prompt file that Claude Code can spawn as a subagent.1314**Source:** https://github.com/0xSteph/pentest-ai-agents15**Agent count:** 35 specialized subagents16**Deployment:** Copy `~/.claude/agents/` — zero dependencies17**License:** Open source1819## When to Use2021**Trigger phrases:**22- "pentest agent orchestrator"23- "Planning and executing a penetration test"24- "Need specialist agent routing for specific attack surfaces"25- "Offensive security research across multiple domains"262728- Planning and executing a penetration test29- Need specialist agent routing for specific attack surfaces30- Offensive security research across multiple domains31- Orchestrating multi-phase engagements (recon through post-exploitation)32- CTF challenges requiring diverse tooling and approaches3334## Agent Categories3536This section covers agent categories for pentest agent orchestrator.3738- Ensure all prerequisites are met before proceeding39- Follow the documented workflow steps in sequence40- Record results and any anomalies encountered during this phase41### Reconnaissance / OSINT (3 agents)42| Agent | Purpose |43|-------|---------|44| `recon-advisor` | Strategic recon planning — what to gather, where to look, prioritization |45| `osint-collector` | Passive OSINT — WHOIS, DNS, Shodan, social media, breach databases |46| `attack-surface-mapper` | Active enumeration — subdomains, ports, services, technology fingerprinting |4748### Web Application Testing (4 agents)49| Agent | Purpose |50|-------|---------|51| `web-hunter` | OWASP Top 10 discovery — XSS, SQLi, SSRF, IDOR, auth bypass |52| `api-breaker` | API security testing — REST/GraphQL fuzzing, auth flaws, mass assignment |53| `auth-tester` | Authentication/authorization testing — session management, JWT, OAuth |54| `web-fuzzer` | Directory brute-force, parameter fuzzing, input validation testing |5556### Active Directory / Credentials (2 agents)57| Agent | Purpose |58|-------|---------|59| `ad-attacker` | AD attack paths — Kerberoasting, AS-REP, DCSync, delegation abuse |60| `credential-hunter` | Credential harvesting — password spraying, hash cracking, vault enumeration |6162### Cloud / CI/CD (2 agents)63| Agent | Purpose |64|-------|---------|65| `cloud-security` | AWS/GCP/Azure misconfiguration — IAM, S3, metadata, privilege escalation |66| `cicd-attacker` | CI/CD pipeline exploitation — secret leakage, supply chain, runner escape |6768### Containers / C2 (2 agents)69| Agent | Purpose |70|-------|---------|71| `container-escaper` | Container escape and Kubernetes exploitation — RBAC, host mounts, runtime |72| `c2-operator` | Command and control setup — payload delivery, callback management, channels |7374### AI / LLM Red Teaming (1 agent)75| Agent | Purpose |76|-------|---------|77| `llm-redteam` | AI/LLM security testing — prompt injection, model manipulation, data exfiltration |7879### Operational Security (1 agent)80| Agent | Purpose |81|-------|---------|82| `opsec-guardian` | OPSEC review — traffic analysis resistance, fingerprinting, attribution prevention |8384### Mobile / Wireless (2 agents)85| Agent | Purpose |86|-------|---------|87| `mobile-hacker` | iOS/Android testing — app analysis, certificate pinning bypass, API interception |88| `wireless-hunter` | Wi-Fi and RF testing — deauth, Evil Twin, WPA cracking, BLE reconnaissance |8990### Social Engineering (2 agents)91| Agent | Purpose |92|-------|---------|93| `phish-crafter` | Phishing campaign design — pretexting, payload delivery, landing pages |94| `social-engineer` | Human-layer attack planning — vishing, physical, OSINT-backed pretexts |9596### Payload / Reverse Engineering (2 agents)97| Agent | Purpose |98|-------|---------|99| `payload-smith` | Payload generation — shellcode, obfuscation, AV evasion, staged delivery |100| `reverse-engineer` | Binary analysis — disassembly, decompilation, vulnerability identification |101102### Exploit Chaining (3 agents)103| Agent | Purpose |104|-------|---------|105| `exploit-chainer` | Chain multiple low-severity findings into critical impact paths |106| `privilege-escalator` | Local privilege escalation — Linux/Windows kernel, SUID, services, tokens |107| `lateral-mover` | Network lateral movement — pivoting, pass-the-hash, relay attacks |108109### Post-Exploitation (2 agents)110| Agent | Purpose |111|-------|---------|112| `privesc-advisor` | Post-exploitation strategy — persistence, loot, cleanup, evidence handling |113| `data-exfiltrator` | Data staging and exfiltration — tunneling, encoding, covert channels |114115### Swarm Orchestration (1 agent)116| Agent | Purpose |117|-------|---------|118| `swarm-orchestrator` | Multi-agent coordination — task delegation, parallel execution, result aggregation |119120### Reporting (2 agents)121| Agent | Purpose |122|-------|---------|123| `report-generator` | Pentest report generation — findings, CVSS, remediation, executive summary |124| `evidence-manager` | Evidence chain — screenshots, logs, PoCs, timestamps, chain of custody |125126### Defense / Analysis (5 agents)127| Agent | Purpose |128|-------|---------|129| `defense-analyst` | Blue team perspective — validate findings, assess detection coverage |130| `threat-modeler` | Threat modeling — STRIDE, attack trees, risk prioritization |131| `compliance-checker` | Compliance mapping — NIST, OWASP, PCI-DSS against findings |132| `risk-assessor` | Risk scoring and prioritization — business impact, exploitability |133| `remediation-advisor` | Fix recommendations — specific, actionable, prioritized by impact |134135### CTF (1 agent)136| Agent | Purpose |137|-------|---------|138| `ctf-solver` | CTF challenge solver — crypto, web, pwn, forensics, reversing, misc |139140## Tier System141142This section covers tier system for pentest agent orchestrator.143144- Ensure all prerequisites are met before proceeding145- Follow the documented workflow steps in sequence146- Record results and any anomalies encountered during this phase147### Tier 1 — Advisory148- Provides analysis, recommendations, and attack path planning149- Does not execute commands or modify systems150- Safe to run without explicit approval gates151- Agents: `recon-advisor`, `osint-collector`, `opsec-guardian`, `report-generator`, `evidence-manager`, `threat-modeler`, `compliance-checker`, `risk-assessor`, `remediation-advisor`, `defense-analyst`152153### Tier 2 — Execution-Capable154- Can execute commands, run tools, and interact with targets155- Requires explicit approval before execution156- Output includes commands-to-run with justification157- Agents: All remaining agents (web-hunter, ad-attacker, cloud-security, exploit-chainer, c2-operator, etc.)158159## Usage Patterns160161```bash162# Basic usage example163# Replace with domain-specific commands from the workflow above164```165### Single-Agent Invocation166```167# Ask a specific specialist168Spawn recon-advisor to plan reconnaissance for target.example.com169```170171### Multi-Agent Orchestration172```173# Use swarm-orchestrator for coordinated assessment174Spawn swarm-orchestrator to run a full pentest against 10.0.0.0/24175```176177### Chained Workflow178```179# Sequential: recon -> hunting -> exploitation -> reporting1801. recon-advisor: map the target1812. web-hunter: identify vulnerabilities1823. exploit-chainer: chain findings into attack path1834. report-generator: produce final deliverable184```185186## Installation187188```bash189# Clone the repository190git clone https://github.com/0xSteph/pentest-ai-agents.git191192# Copy all agents to Claude Code agents directory193cp pentest-ai-agents/agents/*.md ~/.claude/agents/194195# Verify installation196ls ~/.claude/agents/197```198199## When NOT to Use200201- Task is outside your authorization scope202- You need to implement controls (use implementing-* skills)203- Task is about analysis, not action (use analyzing-* skills)204- You don't have access to target systems205- Task requires compliance expertise (consult professionals)206- Task is about defense, not offense (use defensive skills)207208209## Red Flags210211- Never run Tier 2 agents against targets without written authorization212- Verify scope boundaries before executing any exploitation213- Do not exfiltrate real data during testing without explicit permission214- Always follow responsible disclosure for any findings215## Verification216217- All steps executed successfully against a test environment before production use218- Output documented with screenshots or logs demonstrating expected behavior219- All exploited vulnerabilities documented with reproduction steps220- Scope boundaries confirmed — only authorized targets were tested221- Remediation recommendations included for every finding222223## Process2242251. Analyze the task requirements2262. Apply domain expertise2273. Verify output quality228229## Anti-Rationalization Table230231| Rationalization | Reality |232|---|---|233| "We are too small to be targeted" | Automated attacks target everyone. Size does not matter. |234| "Security slows us down" | A breach slows you down 100x more. Build security in from the start. |235| "We will fix it after launch" | Vulnerabilities in production are exploited within hours. Fix before deploy. |