# windy3f3f3f3f/how-claude-code-works architecture

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

- Interactive diagram: https://gitdiagram.com/windy3f3f3f3f/how-claude-code-works
- Repository: https://github.com/windy3f3f3f3f/how-claude-code-works

## Overview

This repository is an educational architecture analysis, not Claude Code’s implementation. Its principal reader workflow is to follow the documented user-to-agent loop, then explore context, tools, and safety; the docs also cover broader capabilities such as memory, skills, collaboration, autonomy, and observability. The graph represents the system as described in the README, with chapter paths identifying where each topic is documented. No source excerpts were provided, so relationships rely on README evidence only.

Main entry points: [`docs/02-agent-loop.md`](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/02-agent-loop.md) (Agent loop), [`docs/04-tool-system.md`](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/04-tool-system.md) (Tool execution), [`docs/07-multi-agent.md`](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/07-multi-agent.md) (Multi-agent), [`docs/11-permission-security.md`](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/11-permission-security.md) (Permission system)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Agent loop"]
  node_session["Session manager<br/>[02-agent-loop.md]"]
  node_loop["Agent loop<br/>[02-agent-loop.md]"]
  node_api["Claude API<br/>[02-agent-loop.md]"]
  node_response["Response parsing<br/>[02-agent-loop.md]"]
  node_output["Stream output"]
end

subgraph group_context["Context and guidance"]
  node_context["Context engineering"]
  node_prompt["System prompt"]
  node_memory[("Memory system")]
  node_skills["Skills system"]
end

subgraph group_execution["Tools and safety"]
  node_tools["Tool execution<br/>[04-tool-system.md]"]
  node_filetools["File tools<br/>[04-tool-system.md]"]
  node_shell["Shell execution<br/>[04-tool-system.md]"]
  node_search["Search tools<br/>[04-tool-system.md]"]
  node_mcp["MCP tools<br/>[04-tool-system.md]"]
  node_permissions["Permission system"]
  node_rules["Permission rules"]
  node_bashast["Bash analysis"]
  node_confirmation["User confirmation"]
end

subgraph group_capabilities["Extended capabilities"]
  node_hooks["Hooks"]
  node_agents["Multi-agent<br/>[07-multi-agent.md]"]
  node_plan["Plan mode<br/>[10-plan-mode.md]"]
  node_tasks[("Task system<br/>[15-task-system.md]")]
  node_observability["Observability"]
  node_autonomy["Goal and loop"]
  node_workflows["Dynamic workflows"]
  node_teams["Agent teams<br/>[20-agent-teams.md]"]
  node_fleet["Background fleet"]
end

node_reader(("Developer"))

node_reader -->|"sends input"| node_session
node_session -->|"manages session"| node_loop
node_loop -->|"calls"| node_api
node_api -->|"returns response"| node_response
node_response -->|"streams text"| node_output
node_response -->|"dispatches calls"| node_tools
node_tools -->|"returns results"| node_loop
node_context -->|"supplies context"| node_loop
node_context -->|"builds prompts"| node_prompt
node_context -->|"uses memory"| node_memory
node_tools -->|"executes"| node_filetools
node_tools -->|"executes"| node_shell
node_tools -->|"executes"| node_search
node_tools -->|"executes"| node_mcp
node_permissions -->|"guards execution"| node_tools
node_permissions -->|"applies"| node_rules
node_permissions -->|"analyzes commands"| node_bashast
node_permissions -->|"requests approval"| node_confirmation
node_loop -->|"coordinates"| node_agents
node_agents -->|"coordinates tasks"| node_tasks
node_loop -->|"supports planning"| node_plan
node_loop -->|"uses skills"| node_skills
node_tools -->|"runs hooks"| node_hooks
node_loop -->|"emits telemetry"| node_observability
node_loop -->|"supports continuation"| node_autonomy
node_agents -->|"extends orchestration"| node_workflows
node_agents -->|"supports teams"| node_teams
node_agents -->|"supports background work"| node_fleet

