create-agent-missions

Break down large tasks into parallelizable Agent Missions

Create Agent Missions

// turbo-all Trigger: When a task list becomes too long or complex for a single agent.

1. Principles of Parallelism

To ensure multiple agents can work simultaneously without "stepping on toes":
  • File Isolation: No two active missions should modify the same file.
  • Domain Isolation: Split by domain (e.g., Frontend vs Backend vs Game Client).
  • Atomic Scope: A mission must be completeable in 1-2 sessions (approx. 20-30 tool calls).

2. Agent Roles

Assign a specific role to each mission to define the agent's behavior:
  • 👷 Developer: Writes code, refactors, fixes bugs.
    • Tools: replace_file_content, run_command (compile/test).
  • 🕵️ Code Reviewer: Reads code, verifies against guardrails.md, reports violations.
    • Tools: view_file, grep_search. Read-Only.
  • 🧪 QA / Tester: Runs test suites, verifies UI flows, writes new tests.
    • Tools: run_command (Playwright, cargo test).
  • 🏗️ Architect: Plans high-level structures, breaks down tasks (Runs this workflow).

3. Breakdown Strategy

Refactor pending_tasks.md using the Mission Schema:

Schema

### 📦 Mission [ID]: [Name] ([Domain])
**Role**: [Developer | Reviewer | QA]
**Scope**: [Brief Description]
**Context**: `path/to/file1`, `path/to/dir/`

> **Prompt**: You are a [Role] agent assigned to [Name]. Your goal is to [Scope]. You must edit the files in [Context] to achive the tasks below. Verify your work against `.agent/workflows/guardrails.md`.
> **IMPORTANT**: Upon completion of the tasks, you MUST commit your changes to the git repository and push them.

- [ ] Task 1
- [ ] Task 2

Strategy

  1. Group by feature/module:
    • Bad: "Fix all UI bugs" (Touches 50 files).
    • Good: "Fix Wiki UI", "Fix Store UI" (Touches disjoint sets).
  2. Verify Overlap:
    • Check if Mission A and Mission B edit the same file.
    • If yes, serialize them (Mission B depends on Mission A).
    • If no, mark as Parallel.

3. Assignment Protocol

When spawning a new agent:
  1. Copy the entire Mission block from pending_tasks.md.
  2. Paste it into the new agent's prompt.
  3. Mark as [/] In Progress in pending_tasks.md.