Workspaces

Configure your projects for workspace-aware commands.

Configuration

Edit ~/.genesis/config.json to add your workspaces:

{
  "workspaces": {
    "backend": {
      "path": "/path/to/backend",
      "type": "backend",
      "language": "python"
    },
    "frontend": {
      "path": "/path/to/frontend",
      "type": "frontend",
      "language": "typescript"
    }
  }
}

Workspace Fields

Field Required Description
path Yes Absolute path to workspace root
type No Category: backend, frontend, mobile, etc.
language No Primary language: typescript, python, etc.

Using Workspaces

Reference workspaces with @name in your messages:

/planner @backend Add caching layer
/reviewer @frontend check the auth components

Workspace-Scoped Playbooks

Playbooks can be scoped to specific workspaces:

# Playbook: Error Handling

**Scope:** @backend

## When to Use
Any API endpoint that can fail.

## Pattern
Use Result types, never throw exceptions...

When scoped to a workspace, the playbook only applies when working in that context.

Multiple Workspaces

Reference multiple workspaces when work spans projects:

/planner @backend @frontend Add user authentication

Example Config

{
  "workspaces": {
    "api": {
      "path": "/Users/me/projects/myapp/api",
      "type": "backend",
      "language": "go"
    },
    "web": {
      "path": "/Users/me/projects/myapp/web",
      "type": "frontend",
      "language": "typescript"
    },
    "mobile": {
      "path": "/Users/me/projects/myapp/mobile",
      "type": "mobile",
      "language": "swift"
    },
    "infra": {
      "path": "/Users/me/projects/myapp/infra",
      "type": "infrastructure",
      "language": "terraform"
    }
  }
}