---
name: flow
description: Documents workflow diagrams and process flows with Mermaid diagram support.
argument-hint: "[name]"
user-invocable: true
---

# Flow - Process Flow Documentation

Document workflows, sequences, and state machines with Mermaid diagrams.

## Usage

```
/flow [name]
/flow pr-review
/flow deployment
```

**Output:** `$PROJECT_ROOT/docs/flows/[name].md`

## Instructions

### Language Setting

> Check `LANGUAGE` in `docs/current.md`. If `th`, translate output per `references/language-guide.md`. See `references/bash-helpers.md` for detection snippet.

1. **Parse name** → kebab-case filename
2. **Ask user** about the flow:
   - What type? (process/sequence/state)
   - What actors/components are involved?
   - What are the main steps?
3. **Generate** flow document with Mermaid diagram
4. **Save** to `docs/flows/[name].md`

## Template

```markdown
# [Flow Name]

| Field | Value |
|-------|-------|
| Type | Process / Sequence / State |
| Actors | [list of actors] |
| Created | YYYY-MM-DD |

## Overview

> One sentence description of what this flow does.

## Diagram

```mermaid
sequenceDiagram
    participant A as Actor1
    participant B as Actor2

    A->>B: Action
    B-->>A: Response
```

## Steps

1. **Step 1**: Description
2. **Step 2**: Description
3. **Step 3**: Description

## Error Handling

| Error | Handling |
|-------|----------|
| [error case] | [how to handle] |

## Related

- [related flows or docs]
```

## Diagram Types

### Sequence Diagram
```mermaid
sequenceDiagram
    participant U as User
    participant S as System
    U->>S: Request
    S-->>U: Response
```

### Flowchart
```mermaid
flowchart TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Action]
    B -->|No| D[Other]
```

### State Diagram
```mermaid
stateDiagram-v2
    [*] --> Idle
    Idle --> Processing: start
    Processing --> Done: complete
    Processing --> Error: fail
```

## Related Commands

| Command | Purpose |
|---------|---------|
| `/mem` | Capture insights about flows |
| `/flow` | Document flows (you are here) |
| `/pattern` | Document reusable patterns |