# Workflows

Beads molecule templates (protos) for structured agent workflows.

## Concept

- **Proto**: A template workflow that can be instantiated
- **Molecule**: A persistent instance of a proto
- **Wisp**: An ephemeral instance (local-only, not synced)

## Available Protos

| ID | Name | Variables |
|----|------|-----------|
| `skills-fvc` | Code Review: {{target}} | `target` |

## Usage

**Spawn as wisp (ephemeral):**
```bash
bd wisp create skills-fvc --var target=src/main.py
```

**Pour as molecule (persistent):**
```bash
bd pour skills-fvc --var target=src/main.py
```

**After completion:**
```bash
bd mol squash <molecule-id>  # Compress to digest
bd mol burn <molecule-id>    # Delete without trace
```

## Deployment

These protos are deployed to `~/.beads/molecules.jsonl` via home-manager,
making them available in any repository.

## Creating New Protos

1. Create an epic with child tasks using `bd create`
2. Use `{{variable}}` placeholders in titles/descriptions
3. Add the template label: `bd label add <epic-id> template`
4. Export to `workflows/molecules.jsonl`
