> ## 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.4.0-beta.10

> 2026-04-09

Ralph Loop field name fix (P0), migration task assignee parsing fix, and task lifecycle documentation.

## Bug Fixes

* **Ralph Loop field names fix (#152)**: The SubagentStop hook was reading non-existent fields (`subagent_type`, `agent_output`, `prompt`) instead of the actual Claude Code event schema (`agent_type`, `last_assistant_message`), so Ralph Loop was silently inert for **all users since release**. Check/implement/debug subagents will now actually trigger loop control as documented. Thanks to @suyuan2022 for the catch.
* **Migration task assignee parsing (#153)**: When `trellis update --migrate` created the auto-generated migration task, it read `.trellis/.developer` as a plain string and embedded the entire `name=...\ninitialized_at=...` file contents as the `assignee` field. The timestamp line then leaked into `session-start.py` rendering, breaking the ACTIVE TASKS layout. Now parses the `name=` line correctly. Thanks to @suyuan2022 for the fix.

## Documentation

* **Task lifecycle commands**: `workflow.md` now documents `task.py start <name>` and `task.py finish` — previously both subcommands were wired in argparse but completely unmentioned in the workflow guide, so AI agents never knew to call them and `## CURRENT TASK` was perpetually `(none)`. Task Development Flow expanded from 5 to 7 explicit steps with Start (step 2) and Finish (step 7), plus a new "Current task mechanism" explainer tying `.current-task` to SessionStart hook injection.

## Notes

* Run `trellis update` to sync all changes
* **Behavior change**: Ralph Loop will now actually fire for check/implement/debug subagents. If you were unknowingly relying on the previously-silent behavior, watch for new loop activity after upgrading.