> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sense-lab.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Core Concepts

> Understand how AMFS stores, versions, and evolves knowledge.

Understanding the building blocks of AMFS.

AMFS treats each agent's knowledge as a **Git repository**. Every write is a versioned commit. Every operation is logged on a timeline. Branches isolate experiments. Pull requests let you review changes before merging. You can roll back to any point.

On top of this Git-like foundation, AMFS adds memory intelligence: **memory entries** store knowledge with a **memory type** (fact, belief, or experience), **copy-on-write** preserves full history, **provenance** tracks authorship, **confidence** scores evolve based on real-world **outcomes**, a **knowledge graph** auto-materializes relationships, and **hybrid search** blends full-text, semantic, and confidence signals.

***

## At a Glance

```
Agent writes →  MemoryEntry created
                  ├── entity_path: "checkout-service"
                  ├── key: "retry-pattern"
                  ├── value: { ... }
                  ├── memory_type: fact   ← fact / belief / experience
                  ├── version: 3          ← CoW versioning
                  ├── confidence: 0.85    ← evolves with outcomes
                  ├── branch: "main"      ← git-like branch
                  └── provenance:
                      ├── agent_id: "review-agent"
                      ├── session_id: "abc-123"
                      └── written_at: 2025-06-15T10:30:00Z

              →  Event logged on agent timeline
                  ├── event_type: "write"
                  ├── branch: "main"
                  ├── summary: "Wrote checkout-service/retry-pattern v3"
                  └── details: { entity_path, key, version, confidence }
```

Read the pages in this section to understand each concept in depth.
