folder

A filesystem directory or workspace. Used to track project roots, working directories, and document collections.

Metadata	Value
Plural	folders
Subtitle field	path
Identity	path

Fields

Field	Type
path	string
workspaceType	string
hasReadme	boolean

Relations

Relation	Target
repository	repository
contains	file[]

Prior art

External standards this shape draws from or aligns with. See Shape design principles for how prior art informs shape design.

• POSIX / Single Unix Specification — Our path is a POSIX pathname. hasReadme is AgentOS-specific (README convention from repos).
• schema.org/DataCatalog — Folder-as-collection loose fit. contains(file[]) ≈ hasPart.