matterbridge-roborock-vacuum-plugin
Version:
Matterbridge Roborock Vacuum Plugin
58 lines (41 loc) • 4.88 kB
Markdown
# Agent Prompts (EM spawn reference)
Workflow/gates: `.cursor/instructions/team-orchestrator-policy.md`. Role defs: `.cursor/agents/<name>.md` (embed key constraints in `prompt`).
## Model
- **No `model:` on Task** — use agent frontmatter. Exception: high **implementer** → `model: "claude-4.6-sonnet-medium"` if Task accepts; else omit.
- Usage-limit fail → retry without `model` (Auto).
| Frontmatter tier | Agents |
| ------------------- | ------------------------------------------------------------------------------------------ |
| `composer-2.5-fast` | briefer, compiler, documenter, finalizer, implementer (default), wiki-manager |
| `auto` | technical-architect, investigator, reviewer, test-writer, direct-executor, release-manager |
## Task skeleton
```typescript
Task({ description: "<role>: <task>", subagent_type: "<name>", prompt: "<see table>", run_in_background: false });
```
Parallel Task only for independent work — never reviewer + test-writer + documenter together.
## Spawn table
| Agent | When | `prompt` (minimum) |
| ---------------------------------------------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **technical-architect** | Planning; once/cycle | `Task folder: workspace/<task>/\nRequirement: …\ntype: implement\|explain` → plan+test-plan or answer.md |
| **briefer** | After TA ready | `Task folder: workspace/<task>/` |
| **implementer** | After brief Approve | `Task folder: workspace/<task>/` — plan.md, logic only |
| **reviewer** pass 1 | After implementer | `Task folder: workspace/<task>/\npass: production` — prod diff vs plan; tag issues **implementation** \| **tests** |
| **test-writer** | After pass 1 OK | `Task folder: workspace/<task>/` + reviewer test notes if any |
| **reviewer** pass 2 | After test-writer | `Task folder: workspace/<task>/\npass: final` — full diff; **APPROVE** \| **REQUEST CHANGES** (tagged) |
| **documenter** | Final **APPROVE** only | `Task folder: workspace/<task>/` |
| **direct-executor** | Lite / ad-hoc | `USER REQUEST:\n<verbatim>\n\nCONSTRAINTS:\n…` |
| **finalizer** / **compiler** / **release-manager** / **wiki-manager** update | User request | See `.cursor/agents/` |
**EM must NOT spawn:** wiki gather, investigator, explore (TA nests).
## Review routing (EM)
| Verdict | Tags | Next spawn |
| -------------------------- | --------------------------- | ------------------------------------------- |
| Pass 1 **REQUEST CHANGES** | **implementation** only | `implementer_id` → reviewer pass 1 |
| Pass 1 **REQUEST CHANGES** | **tests** only (or APPROVE) | `test-writer` |
| Pass 2 **APPROVE** | — | `documenter` |
| Pass 2 **REQUEST CHANGES** | **implementation** | implementer → test-writer → reviewer pass 2 |
| Pass 2 **REQUEST CHANGES** | **tests** | test-writer → reviewer pass 2 |
## Verify gates
implementer: format:ci → lint:fix:ci → type-check:ci · test-writer: + type-check:ci → test:ci · documenter: format:ci · finalizer: + precommit:ci
## Pipeline one-liners
- **Full:** TA → briefer → approve → implementer → reviewer (prod) → test-writer → reviewer (final) → documenter (APPROVE).
- **Lite:** direct-executor → optional reviewer.
- **Explain:** TA → present answer.md.