Migration Task: Upgrade to v0.4.0-beta.8

Created: 2026-04-07 From Version: 0.3.10 To Version: 0.4.0-beta.8 Assignee: name=hechang27-sprt initialized_at=2026-03-24T18:13:15.726010

Status

Review migration guide
Update custom files
Run trellis update --migrate
Test workflows

v0.4.0-beta.1 Migration Guide

Command Consolidation

The following commands have been merged:

Old (removed)	New (replacement)
`before-backend-dev`	`before-dev`
`before-frontend-dev`	`before-dev`
`check-backend`	`check`
`check-frontend`	`check`

If you never customized these commands

No action needed. trellis update will:

Auto-delete the old files (hash-verified, only if unmodified)
Write the new unified before-dev and check commands

If you customized the old commands

The old files will NOT be deleted (hash mismatch protection). You need to:

Open the new before-dev / check command file
Merge your customizations from the old backend/frontend variants into the unified file
Delete the old files manually once merged

Affected paths per platform

Claude: .claude/commands/trellis/
Cursor: .cursor/commands/
iFlow: .iflow/commands/trellis/
OpenCode: .opencode/commands/trellis/
Gemini: .gemini/commands/trellis/
Kilo: .kilocode/workflows/
Codex: .agents/skills/
Kiro: .kiro/skills/
Qoder: .qoder/skills/

Python Scripts Refactoring

All .trellis/scripts/ files have been restructured internally. No action needed — all entry paths (python3 .trellis/scripts/task.py, etc.) remain unchanged. trellis update will sync the new scripts automatically.

AI Assistant Instructions

When helping with this migration:

When helping users migrate to v0.4.0-beta.1:

Check for customized old commands: Run git diff or compare file hashes to see if the user modified before-backend-dev, before-frontend-dev, check-backend, or check-frontend files.
If customized: Help merge their customizations into the new unified before-dev and check files. The new files use python3 ./.trellis/scripts/get_context.py --mode packages to auto-detect which specs to load, replacing the hardcoded backend/frontend split.
If not customized: Just run trellis update — safe-file-delete will handle cleanup automatically.
Python scripts: No user action needed. The refactoring preserves all entry paths. If the user has custom scripts that import from .trellis/scripts/common/, they may need to update imports (e.g., from common.io import read_json instead of inline _read_json_file).

2.7 KiB Raw Blame History