Keep data outside .forest/¶
Forest checkout workspaces store pointers and metadata, not biological data. Data paths remain outside .forest/ so multiple repos, each with their own workspace metadata, can point to the same data without copying or moving it.
Consequences¶
.forest/checkouts/<name>/contains checkout metadata such as sharedforest.yamlplus user-locallocal.yamlandsync_state.json.local.yamlstage path bindings point to real data locations.--adoptmust preserve existing effective data paths instead of moving data into.forest/.