kandev/docs/specs/workspaces

status, system, specification_version, migration, owners

status	system	specification_version	migration	owners
draft	workspaces	1	complete	kandev

Workspace system

Purpose

The workspace system owns workspace lifecycle, repositories, worktrees, branches, 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.

Exclusions

• Task-owned worktree lifetime belongs to the task system.
• Provider credentials belong to the integration system.
• Workspace settings presentation belongs to the UI system.

Specification map

Requirements

• Create a Local Repository During Task Creation
• Kanban workspace creation
• Workspace Deletion
• Improve Kandev
• Local Workspace Repositories
• Repository and Workspace Secrets
• Repository Sets
• Copy and Move Secrets Between Scopes
• Workspace Base-Branch Propagation
• Worktree Branch Templates

System design

• Improve Kandev
• Copy and Move Secrets Between Scopes

Migration record

All legacy sources assigned to this system are now represented by the canonical requirement and system-design documents above. Source detail is retained in those documents or in their linked design parts.

Related systems

• Tasks: consumes workspace repositories and worktrees.
• Integrations: supplies remote repository identity.