# yeswehack/claude-kit architecture

> Architecture diagram of the GitHub repository yeswehack/claude-kit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yeswehack/claude-kit
- Repository: https://github.com/yeswehack/claude-kit

## Overview

YesWeHack Claude Kit is a Claude Code plugin for evidence-grounded bug bounty reporting. A hunter can invoke the write skill to structure a finding, then invoke triage for a submission verdict and concrete fixes; class-specific gotchas inform validation. Separately, a SessionStart hook applies always-on rules to every session. The README documents these connections and capabilities; no source excerpts were provided, so internal implementation details beyond the listed files are not inferred.

Main entry points: [`skills/triage/SKILL.md`](https://github.com/yeswehack/claude-kit/blob/main/skills/triage/SKILL.md) (Triage skill), [`hooks/hooks.json`](https://github.com/yeswehack/claude-kit/blob/main/hooks/hooks.json) (SessionStart hook), [`skills/write/SKILL.md`](https://github.com/yeswehack/claude-kit/blob/main/skills/write/SKILL.md) (Write skill), [`skills/gotchas/SKILL.md`](https://github.com/yeswehack/claude-kit/blob/main/skills/gotchas/SKILL.md) (Class gotchas)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Session discipline"]
  node_plugin["Plugin manifest<br/>[plugin.json]"]
  node_hook["SessionStart hook<br/>[hooks.json]"]
  node_rules["Always-on rules<br/>[always-on-rules.md]"]
end

subgraph group_reporting["Report workflow"]
  node_write["Write skill<br/>[SKILL.md]"]
end

subgraph group_validation["Validation guidance"]
  node_triage["Triage skill<br/>[SKILL.md]"]
  node_gotchas["Class gotchas<br/>[SKILL.md]"]
  node_triage_ref["Unverified-output checks<br/>[ai-slop.md]"]
end

node_hunter(("Bug bounty hunter"))
node_claude["Claude Code"]

node_claude -->|"starts session"| node_hook
node_hook -->|"loads rules"| node_rules
node_hunter -->|"invokes drafting"| node_write
node_write -->|"structures facts"| node_hunter
node_hunter -->|"requests verdict"| node_triage
node_triage -->|"returns fixes"| node_hunter
node_hunter -->|"names class"| node_gotchas
node_triage -->|"checks gotchas"| node_gotchas
node_triage -->|"checks output"| node_triage_ref
node_plugin -->|"installs in"| node_claude

click node_plugin "https://github.com/yeswehack/claude-kit/blob/main/.claude-plugin/plugin.json"
click node_hook "https://github.com/yeswehack/claude-kit/blob/main/hooks/hooks.json"
click node_rules "https://github.com/yeswehack/claude-kit/blob/main/always-on-rules.md"
click node_write "https://github.com/yeswehack/claude-kit/blob/main/skills/write/SKILL.md"
click node_triage "https://github.com/yeswehack/claude-kit/blob/main/skills/triage/SKILL.md"
click node_gotchas "https://github.com/yeswehack/claude-kit/blob/main/skills/gotchas/SKILL.md"
click node_triage_ref "https://github.com/yeswehack/claude-kit/blob/main/skills/triage/references/ai-slop.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_plugin,node_hook,node_rules toneBlue
class node_write toneAmber
class node_triage,node_gotchas,node_triage_ref toneMint
class node_hunter,node_claude toneIndigo
```

## Components

### Session discipline

- [Plugin manifest](https://github.com/yeswehack/claude-kit/blob/main/.claude-plugin/plugin.json): `.claude-plugin/plugin.json`
- [SessionStart hook](https://github.com/yeswehack/claude-kit/blob/main/hooks/hooks.json): `hooks/hooks.json`
- [Always-on rules](https://github.com/yeswehack/claude-kit/blob/main/always-on-rules.md): `always-on-rules.md`

### Report workflow

- [Write skill](https://github.com/yeswehack/claude-kit/blob/main/skills/write/SKILL.md): `skills/write/SKILL.md`

### Validation guidance

- [Triage skill](https://github.com/yeswehack/claude-kit/blob/main/skills/triage/SKILL.md): `skills/triage/SKILL.md`
- [Class gotchas](https://github.com/yeswehack/claude-kit/blob/main/skills/gotchas/SKILL.md): `skills/gotchas/SKILL.md`
- [Unverified-output checks](https://github.com/yeswehack/claude-kit/blob/main/skills/triage/references/ai-slop.md): `skills/triage/references/ai-slop.md`

### Other components

- **Bug bounty hunter**
- **Claude Code**

## Connections

- Claude Code → SessionStart hook: starts session (evidence: `README.md`)
- SessionStart hook → Always-on rules: loads rules (evidence: `README.md`)
- Bug bounty hunter → Write skill: invokes drafting (evidence: `README.md`)
- Write skill → Bug bounty hunter: structures facts (evidence: `README.md`)
- Bug bounty hunter → Triage skill: requests verdict (evidence: `README.md`)
- Triage skill → Bug bounty hunter: returns fixes (evidence: `README.md`)
- Bug bounty hunter → Class gotchas: names class (evidence: `README.md`)
- Triage skill → Class gotchas: checks gotchas (evidence: `README.md`)
- Triage skill → Unverified-output checks: checks output (evidence: `README.md`)
- Plugin manifest → Claude Code: installs in (evidence: `README.md`)
