docs: add folder workspace use case guidance to AGENTS.md

Folder workspaces are a first-class workspace type that all changes must consider
alongside git worktrees. Document this requirement for developers.
This commit is contained in:
Jinjing 2026-07-23 21:41:08 -07:00
parent 20ce29ae88
commit b36ae94e8d
1 changed files with 4 additions and 0 deletions

View File

@ -35,6 +35,10 @@ Orca targets macOS, Linux, and Windows. Keep all platform-dependent behavior beh
All changes must consider the SSH use case. Don't assume local-only execution.
## Folder Workspace Use Case
All changes must consider folder workspaces as well as git worktrees. Don't assume every workspace is a git worktree.
## Git Binary Compatibility
Orca runs the user's Git binary on native, WSL, and SSH hosts, which may all have different versions. Treat Git 2.25 as the core-workflow baseline and follow [`docs/reference/git-compatibility.md`](./docs/reference/git-compatibility.md).