Files
roboco/docs/rag/workflows/git-commits.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.5 KiB

Git Commit Workflow

Commit Format

All commits are automatically prefixed with task ID:

[{task-id-prefix}] {message}

Example:

[a1b2c3d4] Add rate limiting endpoint

Creating Commits

roboco_git_commit(
    project_slug="roboco",
    task_id="a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    message="Add rate limiting endpoint",
    commit_type="feat"  # Required
)

This automatically:

  1. Prefixes commit with task ID (first 8 chars)
  2. Records commit in task's commit history
  3. Links to work session

Commit Message Types

Type Description
feat New feature
fix Bug fix
docs Documentation
style Formatting
refactor Code restructure
test Tests
chore Maintenance
perf Performance

Full Commit Format

{type}({scope}): {description}

{body}

Task: {task-id}
Co-authored-by: {agent-name}

Before Committing

  1. Run tests: uv run pytest or pnpm test
  2. Run linter: uv run ruff check . or pnpm lint
  3. Run type check: uv run mypy roboco/ or pnpm typecheck
  4. Format code: uv run ruff format . or pnpm format

Push Commits

roboco_git_push(project_slug="roboco", task_id="a1b2c3d4...")

Push before:

  • Submitting for QA
  • Creating PR
  • Ending work session

Viewing Commits

# View commit history
roboco_git_log(project_slug="roboco", branch="feature/backend/a1b2c3d4")

# View changes
roboco_git_diff(project_slug="roboco")