# worldflowai/everything-claude-code architecture

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

- Interactive diagram: https://gitdiagram.com/worldflowai/everything-claude-code
- Repository: https://github.com/worldflowai/everything-claude-code
- Video tour (about a minute): https://gitdiagram.com/worldflowai/everything-claude-code/video

## Overview

Everything Claude Code is a Claude Code plugin that supplies commands, agents, skills, rules, contexts, hooks, and MCP configuration. The principal workflow is: a user starts a Claude session, invokes a command or delegates work, Claude loads the relevant guidance, performs the task, and returns a result. Lifecycle hooks preserve session state, surface learned skills, and suggest compaction. The sampled scripts confirm cross-platform persistence and package-manager detection; command and agent internals were not sampled, so those relationships remain intentionally high-level.

Main entry points: [`hooks/hooks.json`](https://github.com/worldflowai/everything-claude-code/blob/main/hooks/hooks.json) (Hook Configuration), [`scripts/hooks/session-start.js`](https://github.com/worldflowai/everything-claude-code/blob/main/scripts/hooks/session-start.js) (Session Start), [`scripts/lib/utils.js`](https://github.com/worldflowai/everything-claude-code/blob/main/scripts/lib/utils.js) (Cross-Platform Utilities), [`scripts/hooks/evaluate-session.js`](https://github.com/worldflowai/everything-claude-code/blob/main/scripts/hooks/evaluate-session.js) (Learning Evaluator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Plugin Interface"]
  node_plugin["Plugin Manifest<br/>[plugin.json]"]
  node_commands["Slash Commands"]
  node_agents["Specialized Agents"]
  node_mcp["MCP Configurations<br/>[mcp-servers.json]"]
end

subgraph group_guidance["Guidance Assets"]
  node_skills["Workflow Skills"]
  node_rules["Project Rules"]
  node_contexts["Prompt Contexts"]
end

subgraph group_automation["Lifecycle Automation"]
  node_hooks["Hook Configuration<br/>[hooks.json]"]
  node_session_start["Session Start<br/>[session-start.js]"]
  node_session_end["Session End<br/>[session-end.js]"]
  node_precompact["Pre-Compact Save<br/>[pre-compact.js]"]
  node_learning_eval["Learning Evaluator"]
  node_compact_suggester["Compact Suggester<br/>[suggest-compact.js]"]
end

subgraph group_state["State Integrations"]
  node_utils["Cross-Platform Utilities<br/>[utils.js]"]
  node_sessions["Session Files<br/>[utils.js]"]
  node_learned_skills["Learned Skills<br/>[utils.js]"]
  node_pm_setup["Package Setup"]
  node_pm_resolver["Package Resolver<br/>[package-manager.js]"]
  node_pm_config["Project PM Config"]
end

node_user(("Developer"))
node_claude(("Claude Code"))
node_mcp_services{{"MCP Services"}}
node_transcript["Session Transcript"]

node_user -->|"starts session"| node_claude
node_claude -->|"loads plugin"| node_plugin
node_claude -->|"dispatches commands"| node_commands
node_claude -->|"delegates work"| node_agents
node_claude -->|"loads guidance"| node_skills
node_claude -->|"applies rules"| node_rules
node_claude -->|"injects context"| node_contexts
node_claude -->|"runs lifecycle"| node_hooks
node_claude -.->|"loads integrations"| node_mcp
node_mcp -.->|"connects services"| node_mcp_services
node_hooks -->|"dispatches start"| node_session_start
node_hooks -->|"dispatches stop"| node_session_end
node_hooks -->|"dispatches compact"| node_precompact
node_hooks -->|"dispatches learning"| node_learning_eval
node_hooks -->|"dispatches suggestions"| node_compact_suggester
node_session_start -->|"uses utilities"| node_utils
node_session_start -->|"reads recent files"| node_sessions
node_session_start -->|"reads learned skills"| node_learned_skills
node_session_start -->|"detects manager"| node_pm_resolver
node_session_end -->|"uses utilities"| node_utils
node_session_end -->|"writes session state"| node_sessions
node_precompact -->|"uses utilities"| node_utils
node_precompact -->|"logs compaction"| node_sessions
node_learning_eval -->|"reads transcript"| node_transcript
node_learning_eval -->|"counts messages"| node_utils
node_learning_eval -->|"signals extraction"| node_learned_skills
node_compact_suggester -->|"tracks tool calls"| node_utils
node_compact_suggester -->|"suggests compaction"| node_claude
node_pm_setup -->|"selects manager"| node_pm_resolver
node_pm_setup -->|"writes preference"| node_pm_config
node_pm_resolver -->|"reads preference"| node_pm_config

click node_plugin "https://github.com/worldflowai/everything-claude-code/blob/main/.claude-plugin/plugin.json"
click node_commands "https://github.com/worldflowai/everything-claude-code/tree/main/commands"
click node_agents "https://github.com/worldflowai/everything-claude-code/tree/main/agents"
click node_skills "https://github.com/worldflowai/everything-claude-code/tree/main/skills"
click node_rules "https://github.com/worldflowai/everything-claude-code/tree/main/rules"
click node_contexts "https://github.com/worldflowai/everything-claude-code/tree/main/contexts"
click node_hooks "https://github.com/worldflowai/everything-claude-code/blob/main/hooks/hooks.json"
click node_session_start "https://github.com/worldflowai/everything-claude-code/blob/main/scripts/hooks/session-start.js"
click node_session_end "https://github.com/worldflowai/everything-claude-code/blob/main/scripts/hooks/session-end.js"
click node_precompact "https://github.com/worldflowai/everything-claude-code/blob/main/scripts/hooks/pre-compact.js"
click node_learning_eval "https://github.com/worldflowai/everything-claude-code/blob/main/scripts/hooks/evaluate-session.js"
click node_compact_suggester "https://github.com/worldflowai/everything-claude-code/blob/main/scripts/hooks/suggest-compact.js"
click node_utils "https://github.com/worldflowai/everything-claude-code/blob/main/scripts/lib/utils.js"
click node_sessions "https://github.com/worldflowai/everything-claude-code/blob/main/scripts/lib/utils.js"
click node_learned_skills "https://github.com/worldflowai/everything-claude-code/blob/main/scripts/lib/utils.js"
click node_pm_setup "https://github.com/worldflowai/everything-claude-code/blob/main/scripts/setup-package-manager.js"
click node_pm_resolver "https://github.com/worldflowai/everything-claude-code/blob/main/scripts/lib/package-manager.js"
click node_pm_config "https://github.com/worldflowai/everything-claude-code/blob/main/.claude/package-manager.json"
click node_mcp "https://github.com/worldflowai/everything-claude-code/blob/main/mcp-configs/mcp-servers.json"

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_commands,node_agents,node_mcp toneBlue
class node_skills,node_rules,node_contexts toneAmber
class node_hooks,node_session_start,node_session_end,node_precompact,node_learning_eval,node_compact_suggester toneMint
class node_utils,node_sessions,node_learned_skills,node_pm_setup,node_pm_resolver,node_pm_config toneRose
class node_user,node_claude,node_mcp_services,node_transcript toneIndigo
```

## Components

### Plugin Interface

- [Plugin Manifest](https://github.com/worldflowai/everything-claude-code/blob/main/.claude-plugin/plugin.json): `.claude-plugin/plugin.json`
- [Slash Commands](https://github.com/worldflowai/everything-claude-code/tree/main/commands): `commands`
- [Specialized Agents](https://github.com/worldflowai/everything-claude-code/tree/main/agents): `agents`
- [MCP Configurations](https://github.com/worldflowai/everything-claude-code/blob/main/mcp-configs/mcp-servers.json): `mcp-configs/mcp-servers.json`

### Guidance Assets

- [Workflow Skills](https://github.com/worldflowai/everything-claude-code/tree/main/skills): `skills`
- [Project Rules](https://github.com/worldflowai/everything-claude-code/tree/main/rules): `rules`
- [Prompt Contexts](https://github.com/worldflowai/everything-claude-code/tree/main/contexts): `contexts`

### Lifecycle Automation

- [Hook Configuration](https://github.com/worldflowai/everything-claude-code/blob/main/hooks/hooks.json): `hooks/hooks.json`
- [Session Start](https://github.com/worldflowai/everything-claude-code/blob/main/scripts/hooks/session-start.js): `scripts/hooks/session-start.js`
- [Session End](https://github.com/worldflowai/everything-claude-code/blob/main/scripts/hooks/session-end.js): `scripts/hooks/session-end.js`
- [Pre-Compact Save](https://github.com/worldflowai/everything-claude-code/blob/main/scripts/hooks/pre-compact.js): `scripts/hooks/pre-compact.js`
- [Learning Evaluator](https://github.com/worldflowai/everything-claude-code/blob/main/scripts/hooks/evaluate-session.js): `scripts/hooks/evaluate-session.js`
- [Compact Suggester](https://github.com/worldflowai/everything-claude-code/blob/main/scripts/hooks/suggest-compact.js): `scripts/hooks/suggest-compact.js`

### State Integrations

- [Cross-Platform Utilities](https://github.com/worldflowai/everything-claude-code/blob/main/scripts/lib/utils.js): `scripts/lib/utils.js`
- [Session Files](https://github.com/worldflowai/everything-claude-code/blob/main/scripts/lib/utils.js): `scripts/lib/utils.js`
- [Learned Skills](https://github.com/worldflowai/everything-claude-code/blob/main/scripts/lib/utils.js): `scripts/lib/utils.js`
- [Package Setup](https://github.com/worldflowai/everything-claude-code/blob/main/scripts/setup-package-manager.js): `scripts/setup-package-manager.js`
- [Package Resolver](https://github.com/worldflowai/everything-claude-code/blob/main/scripts/lib/package-manager.js): `scripts/lib/package-manager.js`
- [Project PM Config](https://github.com/worldflowai/everything-claude-code/blob/main/.claude/package-manager.json): `.claude/package-manager.json`

### Other components

- **Developer**
- **Claude Code**
- **MCP Services**
- **Session Transcript**

## Connections

- Developer → Claude Code: starts session
- Claude Code → Plugin Manifest: loads plugin
- Claude Code → Slash Commands: dispatches commands
- Claude Code → Specialized Agents: delegates work
- Claude Code → Workflow Skills: loads guidance
- Claude Code → Project Rules: applies rules
- Claude Code → Prompt Contexts: injects context
- Claude Code → Hook Configuration: runs lifecycle
- Claude Code → MCP Configurations: loads integrations
- MCP Configurations → MCP Services: connects services
- Hook Configuration → Session Start: dispatches start
- Hook Configuration → Session End: dispatches stop
- Hook Configuration → Pre-Compact Save: dispatches compact
- Hook Configuration → Learning Evaluator: dispatches learning
- Hook Configuration → Compact Suggester: dispatches suggestions
- Session Start → Cross-Platform Utilities: uses utilities
- Session Start → Session Files: reads recent files
- Session Start → Learned Skills: reads learned skills
- Session Start → Package Resolver: detects manager
- Session End → Cross-Platform Utilities: uses utilities
- Session End → Session Files: writes session state
- Pre-Compact Save → Cross-Platform Utilities: uses utilities
- Pre-Compact Save → Session Files: logs compaction
- Learning Evaluator → Session Transcript: reads transcript
- Learning Evaluator → Cross-Platform Utilities: counts messages
- Learning Evaluator → Learned Skills: signals extraction
- Compact Suggester → Cross-Platform Utilities: tracks tool calls
- Compact Suggester → Claude Code: suggests compaction
- Package Setup → Package Resolver: selects manager
- Package Setup → Project PM Config: writes preference
- Package Resolver → Project PM Config: reads preference
