Skip to main content
Task lifecycle hooks, custom template registries, parent-child subtasks, and PreToolUse hook fix.

Enhancements

  • Custom template registries: trellis init --registry supports fetching Spec templates from custom GitHub/GitLab/Bitbucket repositories. Automatically detects marketplace mode (index.json) and direct download mode
  • Task lifecycle hooks: .trellis/config.yaml gains a hooks configuration block supporting four events: after_create, after_start, after_finish, and after_archive. Task information is passed via the TASK_JSON_PATH environment variable. Ships with a Linear sync hook example. See: Task Management
  • Parent-child subtasks: task.py add-subtask / remove-subtask commands for linking tasks. task.json gains children, parent, and meta fields. task.py create --parent creates a child task directly
  • Record-session prompt improvement: Archive decision is now based on actual work state rather than the task.json status field
  • Brainstorm prompt update: /brainstorm now includes a subtask decomposition step for complex tasks

Bug Fixes

  • PreToolUse context injection failure: Claude Code v2.1.63 renamed its internal tool from Task to Agent (anthropics/claude-code#29677), causing hook scripts with tool_name != "Task" checks to exit early. This broke code-spec context injection for all implement/check/debug/research agents. Fix: accept both Task and Agent tool names, and add an "Agent" matcher to settings.json

Migration

No manual migration required. Run trellis update to sync the updated hook scripts and settings.