> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytrellis.app/llms.txt
> Use this file to discover all available pages before exploring further.

# v0.5.0-beta.5

> 2026-04-20

## Breaking Changes

* **Sub-agents renamed: `implement` / `check` / `research` → `trellis-implement` / `trellis-check` / `trellis-research`** across all 10 platforms (claude, cursor, opencode, codex, kiro, gemini, qoder, codebuddy, copilot, droid).

  The old generic names were colliding with user-defined agents and, on some platforms, getting matched by the main agent's description heuristics. Prefixing with `trellis-` makes them unambiguously Trellis sub-agents that only fire when you explicitly want them.

  `workflow.md`, the copilot start prompt, `shared-hooks/inject-subagent-context.py` constants, and the configurator's pull-based prelude detection are all updated. If you wrote a custom command or script that calls `Task(subagent_type: "implement", ...)`, you need to change it to `trellis-implement` yourself.

## Bug Fixes

* **Dropped `model: opus` from all agent frontmatters.** This was a real money bug for Cursor users.

  All 18 markdown agent templates shipped with `model: opus` hardcoded in frontmatter, plus three `Task()` examples in `copilot/prompts/start.prompt.md` that said `model: "opus"`. The effect per platform:

  * **Claude Code**: silently overrode the user's selected model for every sub-agent run (all work pinned to Opus regardless of preference).
  * **Cursor**: mapped `opus` to Claude Opus billing — \~5× Sonnet pricing. One tester reported "差点给我跑破产" ("almost went bankrupt on me") before noticing.
  * **Gemini / Droid / Codebuddy / Qoder**: `opus` isn't a valid model identifier for these platforms — at best ignored, at worst broke.

  Agents now inherit whatever model the user's platform session is configured to use. This matches user expectation: if you set Sonnet in Cursor, sub-agents run on Sonnet.

## Upgrade

```bash theme={null}
trellis update --migrate
```

* **Unmodified agent files**: auto-renamed via hash check (30 rename entries across 10 platforms).
* **Customized agent files**: you'll see the standard `Modified by you` confirm prompt with diff. Pick `[1] Overwrite` to adopt the new name, or `[3] Skip` if you want to keep your custom agent — but then you must also update `workflow.md`, skill prompts, and hook constants yourself to point at whatever name you kept.

`update.skip` is bypassed for this release (breaking + recommendMigrate both true when invoked with `--migrate`) to prevent a half-migrated state where `workflow.md` references `trellis-implement` but your `.claude/agents/` still contains the old `implement.md`.

Install: `npm install -g @mindfoldhq/trellis@beta`