diff --git a/autogpt_platform/backend/CLAUDE.md b/autogpt_platform/backend/CLAUDE.md
index 157338c411..c7e4bccf6d 100644
--- a/autogpt_platform/backend/CLAUDE.md
+++ b/autogpt_platform/backend/CLAUDE.md
@@ -159,11 +159,13 @@ yield "image_url", result_url
 
 ## Workspace & Media Files
 
-See [Workspace & Media Architecture](docs/workspace-media-architecture.md) for details on:
+**Read [Workspace & Media Architecture](../../docs/platform/workspace-media-architecture.md) when:**
+- Working on CoPilot file upload/download features
+- Building blocks that handle `MediaFileType` inputs/outputs
+- Modifying `WorkspaceManager` or `store_media_file()`
+- Debugging file persistence or virus scanning issues
 
-- `WorkspaceManager` - persistent user file storage with session scoping
-- `store_media_file()` - media normalization pipeline for blocks
-- Virus scanning and persistence responsibilities
+Covers: `WorkspaceManager` (persistent storage with session scoping), `store_media_file()` (media normalization pipeline), and responsibility boundaries for virus scanning and persistence.
 
 ## Security Implementation
 
diff --git a/autogpt_platform/backend/docs/workspace-media-architecture.md b/docs/platform/workspace-media-architecture.md
similarity index 100%
rename from autogpt_platform/backend/docs/workspace-media-architecture.md
rename to docs/platform/workspace-media-architecture.md