# anthropics/claude-plugins-official architecture

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

- Interactive diagram: https://gitdiagram.com/anthropics/claude-plugins-official
- Repository: https://github.com/anthropics/claude-plugins-official

## Overview

This repository is a curated Claude Code plugin directory, not one unified application. Its product workflow is plugin discovery/installation followed by use of a plugin’s own commands, skills, hooks, or MCP server. The graph preserves the substantial modernization, security, hookify, and third-party chat integration branches, plus session and skill utilities. Edges are limited to README statements and relationships visible in the supplied excerpts or SOURCE INDEX; unsampled plugin internals are not inferred.

Main entry points: [`plugins/code-modernization/hooks/register.ts`](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/register.ts) (Modernization hooks), [`plugins/code-modernization/hooks/reader/progress.ts`](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/reader/progress.ts) (Workflow progress), [`plugins/code-modernization/hooks/views/pane.tsx`](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/views/pane.tsx) (Status pane), [`plugins/hookify/hooks/pretooluse.py`](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/hookify/hooks/pretooluse.py) (Hookify events)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Plugin Catalog"]
  node_plugin_system["Plugin system"]
  node_external_servers["Chat MCP servers"]
  node_discord["Discord server<br/>[server.ts]"]
  node_fakechat["Fakechat server<br/>[server.ts]"]
  node_imessage["iMessage server<br/>[server.ts]"]
  node_telegram["Telegram server<br/>[server.ts]"]
end

subgraph group_modernize["Code Modernization"]
  node_modernize_hooks["Modernization hooks<br/>[register.ts]"]
  node_estate["Codebase map<br/>[estate.ts]"]
  node_estate_model["Code units<br/>[estate-model.ts]"]
  node_topology["Repository topology<br/>[topology.ts]"]
  node_progress["Workflow progress<br/>[progress.ts]"]
  node_modernized_state["Transformed state<br/>[modernized.ts]"]
  node_rules["Business rules<br/>[rules.ts]"]
  node_fleet["Agent activity<br/>[fleet.ts]"]
  node_pane["Status pane<br/>[pane.tsx]"]
end

subgraph group_security["Security Plugins"]
  node_security_hook["Security reminder"]
  node_security_llm["LLM analysis<br/>[llm.py]"]
  node_review_api["Review API<br/>[review_api.py]"]
  node_security_scan["Security scan workflow<br/>[scan.js]"]
  node_security_results["Scan results<br/>[hooks.py]"]
  node_hook_events["Hookify events<br/>[pretooluse.py]"]
  node_hook_rules["Rule engine<br/>[rule_engine.py]"]
  node_hook_config["Rule configuration<br/>[config_loader.py]"]
end

subgraph group_utilities["Skills And Utilities"]
  node_session_report["Session analysis"]
  node_skill_creator["Skill creator tools<br/>[run_eval.py]"]
  node_transcript_mining["Transcript mining"]
  node_proof_ledger["Proof ledger<br/>[ledger.py]"]
end

node_user(("Claude Code user"))

node_user -->|"installs or discovers"| node_plugin_system
node_plugin_system -->|"loads plugin"| node_modernize_hooks
node_plugin_system -.->|"loads plugin"| node_security_hook
node_plugin_system -.->|"runs workflow"| node_security_scan
node_plugin_system -.->|"runs hooks"| node_hook_events
node_plugin_system -->|"configures optional MCP"| node_external_servers
node_external_servers -.->|"hosts"| node_discord
node_external_servers -.->|"hosts"| node_fakechat
node_external_servers -.->|"hosts"| node_imessage
node_external_servers -.->|"hosts"| node_telegram
node_modernize_hooks -->|"reads progress"| node_progress
node_modernize_hooks -->|"builds map"| node_estate
node_modernize_hooks -->|"tracks agents"| node_fleet
node_modernize_hooks -->|"renders view"| node_pane
node_estate -->|"uses units"| node_estate_model
node_estate_model -->|"maps files"| node_topology
node_progress -->|"reads units"| node_estate_model
node_progress -->|"reads transformed state"| node_modernized_state
node_progress -->|"parses rules"| node_rules
node_pane -->|"renders progress"| node_progress
node_pane -->|"renders map"| node_estate
node_pane -->|"renders activity"| node_fleet
node_security_hook -->|"requests analysis"| node_security_llm
node_review_api -->|"delegates analysis"| node_security_llm
node_security_scan -.->|"runs scan hooks"| node_security_results
node_hook_events -->|"loads rules"| node_hook_config
node_hook_events -->|"evaluates input"| node_hook_rules
node_hook_rules -->|"uses configuration"| node_hook_config
node_user -.->|"uses skill"| node_session_report
node_user -.->|"uses skill"| node_skill_creator
node_user -.->|"uses skill"| node_transcript_mining
node_user -.->|"uses skill"| node_proof_ledger

