2.3 KiB
Change Local Workflow
When the user wants to change Trellis phases, next-action hints, whether to create tasks, whether to use sub-agents, or when to check/wrap up, edit .trellis/workflow.md first.
Read These Files First
.trellis/workflow.md- Entry files for the current platform, such as skills/commands/prompts/workflows
- The current task's
task.jsonandprd.md
Common Needs And Edit Points
| Need | Edit point |
|---|---|
| Change phase names or phase order | Phase Index and the corresponding Phase sections. |
| Change whether to create a task when there is no task | [workflow-state:no_task] state block. |
| Change the next step during planning | Phase 1 and [workflow-state:planning]. |
| Change whether an agent is required during in_progress | Phase 2 and [workflow-state:in_progress]. |
| Change wrap-up after completion | Phase 3 and [workflow-state:completed]. |
| Change which skill a user intent triggers | Skill Routing table. |
Modification Steps
- Find the relevant section in
.trellis/workflow.md. - When changing rules, keep explicit trigger conditions and next actions.
- If adding or renaming a skill/agent, synchronize the corresponding files in platform directories.
- If workflow-state prompt blocks change, confirm hooks can still read blocks by status.
- Make the AI reread
.trellis/workflow.md; do not keep using rules from the old conversation.
Example: Relax Task Creation Requirements
To change when task creation can be skipped, usually edit [workflow-state:no_task]:
[workflow-state:no_task]
Task is not required when the answer is a one-reply explanation, no files are changed, and no research is needed.
[/workflow-state:no_task]
If the formal Phase 1 flow also needs to change, synchronize the Phase 1 section.
Example: One Platform Does Not Use Sub-Agents
If the user wants only one platform to avoid sub-agents, first confirm whether that platform has a separate group in the workflow. Then change Phase 2 routing for that platform group instead of deleting all trellis-implement / trellis-check instructions across platforms.
Notes
.trellis/workflow.md is the local project workflow, not an immutable template. The user can adapt it to team habits. After editing it, platform entry files may still contain old descriptions, so inspect them too.