# Files And Memory Guide

Last reviewed: 2026-04-24

Primary source surfaces:

- `/private/files`
- Files Knowledge Base implementation

## Purpose

Files & Memory stores user documents, generated artifacts, and knowledge-base material that Raven
can use as retrieval context after processing and semantic indexing.

## Common User Actions

Users can:

- upload documents
- create folders
- move a single file into a folder or back to root
- rename folders
- delete empty folders
- seed the starter knowledge base
- open, download, or delete individual documents

Recursive folder deletion and bulk folder moves are intentionally out of scope until there is a
strong confirmation flow with affected-item counts.

## Knowledge Base Behavior

Documents uploaded under `Knowledge Base` are treated as durable user or counselor knowledge. Users
do not need to manually flag the document for RavenAgent.

Classification rules:

- seeded starter KB documents use `kb_starter`
- product support KB documents use `kb_product_support`
- user or counselor documents inside `Knowledge Base` use `kb_user`
- documents outside `Knowledge Base` use `candidate_artifact`
- generated compare or draft outputs use `generated_artifact`

## What RavenAgent Should Explain

When users ask how to make a document available to Raven:

1. Put durable guidance, strategy notes, account notes, or program knowledge in `Knowledge Base`.
2. Upload candidate-specific artifacts such as resumes, offer letters, and interview notes where
   they naturally belong.
3. Wait for processing to complete before expecting strong retrieval.
4. Ask Raven a question naturally; manual document selection should be optional.