roboco/docs/rag/troubleshooting/blocked-tools.md

# Blocked Tools

## Native Git Commands Blocked

**Symptom:** `Bash(git commit)` or similar git command denied

**Cause:** Native git commands are blocked for all agents

**Solution:** Use MCP tools instead:
| Blocked | Use Instead |
|---------|-------------|
| `git commit` | `roboco_git_commit()` |
| `git push` | `roboco_git_push()` |
| `git status` | `roboco_git_status()` |
| `git diff` | `roboco_git_diff()` |
| `git log` | `roboco_git_log()` |

## Write/Edit Outside Workspace

**Symptom:** `Write()` or `Edit()` denied for a file path

**Cause:** Write operations restricted to your workspace

**Solution:**
- Developers: Only write in `/data/workspaces/{project}/{team}/{agent-id}/`
- Documenters: Only write in `/app/docs/`
- QA: No write access (review only)

## QA Cannot Commit

**Symptom:** `roboco_git_commit()` denied for QA agent

**Cause:** QA role is read-only, cannot modify code

**Solution:** QA reviews and provides feedback. Developers make fixes.

## NO_PLAN Error

**Symptom:** `roboco_task_start()` returns NO_PLAN error

**Cause:** Task has no plan submitted

**Solution:** Call `roboco_task_plan()` before `roboco_task_start()`

See: `roboco_kb_search("task planning workflow")`

## Parent Branch Required

**Symptom:** Can't claim subtask, error "Parent task must be claimed first"

**Cause:** Parent task hasn't been claimed yet, so it has no branch

**Solution:**
1. Parent task must be claimed first (branch auto-creates on claim)
2. Then subtask can be claimed (its branch forks from parent's)

Note: Branches are auto-created hierarchically. No manual creation needed.