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

# Task Management Tools

## Core Operations

| Tool | Purpose |
|------|---------|
| `roboco_task_get` | Get task details |
| `roboco_task_scan` | Find available tasks |
| `roboco_task_claim` | Take ownership |
| `roboco_task_start` | Begin work |

## Task Retrieval

```python
# Get specific task
task = roboco_task_get(task_id)

# Scan for available tasks
tasks = roboco_task_scan(
    team="backend",        # Optional filter
    status="pending"       # Optional filter
)
```

## Task Lifecycle

```python
# Claim task
roboco_task_claim(task_id)

# Start work (also resumes paused tasks)
roboco_task_start(task_id)

# Pause work
roboco_task_pause(task_id, reason="Waiting for clarification")

# Resume paused work (use start)
roboco_task_start(task_id)  # Works on paused tasks

# Block (waiting on another task)
roboco_task_block(task_id, blocker_task_id, reason)

# Unblock (PM only)
roboco_task_unblock(task_id)
```

## Submission

```python
# Submit for verification
roboco_task_submit_verification(task_id)

# Submit for QA
roboco_task_submit_qa(task_id, notes)

# QA actions
roboco_task_qa_pass(task_id, {notes: "..."})
roboco_task_qa_fail(task_id, {notes: "...", issues: [...]})

# Documentation complete
roboco_task_docs_complete(task_id)

# PM complete
roboco_task_complete(task_id)
```

## PM Operations

```python
# Create task
roboco_task_create({
    title: "...",
    description: "...",
    team: "backend",
    status: "backlog"
})

# Activate (backlog -> pending)
roboco_task_activate(task_id)

# Cancel
roboco_task_cancel(task_id, reason)

# Plan
roboco_task_plan(task_id, approach, steps)
```

## Progress Updates

```python
roboco_task_progress(task_id, "Implementing API", 50)
```