# itachi-1824/claude-god-mode architecture

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

- Interactive diagram: https://gitdiagram.com/itachi-1824/claude-god-mode
- Repository: https://github.com/itachi-1824/claude-god-mode

## Overview

Claude God Mode is a drop-in Claude Code optimization toolkit. Users install its configuration and agents, then Claude Code can apply token-reduction integrations automatically and delegate reasoning, review, research, and UI work to specialized agents. Its sampled runtime hooks also intercept selected Bash, Grep, and Glob searches to steer code-symbol navigation toward Serena. The README documents broader integrations and capabilities than the sampled source shows; those relationships are represented as documented or unverified rather than inferred from implementation.

Main entry points: [`README.md`](https://github.com/itachi-1824/claude-god-mode/blob/main/README.md) (Token Reduction), [`hooks/serena-bash-guard.js`](https://github.com/itachi-1824/claude-god-mode/blob/main/hooks/serena-bash-guard.js) (Bash Search Guard), [`hooks/serena-grep-guard.js`](https://github.com/itachi-1824/claude-god-mode/blob/main/hooks/serena-grep-guard.js) (Grep Symbol Guard), [`hooks/serena-glob-guard.js`](https://github.com/itachi-1824/claude-god-mode/blob/main/hooks/serena-glob-guard.js) (Glob Symbol Guard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agent_capabilities["Quality Agents"]
  node_agent_library["Specialist Agents"]
end

subgraph group_token_optimization["Token Pipeline"]
  node_token_pipeline["Token Reduction<br/>[README.md]"]
end

subgraph group_runtime_guidance["Runtime Guidance"]
  node_bash_guard["Bash Search Guard"]
  node_grep_guard["Grep Symbol Guard"]
  node_glob_guard["Glob Symbol Guard"]
  node_tool_config["Claude Configuration<br/>[CLAUDE.md.template]"]
end

subgraph group_tool_integrations["External Tools"]
  node_rtk["RTK"]
  node_jcodemunch["jCodeMunch"]
  node_context_mode["Context Mode"]
  node_mcp_compressor["MCP Compressor"]
  node_cozempic["Cozempic"]
  node_headroom["Headroom"]
  node_caveman["Caveman"]
  node_serena["Serena"]
  node_docfork["Docfork"]
  node_claude_mem["claude-mem"]
  node_semgrep["Semgrep"]
end

node_user(("Claude Code User"))
node_claude_code["Claude Code"]

node_user -->|"prompts"| node_claude_code
node_claude_code -->|"delegates to"| node_agent_library
node_claude_code -->|"applies"| node_token_pipeline
node_token_pipeline -->|"compresses CLI"| node_rtk
node_token_pipeline -->|"indexes code"| node_jcodemunch
node_token_pipeline -->|"sandboxes output"| node_context_mode
node_token_pipeline -->|"compresses data"| node_mcp_compressor
node_token_pipeline -->|"prunes context"| node_cozempic
node_token_pipeline -->|"compresses prompts"| node_headroom
node_token_pipeline -->|"reduces verbosity"| node_caveman
node_token_pipeline -->|"navigates symbols"| node_serena
node_token_pipeline -->|"fetches docs"| node_docfork
node_token_pipeline -->|"retains memory"| node_claude_mem
node_token_pipeline -->|"checks security"| node_semgrep
node_claude_code -->|"uses guidance"| node_tool_config
node_claude_code -.->|"invokes hook"| node_bash_guard
node_bash_guard -->|"suggests navigation"| node_serena
node_claude_code -.->|"invokes hook"| node_grep_guard
node_grep_guard -->|"suggests navigation"| node_serena
node_claude_code -.->|"invokes hook"| node_glob_guard
node_glob_guard -->|"suggests navigation"| node_serena

click node_agent_library "https://github.com/itachi-1824/claude-god-mode/tree/main/agents"
click node_token_pipeline "https://github.com/itachi-1824/claude-god-mode/blob/main/README.md"
click node_bash_guard "https://github.com/itachi-1824/claude-god-mode/blob/main/hooks/serena-bash-guard.js"
click node_grep_guard "https://github.com/itachi-1824/claude-god-mode/blob/main/hooks/serena-grep-guard.js"
click node_glob_guard "https://github.com/itachi-1824/claude-god-mode/blob/main/hooks/serena-glob-guard.js"
click node_tool_config "https://github.com/itachi-1824/claude-god-mode/blob/main/config/CLAUDE.md.template"

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_agent_library,node_user toneBlue
class node_token_pipeline toneAmber
class node_bash_guard,node_grep_guard,node_glob_guard,node_tool_config toneMint
class node_rtk,node_jcodemunch,node_context_mode,node_mcp_compressor,node_cozempic,node_headroom,node_caveman,node_serena,node_docfork,node_claude_mem,node_semgrep toneRose
class node_claude_code toneIndigo
```

## Components

### Quality Agents

- [Specialist Agents](https://github.com/itachi-1824/claude-god-mode/tree/main/agents): `agents`

### Token Pipeline

- [Token Reduction](https://github.com/itachi-1824/claude-god-mode/blob/main/README.md): `README.md`

### Runtime Guidance

- [Bash Search Guard](https://github.com/itachi-1824/claude-god-mode/blob/main/hooks/serena-bash-guard.js): `hooks/serena-bash-guard.js`
- [Grep Symbol Guard](https://github.com/itachi-1824/claude-god-mode/blob/main/hooks/serena-grep-guard.js): `hooks/serena-grep-guard.js`
- [Glob Symbol Guard](https://github.com/itachi-1824/claude-god-mode/blob/main/hooks/serena-glob-guard.js): `hooks/serena-glob-guard.js`
- [Claude Configuration](https://github.com/itachi-1824/claude-god-mode/blob/main/config/CLAUDE.md.template): `config/CLAUDE.md.template`

### External Tools

- **RTK**
- **jCodeMunch**
- **Context Mode**
- **MCP Compressor**
- **Cozempic**
- **Headroom**
- **Caveman**
- **Serena**
- **Docfork**
- **claude-mem**
- **Semgrep**

### Other components

- **Claude Code User**
- **Claude Code**

## Connections

- Claude Code User → Claude Code: prompts (evidence: `README.md`)
- Claude Code → Specialist Agents: delegates to (evidence: `README.md`)
- Claude Code → Token Reduction: applies (evidence: `README.md`)
- Token Reduction → RTK: compresses CLI (evidence: `README.md`)
- Token Reduction → jCodeMunch: indexes code (evidence: `README.md`)
- Token Reduction → Context Mode: sandboxes output (evidence: `README.md`)
- Token Reduction → MCP Compressor: compresses data (evidence: `README.md`)
- Token Reduction → Cozempic: prunes context (evidence: `README.md`)
- Token Reduction → Headroom: compresses prompts (evidence: `README.md`)
- Token Reduction → Caveman: reduces verbosity (evidence: `README.md`)
- Token Reduction → Serena: navigates symbols (evidence: `README.md`)
- Token Reduction → Docfork: fetches docs (evidence: `README.md`)
- Token Reduction → claude-mem: retains memory (evidence: `README.md`)
- Token Reduction → Semgrep: checks security (evidence: `README.md`)
- Claude Code → Claude Configuration: uses guidance (evidence: `README.md`)
- Claude Code → Bash Search Guard: invokes hook
- Bash Search Guard → Serena: suggests navigation (evidence: `hooks/serena-bash-guard.js`)
- Claude Code → Grep Symbol Guard: invokes hook
- Grep Symbol Guard → Serena: suggests navigation (evidence: `hooks/serena-grep-guard.js`)
- Claude Code → Glob Symbol Guard: invokes hook
- Glob Symbol Guard → Serena: suggests navigation (evidence: `hooks/serena-glob-guard.js`)
