docs: clarify the git-refs vs git-branch base-path difference

main

Commit

Soph2mo ago

The write-path paragraph described the shared treeWriter as "anchored at base path """, which is both awkward and slightly wrong — basePath is a per-write argument, not a property of the treeWriter. Explain it in words: git-branch writes each checkpoint under its <id[:2]>/<id[2:]>/ shard prefix inside the one v1 tree, while git-refs writes with no prefix so the checkpoint subtree is the root of its own per-checkpoint commit.

Co-Authored-By: Claude Opus 4.8 (1M context) noreply@anthropic.com Entire-Checkpoint: 01KX3B0P27TWE3S04XQGRR8M1J

Checkpoints

Document git-refs Checkpoint Backend Architecture

Claude CodeOpus 4.8[1m]
View session
Checkpoint 1