roboco/docs/rag/tools/git-tools.md

Git Tools

Read Operations

Tool	Purpose
roboco_git_status	View working tree status
roboco_git_log	View commit history
roboco_git_branch_list	List branches
roboco_git_diff	View changes

Status and Diff

# Check status
status = roboco_git_status(project_slug="roboco")

# View changes
diff = roboco_git_diff(project_slug="roboco")

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

Branch Operations

Branches are auto-created when tasks are claimed:

• Root task claim → feature/team/ROOT_ID
• Subtask claim → feature/team/ROOT_ID/SUB_ID
• Sub-subtask claim → feature/team/ROOT_ID/SUB_ID/SUBSUB_ID

No manual branch creation needed.

# List branches
branches = roboco_git_branch_list(project_slug="roboco")

# Checkout branch (if needed)
roboco_git_checkout(
    project_slug="roboco",
    branch="feature/backend/a1b2c3d4"
)

Commit and Push

# Commit with task link
roboco_git_commit(
    project_slug="roboco",
    task_id=task_id,
    message="Add rate limiting endpoint",
    commit_type="feat"  # Required
)
# Creates: [a1b2c3d4] feat: Add rate limiting endpoint

# Push to remote
roboco_git_push(project_slug="roboco", task_id=task_id)

Pull Requests

# Create PR
roboco_git_create_pr(
    project_slug="roboco",
    task_id=task_id,
    title="[TASK-a1b2c3d4] Add rate limiting",
    body="## Summary\n..."
)

# Merge PR (PM only)
roboco_git_merge_pr(
    project_slug="roboco",
    pr_number=123,
    task_id=task_id,
    merge_method="squash"  # squash, merge, rebase
)

Branch Naming

{type}/{team}/{task-id-prefix}

Type	Use
feature/	New functionality
bug/	Bug fixes
chore/	Maintenance
docs/	Documentation
hotfix/	Urgent fixes