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.