> ## Documentation Index
> Fetch the complete documentation index at: https://gump.build/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Pick a workflow

> Pick a workflow. Run it. Ship code.

# 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.

```bash theme={null}
# List available workflows
gump playbook list

# Run one
gump run cheap2sota --spec spec.md
```

## Workflows

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

<CardGroup cols={2}>
  <Card title="Freeform" icon="bolt" href="/playbook/workflows/freeform">
    Single agent, no plan. Quick experiments.
  </Card>

  <Card title="Cheap2Sota" icon="arrow-up-right-dots" href="/playbook/workflows/cheap2sota">
    Start cheap. Escalate only on failure.
  </Card>

  <Card title="TDD" icon="vial" href="/playbook/workflows/tdd">
    Test-first, implement, verify.
  </Card>

  <Card title="Implement Spec" icon="arrows-spin" href="/playbook/workflows/implement-spec">
    Decompose, implement, adversarial review, converge.
  </Card>

  <Card title="Parallel Tasks" icon="layer-group" href="/playbook/workflows/parallel-tasks">
    Decompose. Build all tasks at once.
  </Card>

  <Card title="Bugfix" icon="bug" href="/playbook/workflows/bugfix">
    Reproduce first, then fix.
  </Card>

  <Card title="Refactor" icon="shuffle" href="/playbook/workflows/refactor">
    Change the structure, keep the behavior.
  </Card>
</CardGroup>

## Patterns

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

<CardGroup cols={2}>
  <Card title="Test Backfill" icon="flask-vial" href="/playbook/patterns/test-backfill">
    Add tests to existing untested code.
  </Card>

  <Card title="Security Fix" icon="shield-halved" href="/playbook/patterns/security-fix">
    Audit vulnerabilities, then patch each one.
  </Card>

  <Card title="Docgen" icon="book" href="/playbook/patterns/docgen">
    Generate missing documentation from code.
  </Card>

  <Card title="Migration" icon="right-left" href="/playbook/patterns/migration">
    Database, API, or dependency migrations in atomic steps.
  </Card>

  <Card title="Spike" icon="magnifying-glass" href="/playbook/patterns/spike">
    Technical exploration. Analysis, not code.
  </Card>
</CardGroup>

***

## Quick tips

<AccordionGroup>
  <Accordion title="Preview before running">
    Use `--dry-run` to see the execution plan without launching any agent:

    ```bash theme={null}
    gump run tdd --spec spec.md --dry-run
    ```
  </Accordion>

  <Accordion title="Resume and replay">
    If a run crashes or you want to tweak something mid-flight:

    ```bash theme={null}
    # Resume where you left off (preserves worktree and sessions)
    gump run --resume

    # Replay from a clean state at a specific step
    gump run --replay --from-step impl
    ```
  </Accordion>

  <Accordion title="Compose workflows">
    A sub-workflow can be called as a step, a gate validator, or inside GET:

    ```yaml theme={null}
    # As a step
    - name: setup
      workflow: workflows/setup-env
        project: "{spec.project}"

    # As a gate validator
    gate:
      - validate: validators/arch-review
          diff: "{diff}"
          agent: claude-opus
    ```
  </Accordion>

  <Accordion title="Inject project context">
    Add a `context` block to any step to feed extra information:

    ```yaml theme={null}
    get:
      context:
        - file: "docs/architecture.md"
        - bash: "git log --oneline -10"
    ```
  </Accordion>
</AccordionGroup>