Skillintermediate

💾 Layer 5: State Layer

Claude Code Knowledge Pack7/10/2026

Overview

🏠 Home › 🔧 Implementation › 🏛️ Architecture › 💾 Layer 5: State

← ⚡ Execution Layer ━━━━━━━━━━━━━━━━━━━━━━━━━━●━━━━━━━━━ Architecture →

</div>

💾 Layer 5: State Layer

Persistence, memory, and context management across interactions.

Purpose

The State Layer manages all persistent data and context. It enables sessions to maintain state, resume from interruptions, and share information across components.

Components

Component	Emoji	Type	Scope
Memory	💾	In-session context	Conversation
Files	📁	Persistent storage	Project
CLAUDE.md	📋	Project instructions	Project
Checkpoints	🖥️	Resume points	Workflow

State Flow Diagram

%%{init: {'theme': 'base', 'themeVariables': {'lineColor': '#64748b'}}}%%
flowchart TB
    classDef state fill:#10b981,stroke:#059669,stroke-width:2px,color:#ffffff
    classDef main fill:#8b5cf6,stroke:#7c3aed,stroke-width:2px,color:#ffffff
    classDef tool fill:#f59e0b,stroke:#d97706,stroke-width:2px,color:#ffffff

    subgraph StateLayer["💾 State Layer"]
        MEM["💾 Session Memory"]:::state
        FILES["📁 File System"]:::state
        CLAUDE["📋 CLAUDE.md"]:::state
        CHECK["🖥️ Checkpoints"]:::state
    end

    EXEC["⚡ Execution Layer"]:::tool -->|Reads/Writes| FILES
    EXEC -->|Updates| MEM
    EXEC -->|Saves| CHECK
    MA["🐔 Main Agent"]:::main -->|Loads| CLAUDE
    MA -->|Accesses| MEM
    MA -->|Resumes from| CHECK

    classDef stateBox fill:#ecfdf5,stroke:#10b981,stroke-width:2px,color:#065f46

    StateLayer:::stateBox

💾 Session Memory

In-session context that persists throughout a conversation.

What It Stores

Conversation history
Current task state
Intermediate results
User preferences from session

Scope

Lifetime: Single conversation session
Access: 🐔 Main Agent and 🐦 Subagents
Persistence: Lost when session ends

📁 File System

Persistent storage for project files and outputs.

Operations

Operation	Tool	Description
Read	🔧👀 `Read`	Load file contents
Write	🔧✏️ `Write`	Create/overwrite files
Edit	🔧✏️ `Edit`	Modify existing files
Search	🔧🗂️ `Glob`	Find files by pattern
Search	🔧🔍 `Grep`	Find content in files

Scope

Lifetime: Permanent (until deleted)
Access: All layers via tools
Persistence: Project-level

📋 CLAUDE.md

Project-specific instructions loaded at session start.

Hierarchy

~/.claude/CLAUDE.md           # Global (user-level)
./CLAUDE.md                   # Project root
./src/CLAUDE.md              # Directory-specific

Purpose

Define project conventions
Specify coding standards
Configure tool preferences
Set workflow defaults

🖥️ Checkpoints

Resume points for long-running workflows.

%%{init: {'theme': 'base', 'themeVariables': {'lineColor': '#64748b'}}}%%
flowchart LR
    classDef checkpoint fill:#f59e0b,stroke:#d97706,stroke-width:2px,color:#ffffff

    subgraph Workflow
        P1["🏗️ Phase 1"] --> CP1["🖥️ Checkpoint"]:::checkpoint
        CP1 --> P2["🔗 Phase 2"]
        P2 --> CP2["🖥️ Checkpoint"]:::checkpoint
        CP2 --> P3["📝 Phase 3"]
    end

    FAIL["❌ Failure/Interrupt"] -.->|Resume from| CP2

Checkpoint Data Structure

{
  "workflow_id": "wf_2025_001",
  "current_phase": 2,
  "completed_tasks": ["task_1", "task_2"],
  "pending_tasks": ["task_3", "task_4"],
  "state": {
    "variables": {},
    "context_summary": "..."
  },
  "resume_point": "checkpoint_2",
  "timestamp": "2025-11-28T10:00:00Z"
}

Use Cases

Scenario	Why Checkpoints?
Large-scale generation	1000+ files exceed context limits
Long research tasks	Days of research need persistence
Multi-day workflows	Cannot complete in single session
Error recovery	Resume after failures
Team handoffs	Different operators continue work

State Interaction Example

%%{init: {'theme': 'base', 'themeVariables': {'lineColor': '#64748b'}}}%%
sequenceDiagram
    participant MA as 🐔 Main Agent
    participant EL as ⚡ Execution
    participant SL as 💾 State Layer

    MA->>SL: Load 📋 CLAUDE.md
    SL-->>MA: Project instructions

    MA->>EL: Execute task
    EL->>SL: Read source files
    SL-->>EL: File contents

    EL->>SL: Write output files
    EL->>SL: Update 💾 memory

    MA->>SL: Save 🖥️ checkpoint
    SL-->>MA: Checkpoint saved

Layer Position

┌─────────────────────────────────────────────────────┐
│  ⚡ LAYER 4: EXECUTION LAYER                        │
│  🐦 Subagents, 🔧 Built-in, 🔌 External, 💁‍♀️ User   │
└─────────────────────────┬───────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────┐
│  💾 LAYER 5: STATE LAYER  ◄─── YOU ARE HERE        │
│  Memory, Files, Context - persistence               │
└─────────────────────────────────────────────────────┘

← ⚡ Execution Layer ━━━━━━━━━━━━━━━━━━━━━━━━━━●━━━━━━━━━ Architecture →

</div>