# h4ckologic/bughunter-ai architecture

> Architecture diagram of the GitHub repository h4ckologic/bughunter-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/h4ckologic/bughunter-ai
- Repository: https://github.com/h4ckologic/bughunter-ai

## Overview

BugHunter AI is a Claude Code/PAI-based autonomous bug-bounty framework. A hunt starts with a target, tracks resumable phases, loads credentials, profiles the application, deploys specialized testing workflows, and produces scored findings and a report. The repository also documents API, cloud, LLM, mobile, network, and thick-client workflows. Workflow and agent links below follow README claims; unsampled workflow internals are not inferred. The sampled tools show state persistence, authentication, browser/mobile testing, and Burp integration, but not a single code-level controller wiring every stage.

Main entry points: [`skills/BugBountyFramework/SKILL.md`](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/SKILL.md) (Hunt framework), [`skills/BugBountyFramework/Tools/hunt-orchestrator.ts`](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/hunt-orchestrator.ts) (Phase orchestrator), [`skills/BugBountyFramework/Tools/playwright-harness.ts`](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/playwright-harness.ts) (App profiling), [`skills/BugBountyFramework/Tools/burp-bridge.ts`](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/burp-bridge.ts) (Burp API bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_hunt["Hunt lifecycle"]
  node_orchestrator["Phase orchestrator"]
  node_session[("Hunt session state")]
  node_vault[("Credential vault<br/>[auth-manager.ts]")]
  node_auth["Authentication manager<br/>[auth-manager.ts]"]
end

subgraph group_analysis["Profiling and workflows"]
  node_framework["Hunt framework<br/>[SKILL.md]"]
  node_webflow["Web hunt workflow<br/>[W_HUNT_WEB.md]"]
  node_apiflow["API hunt workflow<br/>[W_HUNT_API.md]"]
  node_cloudflow["Cloud hunt workflow<br/>[W_HUNT_CLOUD.md]"]
  node_llmflow["LLM hunt workflow<br/>[W_HUNT_LLM.md]"]
  node_mobileflow["Mobile hunt workflow<br/>[W_HUNT_MOBILE.md]"]
  node_networkflow["Network hunt workflow<br/>[W_HUNT_NETWORK.md]"]
  node_thickflow["Thick-client workflow"]
  node_recon["Recon workflow<br/>[W_RECON.md]"]
  node_agents["Specialized agents"]
end

subgraph group_testing["Testing tools"]
  node_profile["App profiling"]
  node_browser["Browser test harness"]
  node_mobile["Mobile test harness<br/>[appium-harness.ts]"]
  node_burp["Burp API bridge<br/>[burp-bridge.ts]"]
end

subgraph group_results["Findings and reporting"]
  node_findings[("Findings and artifacts")]
  node_report["Bug bounty report<br/>[BugReport.md]"]
end

node_researcher(("Security researcher"))
node_target(("Hunt target"))
node_claude["Claude Code + PAI"]
node_burpservice["Burp Suite"]

node_researcher -->|"invokes hunt"| node_claude
node_claude -->|"starts hunt"| node_orchestrator
node_target -->|"supplies target"| node_orchestrator
node_orchestrator -->|"saves phases"| node_session
node_orchestrator -->|"loads credentials"| node_auth
node_auth -->|"reads credentials"| node_vault
node_claude -->|"uses skill"| node_framework
node_framework -->|"profiles target"| node_profile
node_profile -->|"crawls and maps"| node_target
node_framework -->|"offers workflow"| node_webflow
node_framework -->|"offers workflow"| node_apiflow
node_framework -->|"offers workflow"| node_cloudflow
node_framework -->|"offers workflow"| node_llmflow
node_framework -->|"offers workflow"| node_mobileflow
node_framework -->|"offers workflow"| node_networkflow
node_framework -->|"offers workflow"| node_thickflow
node_framework -->|"offers workflow"| node_recon
node_framework -->|"deploys agents"| node_agents
node_profile -->|"prioritizes agents"| node_agents
node_webflow -.->|"uses harness"| node_browser
node_mobileflow -.->|"uses harness"| node_mobile
node_browser -->|"routes traffic"| node_burpservice
node_burp -->|"calls REST API"| node_burpservice
node_burp -.->|"exports scan issues"| node_findings
node_orchestrator -->|"records findings"| node_findings
node_findings -->|"informs report"| node_report

click node_orchestrator "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/hunt-orchestrator.ts"
click node_session "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/hunt-orchestrator.ts"
click node_vault "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/auth-manager.ts"
click node_auth "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/auth-manager.ts"
click node_framework "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/SKILL.md"
click node_profile "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/playwright-harness.ts"
click node_webflow "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_HUNT_WEB.md"
click node_apiflow "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_HUNT_API.md"
click node_cloudflow "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_HUNT_CLOUD.md"
click node_llmflow "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_HUNT_LLM.md"
click node_mobileflow "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_HUNT_MOBILE.md"
click node_networkflow "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_HUNT_NETWORK.md"
click node_thickflow "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_HUNT_THICK_CLIENT.md"
click node_recon "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_RECON.md"
click node_agents "https://github.com/h4ckologic/bughunter-ai/tree/main/skills/BugBountyFramework/Agents"
click node_browser "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/playwright-harness.ts"
click node_mobile "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/appium-harness.ts"
click node_burp "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/burp-bridge.ts"
click node_findings "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/hunt-orchestrator.ts"
click node_report "https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Templates/BugReport.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_orchestrator,node_session,node_vault,node_auth toneBlue
class node_framework,node_webflow,node_apiflow,node_cloudflow,node_llmflow,node_mobileflow,node_networkflow,node_thickflow,node_recon,node_agents toneAmber
class node_profile,node_browser,node_mobile,node_burp toneMint
class node_findings,node_report toneRose
class node_researcher,node_target,node_claude,node_burpservice toneIndigo
```

## Components

### Hunt lifecycle

- [Phase orchestrator](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/hunt-orchestrator.ts): `skills/BugBountyFramework/Tools/hunt-orchestrator.ts`
- [Hunt session state](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/hunt-orchestrator.ts): `skills/BugBountyFramework/Tools/hunt-orchestrator.ts`
- [Credential vault](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/auth-manager.ts): `skills/BugBountyFramework/Tools/auth-manager.ts`
- [Authentication manager](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/auth-manager.ts): `skills/BugBountyFramework/Tools/auth-manager.ts`

### Profiling and workflows

- [Hunt framework](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/SKILL.md): `skills/BugBountyFramework/SKILL.md`
- [Web hunt workflow](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_HUNT_WEB.md): `skills/BugBountyFramework/Workflows/W_HUNT_WEB.md`
- [API hunt workflow](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_HUNT_API.md): `skills/BugBountyFramework/Workflows/W_HUNT_API.md`
- [Cloud hunt workflow](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_HUNT_CLOUD.md): `skills/BugBountyFramework/Workflows/W_HUNT_CLOUD.md`
- [LLM hunt workflow](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_HUNT_LLM.md): `skills/BugBountyFramework/Workflows/W_HUNT_LLM.md`
- [Mobile hunt workflow](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_HUNT_MOBILE.md): `skills/BugBountyFramework/Workflows/W_HUNT_MOBILE.md`
- [Network hunt workflow](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_HUNT_NETWORK.md): `skills/BugBountyFramework/Workflows/W_HUNT_NETWORK.md`
- [Thick-client workflow](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_HUNT_THICK_CLIENT.md): `skills/BugBountyFramework/Workflows/W_HUNT_THICK_CLIENT.md`
- [Recon workflow](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Workflows/W_RECON.md): `skills/BugBountyFramework/Workflows/W_RECON.md`
- [Specialized agents](https://github.com/h4ckologic/bughunter-ai/tree/main/skills/BugBountyFramework/Agents): `skills/BugBountyFramework/Agents`

### Testing tools

- [App profiling](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/playwright-harness.ts): `skills/BugBountyFramework/Tools/playwright-harness.ts`
- [Browser test harness](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/playwright-harness.ts): `skills/BugBountyFramework/Tools/playwright-harness.ts`
- [Mobile test harness](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/appium-harness.ts): `skills/BugBountyFramework/Tools/appium-harness.ts`
- [Burp API bridge](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/burp-bridge.ts): `skills/BugBountyFramework/Tools/burp-bridge.ts`

### Findings and reporting

- [Findings and artifacts](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Tools/hunt-orchestrator.ts): `skills/BugBountyFramework/Tools/hunt-orchestrator.ts`
- [Bug bounty report](https://github.com/h4ckologic/bughunter-ai/blob/main/skills/BugBountyFramework/Templates/BugReport.md): `skills/BugBountyFramework/Templates/BugReport.md`

### Other components

- **Security researcher**
- **Hunt target**
- **Claude Code + PAI**
- **Burp Suite**

## Connections

- Security researcher → Claude Code + PAI: invokes hunt (evidence: `README.md`)
- Claude Code + PAI → Phase orchestrator: starts hunt (evidence: `README.md`)
- Hunt target → Phase orchestrator: supplies target (evidence: `README.md`)
- Phase orchestrator → Hunt session state: saves phases (evidence: `skills/BugBountyFramework/Tools/hunt-orchestrator.ts`)
- Phase orchestrator → Authentication manager: loads credentials (evidence: `README.md`)
- Authentication manager → Credential vault: reads credentials (evidence: `skills/BugBountyFramework/Tools/auth-manager.ts`)
- Claude Code + PAI → Hunt framework: uses skill (evidence: `README.md`)
- Hunt framework → App profiling: profiles target (evidence: `README.md`)
- App profiling → Hunt target: crawls and maps (evidence: `skills/BugBountyFramework/Tools/playwright-harness.ts`)
- Hunt framework → Web hunt workflow: offers workflow (evidence: `README.md`)
- Hunt framework → API hunt workflow: offers workflow (evidence: `README.md`)
- Hunt framework → Cloud hunt workflow: offers workflow (evidence: `README.md`)
- Hunt framework → LLM hunt workflow: offers workflow (evidence: `README.md`)
- Hunt framework → Mobile hunt workflow: offers workflow (evidence: `README.md`)
- Hunt framework → Network hunt workflow: offers workflow (evidence: `README.md`)
- Hunt framework → Thick-client workflow: offers workflow (evidence: `README.md`)
- Hunt framework → Recon workflow: offers workflow (evidence: `README.md`)
- Hunt framework → Specialized agents: deploys agents (evidence: `README.md`)
- App profiling → Specialized agents: prioritizes agents (evidence: `skills/BugBountyFramework/Tools/playwright-harness.ts`)
- Web hunt workflow → Browser test harness: uses harness
- Mobile hunt workflow → Mobile test harness: uses harness
- Browser test harness → Burp Suite: routes traffic (evidence: `skills/BugBountyFramework/Tools/playwright-harness.ts`)
- Burp API bridge → Burp Suite: calls REST API (evidence: `skills/BugBountyFramework/Tools/burp-bridge.ts`)
- Burp API bridge → Findings and artifacts: exports scan issues
- Phase orchestrator → Findings and artifacts: records findings (evidence: `skills/BugBountyFramework/Tools/hunt-orchestrator.ts`)
- Findings and artifacts → Bug bounty report: informs report (evidence: `README.md`)
