Files
kandev/docs/specs/workspaces/README.md
T
2026-09-13 16:59:03 +01:00

43 lines
1.3 KiB
Markdown

---
status: draft
system: workspaces
specification_version: 1
migration: in_progress
owners:
- kandev
---
# Workspace system
## Purpose
The workspace system owns workspace lifecycle, repositories, worktrees,
branches, branch policies, workspace secrets, and workspace-scoped execution context.
## Ownership
This system owns workspace creation and deletion, repository attachment,
repository sets, local repositories, branch templates, secrets, and workspace
Git state.
Workspace context identity, cached collection isolation, and navigation recovery
after failed reads also belong here.
## Exclusions
- Task-owned worktree lifetime belongs to the [task system](../tasks/README.md).
- Provider credentials belong to the [integration system](../integrations/README.md).
- Workspace settings presentation belongs to the [UI system](../ui/README.md).
## Migration record
Migration remains in progress while legacy source detail is extracted from the
canonical requirement and system-design documents. Use the catalog command to
find current sources.
## Related systems
- [Tasks](../tasks/README.md): consumes workspace repositories and worktrees.
- [Integrations](../integrations/README.md): supplies remote repository identity.
- [Platform](../platform/README.md): owns shared read capacity and persistence health.