> ## 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.1

> 2026-04-20

**First published 0.5 beta.** Code is identical to the `0.5.0-beta.0` dev cut. The bump from `beta.0` → `beta.1` happens automatically inside `pnpm release:beta` (via `pnpm version prerelease --preid beta`), so `beta.0` was never published to npm — `beta.1` is the first tagged release of the skill-first architecture.

All the heavy lifting (command→skill for 5 skills, 138-entry safe-file-delete for legacy commands + iFlow + multi-agent + Ralph Loop, breaking-change `--migrate` gate, per-entry `reason` field in the confirm prompt, worktree backup exclusion, build `clean` step) is defined in the `0.5.0-beta.0` manifest and applies when upgrading from 0.4.x.

See the [`v0.5.0-beta.0` changelog](/changelog/v0.5.0-beta.0) for the full migration story.

## Migration

If upgrading from 0.4.x: run `trellis update --migrate`. The breaking-change gate requires the flag explicitly — without it, `trellis update` exits 1 with guidance.

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