# shareai-lab/analysis_claude_code architecture

> Architecture diagram of the GitHub repository shareai-lab/analysis_claude_code, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shareai-lab/analysis_claude_code
- Repository: https://github.com/shareai-lab/analysis_claude_code

## Overview

##### Project type and purpose
- This is a reverse-engineering research repository for “Claude Code v1.0.33.”
- It collects analysis scripts, de-obfuscated source chunks, merged results, extensive technical docs, and open-rebuild templates.
- Its goal is to reveal the internal architecture of a modern AI Agent system (the “Claude Code Agent”) and provide guidance for reimplementation.

##### High-level file structure and roles
- **claude_code_v_1.0.33/** – Main analysis workspace
- source/ – Original obfuscated CLI code
- scripts/ – Pre-processing & LLM-assisted analysis tools (beautify, split, merge, LLM calls)
- chunks/ – 102 de-obfuscated code blocks + index
- analysis_results/merged-chunks/ – Optimized merged code
- docs/ – Dozens of deep-dive technical write-ups on each mechanism
- **work_doc_for_this/** – Your SOPs and prompt templates for driving the analysis
- **README.md** & **LICENSE** – Overview, architecture summary, project metadata
- **Open-rebuild folders (Demo_Repo, Open-Claude-Code)** – TypeScript templates, tests, and implementation guides

##### Key insights from the README
- The README contains an ASCII art “Claude Code Agent 系统架构” showing a classic 4-layer design:
1. User Interaction Layer (CLI, VSCode, Web)
2. Agent Core Scheduling Layer (nO loop, h2A queue, stream gen, compressor)
3. Tool Execution & Management Layer (ToolEngine, Scheduler, SubAgents, Permission Gateway, plus an ecosystem of file/network/task tools)
4. Storage & Persistence Layer (short-term, compressed history, long-term, state cache)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User Interaction Layer
    subgraph "User Interaction Layer"
        CLI["CLI Interface"]:::frontend
        IDE["VSCode & Web UI"]:::frontend
    end

    %% Agent Core Scheduling Layer
    subgraph "Agent Core Scheduling Layer"
        NO["nO Main Loop"]:::processing
        H2A["h2A Message Queue"]:::processing
        STREAM["Stream Generator"]:::processing
        COMP["Compressor"]:::processing
    end

    %% Tool Execution & Management Layer
    subgraph "Tool Execution & Management Layer"
        TE["ToolEngine"]:::processing
        SCH["Scheduler (UH1)"]:::processing
        SA["SubAgents"]:::processing
        PG["Permission Gateway"]:::processing
    end

    %% Tool Ecosystem
    subgraph "Tool Ecosystem"
        BASH["Bash Tool"]:::integration
        READ["Read Tool"]:::integration
        WRITE["Write Tool"]:::integration
        GREP["Grep Tool"]:::integration
        WEBF["WebFetch Tool"]:::integration
        WEBS["WebSearch Tool"]:::integration
        TODO["Todo Tool"]:::integration
        TASK["Task Tool"]:::integration
    end

    %% Storage & Persistence Layer
    subgraph "Storage & Persistence Layer"
        MQS["Queue Storage"]:::storage
        CH["Compressed History"]:::storage
        CS["State Cache"]:::storage
    end

    %% Analysis Pipeline
    subgraph "Analysis Pipeline"
        BEAUTIFY["beautify.js"]:::processing
        SPLIT["split.js"]:::processing
        MERGE["merge-again.js"]:::processing
        LLM["llm.js"]:::processing
        IMPROVE["improve-merged-chunks.js"]:::processing
        CHUNKINDEX["chunks.index.json"]:::storage
        CHUNKS["De-Obfuscated Chunks"]:::storage
        MERGEDCODE["Merged & Optimized Code"]:::storage
        DEMO["Demo_Repo Template"]:::integration
        SOP1["CLAUDE_CODE_REVERSE_SOP.md"]:::storage
        SOP2["ATHENA_RECONSTRUCTOR_SOP.md"]:::storage
    end

    %% Connections
    CLI -->|control| NO
    IDE -->|control| NO
    NO -->|enqueue| H2A
    H2A -->|stream| STREAM
    STREAM -->|compress_trigger| COMP
    NO -->|dispatch| TE
    TE -->|schedule| SCH
    SCH -->|spawn| SA
    SA -->|authorize| PG
    PG -->|execute| BASH & READ & WRITE & GREP & WEBF & WEBS & TODO & TASK
    BASH & READ & WRITE & GREP & WEBF & WEBS & TODO & TASK -->|results| TE
    NO <-->|"read/write context"| MQS
    COMP <-->|"store history"| CH
    COMP <-->|"state update"| CS
    NO -->|results| CLI
    NO -->|results| IDE

    BEAUTIFY --> SPLIT --> CHUNKS --> MERGE --> IMPROVE --> MERGEDCODE
    MERGEDCODE -->|reference| docs["docs/"]:::integration
    DEMO -->|template| TE
    SOP1 & SOP2 --> BEAUTIFY

    %% Click Events
    click CLI "https://github.com/shareai-lab/analysis_claude_code/blob/main/claude_code_v_1.0.33/stage1_analysis_workspace/source/cli.mjs"
    click IDE "https://github.com/shareai-lab/analysis_claude_code/blob/main/claude_code_v_1.0.33/stage1_analysis_workspace/docs/Claude_Code_IDE_Connection_and_Interaction_Deep_Analysis.md"
    click NO "https://github.com/shareai-lab/analysis_claude_code/blob/main/claude_code_v_1.0.33/stage1_analysis_workspace/chunks/cli.chunks.mjs"
    click MERGEDCODE "https://github.com/shareai-lab/analysis_claude_code/blob/main/claude_code_v_1.0.33/stage1_analysis_workspace/analysis_results/merged-chunks/improved-claude-code-*.mjs"
    click H2A "https://github.com/shareai-lab/analysis_claude_code/blob/main/docs/Open-Claude-Code/src/core/message-queue.ts"
    click STREAM "https://github.com/shareai-lab/analysis_claude_code/blob/main/docs/Open-Claude-Code/src/core/agent-core.md"
    click MQS "https://github.com/shareai-lab/analysis_claude_code/blob/main/docs/Open-Claude-Code/src/core/message-queue.md"
    click CH "https://github.com/shareai-lab/analysis_claude_code/blob/main/claude_code_v_1.0.33/stage1_analysis_workspace/docs/static_analysis_reports/H2_MEMORY_CONTEXT_MANAGEMENT.md"
    click CS "https://github.com/shareai-lab/analysis_claude_code/blob/main/claude_code_v_1.0.33/stage1_analysis_workspace/docs/static_analysis_reports/H2_CONTEXT_MEMORY.md"
    click TE "https://github.com/shareai-lab/analysis_claude_code/blob/main/docs/Open-Claude-Code/src/core/integrations.ts"
    click DEMO "https://github.com/shareai-lab/analysis_claude_code/blob/main/claude_code_v_1.0.33/stage1_analysis_workspace/docs/Demo_Repo/src/core/agent-core.md"
    click SOP1 "https://github.com/shareai-lab/analysis_claude_code/blob/main/work_doc_for_this/CLAUDE_CODE_REVERSE_SOP.md"
    click SOP2 "https://github.com/shareai-lab/analysis_claude_code/blob/main/work_doc_for_this/ATHENA_RECONSTRUCTOR_SOP.md"
    click BEAUTIFY "https://github.com/shareai-lab/analysis_claude_code/blob/main/claude_code_v_1.0.33/stage1_analysis_workspace/scripts/beautify.js"
    click SPLIT "https://github.com/shareai-lab/analysis_claude_code/blob/main/claude_code_v_1.0.33/stage1_analysis_workspace/scripts/split.js"
    click MERGE "https://github.com/shareai-lab/analysis_claude_code/blob/main/claude_code_v_1.0.33/stage1_analysis_workspace/scripts/merge-again.js"
    click LLM "https://github.com/shareai-lab/analysis_claude_code/blob/main/claude_code_v_1.0.33/stage1_analysis_workspace/scripts/llm.js"
    click IMPROVE "https://github.com/shareai-lab/analysis_claude_code/blob/main/claude_code_v_1.0.33/stage1_analysis_workspace/scripts/improve-merged-chunks.js"
    click CHUNKINDEX "https://github.com/shareai-lab/analysis_claude_code/blob/main/claude_code_v_1.0.33/stage1_analysis_workspace/chunks/chunks.index.json"
    click BASH "https://github.com/shareai-lab/analysis_claude_code/blob/main/docs/Open-Claude-Code/src/tools/implementations/bash-tool.md"
    click READ "https://github.com/shareai-lab/analysis_claude_code/blob/main/docs/Open-Claude-Code/src/tools/implementations/read-tool.md"
    click WRITE "https://github.com/shareai-lab/analysis_claude_code/blob/main/docs/Open-Claude-Code/src/tools/implementations/write-tool.md"
    click GREP "https://github.com/shareai-lab/analysis_claude_code/blob/main/docs/Open-Claude-Code/src/tools/implementations/grep-tool.txt"
    click WEBF "https://github.com/shareai-lab/analysis_claude_code/blob/main/docs/Open-Claude-Code/src/tools/implementations/webfetch-tool.txt"
    click WEBS "https://github.com/shareai-lab/analysis_claude_code/blob/main/docs/Open-Claude-Code/src/tools/implementations/websearch-tool.txt"
    click TODO "https://github.com/shareai-lab/analysis_claude_code/blob/main/docs/Open-Claude-Code/src/tools/implementations/todo-tools.txt"
    click TASK "https://github.com/shareai-lab/analysis_claude_code/blob/main/docs/Open-Claude-Code/src/tools/implementations/task-tool.md"

    %% Styles
    classDef frontend fill:#9f6,stroke:#333,color:#000;
    classDef processing fill:#6cf,stroke:#333,color:#000;
    classDef integration fill:#fc6,stroke:#333,color:#000;
    classDef storage fill:#6f9,stroke:#333,color:#000;
```
