kandev/docs/specs/workspaces

status, system, specification_version, migration, owners

status	system	specification_version	migration	owners
draft	workspaces	1	in_progress	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.

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

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

System design

• Secret reference protection
• Empty Remote Repositories
• Improve Kandev
• Copy and Move Secrets Between Scopes
• Branch Policies
• Worktree Base Refresh
• Local Workspace Repositories
• Organization Units

Migration record

Migration remains in progress while legacy source detail is extracted from the canonical requirement and system-design documents above.

Related systems

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