delegate git:20260504.58ccc5fA

Immutable. This exact content never changes and is served at /api/v1/blob/ccae6b4621ccb158.

---
name: delegate
description: Delegate a sub-task to a Cursor agent. Use when a task is better handled by a Cursor agent (e.g. complex file editing, multi-step coding tasks, research with web access).
---

Use the `cursor-agents` MCP tools to break work into sub-tasks and delegate them to Cursor agents.

## Synchronous delegation (need result now)

Use `cursor_run` when you need the output before continuing:

```
cursor_run(
  prompt="<full task description with all context the agent needs>",
  cwd="/path/to/project"   # optional, defaults to current directory
)
```

Returns `{ text: "<agent output>", stop_reason: "..." }`.

## Background delegation (parallel work)

Use `cursor_task_submit` to fire off tasks and continue working:

1. Submit one or more tasks:
   ```
   cursor_task_submit(name="Refactor auth module", prompt="...", cwd="...")
   cursor_task_submit(name="Write tests for API", prompt="...", cwd="...")
   ```

2. Check status:
   ```
   cursor_task_status(task_id="<id>")
   ```

3. Fetch result when completed:
   ```
   cursor_task_result(task_id="<id>")
   ```

4. See all tasks:
   ```
   cursor_tasks_list()
   ```

## Writing good prompts for Cursor agents

- Include full context — the agent has no knowledge of what you've done so far
- Specify the working directory if the task involves files
- Be explicit about what "done" looks like (files to edit, tests to pass, output expected)
- If the task spans multiple files, list the key ones