Skip to main content

​
Your First Run

Let’s run a workflow end-to-end. You’ll write a spec, launch Gump, and see the result.

​
Write a spec

Create a file called spec.md in your repo:
The spec can be anything — a feature description, a bug report, a task breakdown. Gump passes it to the agent as context.

​
Run a workflow

Gump will:
  1. Create an isolated Git worktree (your main branch stays clean)
  2. Ask Claude Sonnet to decompose the spec into independent tasks
  3. Implement each task using Qwen (the cheapest agent)
  4. Validate each step with compile + test gates
  5. If a gate fails, retry or escalate to a stronger agent
  6. Run a final quality gate (compile + lint + test)
You’ll see the progress in your terminal:

​
Preview without running

If you want to see what Gump will do before launching agents:
This parses the workflow, validates it, and prints the execution plan — without creating a worktree or calling any agent.

​
What just happened

Gump created a worktree in .gump/worktrees/run-<uuid>, ran the agents inside it, validated every step, and committed a snapshot after each one. The result is ready to merge. Check the report:
Now apply the result to your branch.