Definition

Rudder uses several file boundaries because background context, durable output, and mutable execution work have different jobs. Project resources are an admission list, not every file in the organization. An output should remain connected to the Chat, Issue, Run, or project that produced it instead of existing only inside a transcript.

One illustrative case

A consulting team prepares a client brief. Source notes live in Library and are attached to the project as curated resources. The Agent works in the project’s repository through a run workspace, then saves the final brief in the project Library folder and links it from the review Issue. A later run can find the accepted brief without inheriting every scratch file from the first attempt. Workspaces and resources

When each location is useful

Use Library for files that should remain part of the organization record. Add a file as a project resource only when project-linked runs should receive it as starting context. Use a project workspace for repository work and a run workspace when changes need an explicit isolation strategy. Keep temporary artifacts outside Library unless they are part of the final evidence. On the default local Desktop layout, organization files live in a mapped folder under ~/Documents/Rudder. The mapping uses organization identity, so renaming the organization does not silently move its files.

Operating boundaries

Protected Agent instructions, Skills, managed runtime directories, and cache paths are not ordinary Library content. Desktop launch actions still pass through workspace and real-path validation; they do not grant browser or server deployments access to local applications. The highest-risk boundary is destructive filesystem work. A missing mapped organization folder is treated as a recovery problem, not replaced with an empty folder. Run workspaces cannot be archived while open Issues still depend on them, and restoring a backup creates a pre-restore safety version first. See Workspace boundaries for the lookup rules, then follow Manage Workspaces and Library.