---
title: "💾 Layer 5: State Layer"
description: "<div align=\"center\">"
type: skill
canonical_url: https://claudary.paisolsolutions.com/skills/05-state-layer
source: "Claudary"
difficulty: intermediate
author: "Claude Code Knowledge Pack"
date: 2026-07-10T10:58:42.779Z
license: CC-BY-4.0
attribution: "💾 Layer 5: State Layer — Claudary (https://claudary.paisolsolutions.com/skills/05-state-layer)"
---

# 💾 Layer 5: State Layer
<div align="center">

## Overview

<div align="center">

[🏠 Home](../../README.md) › [🔧 Implementation](../README.md) › [🏛️ Architecture](./) › **💾 Layer 5: State**

[← ⚡ Execution Layer](04-execution-layer.md) ━━━━━━━━━━━━━━━━━━━━━━━━━━●━━━━━━━━━ [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

```mermaid
%%{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.

```mermaid
%%{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

```json
{
  "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

```mermaid
%%{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               │
└─────────────────────────────────────────────────────┘
```

---

<div align="center">

[← ⚡ Execution Layer](04-execution-layer.md) ━━━━━━━━━━━━━━━━━━━━━━━━━━●━━━━━━━━━ [Architecture →](./)

</div>

---

Source: [Claudary](https://claudary.paisolsolutions.com/skills/05-state-layer) · https://claudary.paisolsolutions.com