Files
roboco/docs/rag/architecture/workspaces.md
T
Renn F f1c5b7958c Add Project & Workspace MCP System with role-based permissions
- Add roboco_project_* tools (list, get, create, update) with CEO bypass
  - Add roboco_workspace_* tools (ensure, status, list) for workspace management
  - Add project_slug and requires_git fields to TaskCreateInput schema
  - Validate project exists and cell matches when creating git-enabled tasks
  - Register project MCP server in orchestrator with proper permissions

  Workspace permissions by role:
  - Developer: Write to own workspace only
  - QA: Read-only access to all cell workspaces
  - Documenter: Write to all cell workspaces (add docs to dev branches)
  - Cell PM: Write to own workspace, project_update for own cell
  - Main PM: Full project access (create, update all, workspace_list all)
  - CEO: Full bypass on all permission checks

  Also includes:
  - Git templates for commits, branches, PRs (separation of concerns)
  - Updated blueprints with project/workspace tools documentation
  - Updated RAG docs with project tools reference
2026-01-07 22:45:42 +01:00

1.9 KiB

Workspace Structure

Multi-Agent Isolation

Each agent gets their own git clone:

{workspaces_root}/
└── {project-slug}/
    └── {team}/
        └── {agent-slug}/
            └── [git repo files]

Example

/data/workspaces/
└── roboco/
    ├── backend/
    │   ├── be-dev-1/    # be-dev-1's workspace
    │   ├── be-dev-2/    # be-dev-2's workspace
    │   ├── be-qa/       # be-qa's workspace
    │   ├── be-pm/       # be-pm's workspace
    │   └── be-doc/      # be-doc's workspace
    ├── frontend/
    │   ├── fe-dev-1/
    │   └── ...
    └── ux_ui/
        └── ...

Configuration

# Environment variables
ROBOCO_WORKSPACES_ROOT=/data/workspaces
ROBOCO_WORKSPACE_AUTO_CLONE=true
ROBOCO_WORKSPACE_CLONE_TIMEOUT=300

Features

Feature Description
Auto-clone Workspaces created on first access
Isolation No file locking conflicts
Branch independence Agents on different branches
Project-scoped Organized by project slug

Benefits

  1. Parallel Development: Multiple agents on same project
  2. No Conflicts: Each has own working tree
  3. Branch Flexibility: Different branches simultaneously
  4. Clean State: Fresh clone if needed

MCP Tools

Tool Purpose
roboco_workspace_ensure Create workspace if needed
roboco_workspace_status Check workspace state
roboco_workspace_list List all workspaces (PM only)
# Ensure workspace exists (auto-clones if needed)
roboco_workspace_ensure(project_slug="roboco")

# Check status
roboco_workspace_status(project_slug="roboco")

Workspace Resolution

Path resolved automatically: {workspaces_root}/{project}/{team}/{agent}/

If auto_clone=True and workspace doesn't exist, it's created on first access.