click node_discord "https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/discord/server.ts"
click node_fakechat "https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/fakechat/server.ts"
click node_imessage "https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/imessage/server.ts"
click node_telegram "https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/telegram/server.ts"
click node_modernize_hooks "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/register.ts"
click node_estate "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/map/estate.ts"
click node_estate_model "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/reader/estate-model.ts"
click node_topology "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/reader/topology.ts"
click node_progress "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/reader/progress.ts"
click node_modernized_state "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/reader/modernized.ts"
click node_rules "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/reader/rules.ts"
click node_fleet "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/fleet/fleet.ts"
click node_pane "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/views/pane.tsx"
click node_security_hook "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/security-guidance/hooks/security_reminder_hook.py"
click node_security_llm "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/security-guidance/hooks/llm.py"
click node_review_api "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/security-guidance/hooks/review_api.py"
click node_security_scan "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/claude-security/workflows/scan.js"
click node_security_results "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/claude-security/hooks/hooks.py"
click node_hook_events "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/hookify/hooks/pretooluse.py"
click node_hook_rules "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/hookify/core/rule_engine.py"
click node_hook_config "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/hookify/core/config_loader.py"
click node_session_report "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/session-report/skills/session-report/analyze-sessions.mjs"
click node_skill_creator "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/skill-creator/skills/skill-creator/scripts/run_eval.py"
click node_transcript_mining "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/receipts/skills/receipts/scripts/mine-transcripts.mjs"
click node_proof_ledger "https://github.com/anthropics/claude-plugins-official/blob/main/plugins/math-proof/skills/siege/scripts/ledger.py"

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_system,node_external_servers,node_discord,node_fakechat,node_imessage,node_telegram,node_user toneBlue
class node_modernize_hooks,node_estate,node_estate_model,node_topology,node_progress,node_modernized_state,node_rules,node_fleet,node_pane toneAmber
class node_security_hook,node_security_llm,node_review_api,node_security_scan,node_security_results,node_hook_events,node_hook_rules,node_hook_config toneMint
class node_session_report,node_skill_creator,node_transcript_mining,node_proof_ledger toneRose
```

## Components

### Plugin Catalog

- **Plugin system**
- **Chat MCP servers**
- [Discord server](https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/discord/server.ts): `external_plugins/discord/server.ts`
- [Fakechat server](https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/fakechat/server.ts): `external_plugins/fakechat/server.ts`
- [iMessage server](https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/imessage/server.ts): `external_plugins/imessage/server.ts`
- [Telegram server](https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/telegram/server.ts): `external_plugins/telegram/server.ts`

### Code Modernization

- [Modernization hooks](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/register.ts): `plugins/code-modernization/hooks/register.ts`
- [Codebase map](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/map/estate.ts): `plugins/code-modernization/hooks/map/estate.ts`
- [Code units](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/reader/estate-model.ts): `plugins/code-modernization/hooks/reader/estate-model.ts`
- [Repository topology](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/reader/topology.ts): `plugins/code-modernization/hooks/reader/topology.ts`
- [Workflow progress](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/reader/progress.ts): `plugins/code-modernization/hooks/reader/progress.ts`
- [Transformed state](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/reader/modernized.ts): `plugins/code-modernization/hooks/reader/modernized.ts`
- [Business rules](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/reader/rules.ts): `plugins/code-modernization/hooks/reader/rules.ts`
- [Agent activity](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/fleet/fleet.ts): `plugins/code-modernization/hooks/fleet/fleet.ts`
- [Status pane](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/code-modernization/hooks/views/pane.tsx): `plugins/code-modernization/hooks/views/pane.tsx`

### Security Plugins

- [Security reminder](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/security-guidance/hooks/security_reminder_hook.py): `plugins/security-guidance/hooks/security_reminder_hook.py`
- [LLM analysis](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/security-guidance/hooks/llm.py): `plugins/security-guidance/hooks/llm.py`
- [Review API](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/security-guidance/hooks/review_api.py): `plugins/security-guidance/hooks/review_api.py`
- [Security scan workflow](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/claude-security/workflows/scan.js): `plugins/claude-security/workflows/scan.js`
- [Scan results](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/claude-security/hooks/hooks.py): `plugins/claude-security/hooks/hooks.py`
- [Hookify events](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/hookify/hooks/pretooluse.py): `plugins/hookify/hooks/pretooluse.py`
- [Rule engine](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/hookify/core/rule_engine.py): `plugins/hookify/core/rule_engine.py`
- [Rule configuration](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/hookify/core/config_loader.py): `plugins/hookify/core/config_loader.py`

### Skills And Utilities

- [Session analysis](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/session-report/skills/session-report/analyze-sessions.mjs): `plugins/session-report/skills/session-report/analyze-sessions.mjs`
- [Skill creator tools](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/skill-creator/skills/skill-creator/scripts/run_eval.py): `plugins/skill-creator/skills/skill-creator/scripts/run_eval.py`
- [Transcript mining](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/receipts/skills/receipts/scripts/mine-transcripts.mjs): `plugins/receipts/skills/receipts/scripts/mine-transcripts.mjs`
- [Proof ledger](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/math-proof/skills/siege/scripts/ledger.py): `plugins/math-proof/skills/siege/scripts/ledger.py`

### Other components

- **Claude Code user**

## Connections

- Claude Code user → Plugin system: installs or discovers
- Plugin system → Modernization hooks: loads plugin (evidence: `plugins/code-modernization/hooks/register.ts`)
- Plugin system → Security reminder: loads plugin
- Plugin system → Security scan workflow: runs workflow
- Plugin system → Hookify events: runs hooks
- Plugin system → Chat MCP servers: configures optional MCP
- Chat MCP servers → Discord server: hosts
- Chat MCP servers → Fakechat server: hosts
- Chat MCP servers → iMessage server: hosts
- Chat MCP servers → Telegram server: hosts
- Modernization hooks → Workflow progress: reads progress (evidence: `plugins/code-modernization/hooks/register.ts`)
- Modernization hooks → Codebase map: builds map (evidence: `plugins/code-modernization/hooks/register.ts`)
- Modernization hooks → Agent activity: tracks agents (evidence: `plugins/code-modernization/hooks/register.ts`)
- Modernization hooks → Status pane: renders view (evidence: `plugins/code-modernization/hooks/register.ts`)
- Codebase map → Code units: uses units (evidence: `plugins/code-modernization/hooks/map/estate.ts`)
- Code units → Repository topology: maps files (evidence: `plugins/code-modernization/hooks/reader/estate-model.ts`)
- Workflow progress → Code units: reads units (evidence: `plugins/code-modernization/hooks/reader/progress.ts`)
- Workflow progress → Transformed state: reads transformed state (evidence: `plugins/code-modernization/hooks/reader/progress.ts`)
- Workflow progress → Business rules: parses rules (evidence: `plugins/code-modernization/hooks/reader/progress.ts`)
- Status pane → Workflow progress: renders progress (evidence: `plugins/code-modernization/hooks/views/pane.tsx`)
- Status pane → Codebase map: renders map (evidence: `plugins/code-modernization/hooks/views/pane.tsx`)
- Status pane → Agent activity: renders activity (evidence: `plugins/code-modernization/hooks/views/pane.tsx`)
- Security reminder → LLM analysis: requests analysis (evidence: `plugins/security-guidance/hooks/security_reminder_hook.py`)
- Review API → LLM analysis: delegates analysis (evidence: `plugins/security-guidance/hooks/review_api.py`)
- Security scan workflow → Scan results: runs scan hooks
- Hookify events → Rule configuration: loads rules (evidence: `plugins/hookify/hooks/pretooluse.py`)
- Hookify events → Rule engine: evaluates input (evidence: `plugins/hookify/hooks/pretooluse.py`)
- Rule engine → Rule configuration: uses configuration (evidence: `plugins/hookify/core/rule_engine.py`)
- Claude Code user → Session analysis: uses skill
- Claude Code user → Skill creator tools: uses skill
- Claude Code user → Transcript mining: uses skill
- Claude Code user → Proof ledger: uses skill