click node_session "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/02-agent-loop.md"
click node_loop "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/02-agent-loop.md"
click node_api "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/02-agent-loop.md"
click node_response "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/02-agent-loop.md"
click node_output "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/12-user-experience.md"
click node_context "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/03-context-engineering.md"
click node_prompt "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/14-system-prompt-design.md"
click node_memory "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/08-memory-system.md"
click node_skills "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/09-skills-system.md"
click node_tools "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/04-tool-system.md"
click node_filetools "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/04-tool-system.md"
click node_shell "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/04-tool-system.md"
click node_search "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/04-tool-system.md"
click node_mcp "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/04-tool-system.md"
click node_permissions "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/11-permission-security.md"
click node_rules "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/11-permission-security.md"
click node_bashast "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/11-permission-security.md"
click node_confirmation "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/11-permission-security.md"
click node_hooks "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/06-hooks-extensibility.md"
click node_agents "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/07-multi-agent.md"
click node_plan "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/10-plan-mode.md"
click node_tasks "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/15-task-system.md"
click node_observability "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/16-observability.md"
click node_autonomy "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/17-autonomy-goal-loop.md"
click node_workflows "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/19-dynamic-workflows.md"
click node_teams "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/20-agent-teams.md"
click node_fleet "https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/21-background-fleet.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_session,node_loop,node_api,node_response,node_output toneBlue
class node_context,node_prompt,node_memory,node_skills toneAmber
class node_tools,node_filetools,node_shell,node_search,node_mcp,node_permissions,node_rules,node_bashast,node_confirmation toneMint
class node_hooks,node_agents,node_plan,node_tasks,node_observability,node_autonomy,node_workflows,node_teams,node_fleet toneRose
class node_reader toneIndigo
```

## Components

### Agent loop

- [Session manager](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/02-agent-loop.md): `docs/02-agent-loop.md`
- [Agent loop](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/02-agent-loop.md): `docs/02-agent-loop.md`
- [Claude API](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/02-agent-loop.md): `docs/02-agent-loop.md`
- [Response parsing](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/02-agent-loop.md): `docs/02-agent-loop.md`
- [Stream output](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/12-user-experience.md): `docs/12-user-experience.md`

### Context and guidance

- [Context engineering](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/03-context-engineering.md): `docs/03-context-engineering.md`
- [System prompt](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/14-system-prompt-design.md): `docs/14-system-prompt-design.md`
- [Memory system](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/08-memory-system.md): `docs/08-memory-system.md`
- [Skills system](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/09-skills-system.md): `docs/09-skills-system.md`

### Tools and safety

- [Tool execution](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/04-tool-system.md): `docs/04-tool-system.md`
- [File tools](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/04-tool-system.md): `docs/04-tool-system.md`
- [Shell execution](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/04-tool-system.md): `docs/04-tool-system.md`
- [Search tools](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/04-tool-system.md): `docs/04-tool-system.md`
- [MCP tools](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/04-tool-system.md): `docs/04-tool-system.md`
- [Permission system](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/11-permission-security.md): `docs/11-permission-security.md`
- [Permission rules](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/11-permission-security.md): `docs/11-permission-security.md`
- [Bash analysis](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/11-permission-security.md): `docs/11-permission-security.md`
- [User confirmation](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/11-permission-security.md): `docs/11-permission-security.md`

### Extended capabilities

- [Hooks](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/06-hooks-extensibility.md): `docs/06-hooks-extensibility.md`
- [Multi-agent](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/07-multi-agent.md): `docs/07-multi-agent.md`
- [Plan mode](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/10-plan-mode.md): `docs/10-plan-mode.md`
- [Task system](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/15-task-system.md): `docs/15-task-system.md`
- [Observability](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/16-observability.md): `docs/16-observability.md`
- [Goal and loop](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/17-autonomy-goal-loop.md): `docs/17-autonomy-goal-loop.md`
- [Dynamic workflows](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/19-dynamic-workflows.md): `docs/19-dynamic-workflows.md`
- [Agent teams](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/20-agent-teams.md): `docs/20-agent-teams.md`
- [Background fleet](https://github.com/windy3f3f3f3f/how-claude-code-works/blob/main/docs/21-background-fleet.md): `docs/21-background-fleet.md`

### Other components

- **Developer**

## Connections

- Developer → Session manager: sends input (evidence: `README.md`)
- Session manager → Agent loop: manages session (evidence: `README.md`)
- Agent loop → Claude API: calls (evidence: `README.md`)
- Claude API → Response parsing: returns response (evidence: `README.md`)
- Response parsing → Stream output: streams text (evidence: `README.md`)
- Response parsing → Tool execution: dispatches calls (evidence: `README.md`)
- Tool execution → Agent loop: returns results (evidence: `README.md`)
- Context engineering → Agent loop: supplies context (evidence: `README.md`)
- Context engineering → System prompt: builds prompts (evidence: `README.md`)
- Context engineering → Memory system: uses memory (evidence: `README.md`)
- Tool execution → File tools: executes (evidence: `README.md`)
- Tool execution → Shell execution: executes (evidence: `README.md`)
- Tool execution → Search tools: executes (evidence: `README.md`)
- Tool execution → MCP tools: executes (evidence: `README.md`)
- Permission system → Tool execution: guards execution (evidence: `README.md`)
- Permission system → Permission rules: applies (evidence: `README.md`)
- Permission system → Bash analysis: analyzes commands (evidence: `README.md`)
- Permission system → User confirmation: requests approval (evidence: `README.md`)
- Agent loop → Multi-agent: coordinates (evidence: `README.md`)
- Multi-agent → Task system: coordinates tasks (evidence: `README.md`)
- Agent loop → Plan mode: supports planning (evidence: `README.md`)
- Agent loop → Skills system: uses skills (evidence: `README.md`)
- Tool execution → Hooks: runs hooks (evidence: `README.md`)
- Agent loop → Observability: emits telemetry (evidence: `README.md`)
- Agent loop → Goal and loop: supports continuation (evidence: `README.md`)
- Multi-agent → Dynamic workflows: extends orchestration (evidence: `README.md`)
- Multi-agent → Agent teams: supports teams (evidence: `README.md`)
- Multi-agent → Background fleet: supports background work (evidence: `README.md`)
