vago

Give one Ticket another Workflow

A Workflow for one Ticket of a Goal, such as a docs Ticket in a Goal of code Tickets, named with vago ticket add --workflow.

Each Ticket goes through its Goal’s Workflow unless it names another. A Goal of code Tickets can have one docs Ticket that needs no tests and a writer’s prompt in place of a builder’s. Write that Workflow next to the Goal’s:

# .vago/workflows/docs.toml
harness      = "claude-code"
model        = "claude-opus-5-5"
idle_timeout = "10m"

[[steps]]
id   = "branch"
name = "New branch"
type = "shell"
run  = "sh .vago/scripts/branch.sh"

[[steps]]
id     = "write"
name   = "Write"
type   = "agent"
prompt = "prompts/docs-write.md"

[[steps]]
id     = "review"
name   = "Review"
type   = "agent"
prompt = "prompts/docs-review.md"

[[steps]]
id   = "merge"
name = "Squash merge"
type = "shell"
run  = "sh .vago/scripts/merge.sh"

The two prompts are yours to write, in .vago/prompts/. A writer’s prompt might say:

You write the docs this Ticket asks for, on the branch that is already
checked out. Change only files under docs/. Commit with short imperative
messages. Your final message lists each page you changed.

# Ticket

{{ticket}}

Then add the Ticket with --workflow:

vago ticket add search usage-docs --blocked-by 2 --workflow docs --body-file usage-docs.md

This writes workflow = "docs" into the Ticket’s header. The Ticket goes through docs, and the Goal’s other Tickets keep the Goal’s Workflow. Goals and Tickets has the details.

The Ticket keeps the same branch and the same merge.sh as the rest of the Goal, so its commit lands on vago/<goal> and in the Goal’s PR like any other.

Caveats

  • vago ticket add --workflow refuses a Workflow with before_all or after_all Steps unless it is the Goal’s own. Only the Goal’s Workflow runs Goal Steps.
  • A Step with when = "last-ticket" runs only in the Workflow of the Ticket it lands on. If the docs Ticket is the Goal’s last, the Goal review in the Goal’s Workflow never runs. Give docs its own Goal review Step with when = "last-ticket" if the docs Ticket may end the Goal.

This page as Markdown