Skip to main content

Playbook

Gump ships with built-in workflows for common engineering patterns. Each one is a complete YAML file — run it as-is or fork and customize.

Workflows

Built-in. Available as positional arg to gump run. Ready to run.

Freeform

Single agent, no plan. Quick experiments.

Cheap2Sota

Start cheap. Escalate only on failure.

TDD

Test-first, implement, verify.

Implement Spec

Decompose, implement, adversarial review, converge.

Parallel Tasks

Decompose. Build all tasks at once.

Bugfix

Reproduce first, then fix.

Refactor

Change the structure, keep the behavior.

Patterns

Copy-and-adapt. Requires a project-specific gate. Shows what’s possible.

Test Backfill

Add tests to existing untested code.

Security Fix

Audit vulnerabilities, then patch each one.

Docgen

Generate missing documentation from code.

Migration

Database, API, or dependency migrations in atomic steps.

Spike

Technical exploration. Analysis, not code.

Quick tips

Use --dry-run to see the execution plan without launching any agent:
If a run crashes or you want to tweak something mid-flight:
A sub-workflow can be called as a step, a gate validator, or inside GET:
Add a context block to any step to feed extra information: