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

> 2026-04-20

## Bug fixes

* **`.trellis/workflow.md` is now actually updated by `trellis update`.** Critical fix for 0.5 upgrades.

  workflow\.md was explicitly **excluded** from `collectTemplateFiles` since early Trellis versions, under the assumption that it's "user-customizable documentation, written once at init, never touched by update". That assumption broke in 0.5.0 because workflow\.md started carrying **script-parsed structure**:

  * `## Phase Index` — read by `get_context.py --mode phase`
  * `## Phase 1/2/3` headings — inlined into the 9.5 KB SessionStart payload
  * `[workflow-state:STATUS]` tag blocks — consumed by the per-turn breadcrumb hook

  Users upgrading from 0.4.x → 0.5 ended up with `get_context.py` reporting `Phase Index section not found in workflow.md` and the new `/continue` command unable to resolve step routing.

  **workflow\.md is now included in the normal update flow.** Unmodified copies auto-update, user-modified copies go through the existing "Modified by you" confirm prompt with diff. `workspace/index.md` stays excluded — it's runtime-appended by `add_session.py` and has no script-parsed structure.

## Upgrade path for users stuck on beta.0..beta.3

If you already upgraded to any earlier 0.5 beta and see `Phase Index section not found`:

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

* If you never edited workflow\.md: it auto-updates (shows in "Template updated (will auto-update)" section)
* If you edited workflow\.md: you'll get a `Modified by you` confirm prompt with diff. Pick `[1] Overwrite` to get the new 0.5 structure, or pick `[3] Skip` and merge your edits into the new template manually (the template is at `packages/cli/dist/templates/trellis/workflow.md` inside the globally installed CLI)

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