---
title: hello
description: The smallest possible workflow, one agent task that runs a Markdown prompt.
---

`hello` is the starter workflow: a single agent `<Task>` that runs the prompt in
`.smithers/prompts/hello.mdx` and greets whoever you name. It is the smallest
complete workflow in the init pack and the recommended starting point for
authoring your own. Edit the prompt (plain Markdown) to change what it does.

```bash
bunx smithers-orchestrator workflow run hello --input '{"name":"Ada"}'
```

With no arguments, `name` defaults to `"world"`, so `workflow run hello` works on
its own.

## Inputs

| Input | Type | Default |
| --- | --- | --- |
| `name` | string | `"world"` |

## How It Runs

1. Reads the input `name` (defaults to `"world"`).
2. Runs one agent `<Task>` whose prompt is `.smithers/prompts/hello.mdx`, with
   `name` interpolated into the Markdown via `{props.name}`.
3. Returns the agent's greeting.

Because the instruction lives in a Markdown prompt rather than code, changing the
behavior is just editing `.smithers/prompts/hello.mdx` (for example, ask for a
haiku instead of a greeting) and re-running.

## Output Shape

`hello` returns the single task's text output (the generated greeting). The run
log records the agent invocation and its result.

## Use it when

- You are learning Smithers and want the smallest end-to-end run.
- You are scaffolding a new workflow and want a known-good single-task template to
  grow from.

## Use something else when

- You need research, planning, and a validated implementation: use
  [`implement`](/workflows/implement) or [`research-plan-implement`](/workflows/research-plan-implement).
- You want to author a brand-new workflow interactively: use
  [`create-workflow`](/workflows/create-workflow).

## Resume & retry

Runs are durable and resume with `up --resume`. `hello` is a single task, so a
resume simply re-runs that task if it had not completed.
