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

# Workflows

> Specialized AI agents trained on complex analytical methodologies for sophisticated blockchain analysis

Workflows (also called "Agents") are pre-trained, specialized systems designed to tackle complex
analytical questions using structured, expert methodologies.

## What are Workflows?

Unlike general chat mode—where FlipsideAI freestyles based on your prompt—Workflows apply
quasi-deterministic (predetermined) approaches to specific types of analysis.

Think of Workflows as domain experts with proven playbooks:

* **TVL analysis Workflow** knows exactly how to calculate, validate, and compare Total Value Locked
* **Liquidity tracking Workflow** follows established methods for assessing pool depth and health
* **User cohort Workflow** applies structured cohort analysis frameworks

### General mode vs Workflow mode

<Tabs>
  <Tab title="General mode">
    **Best for:**

    * Exploratory questions
    * One-off analyses
    * Flexible, conversational interaction

    **How it works:**

    * FlipsideAI interprets your question
    * Generates a plan on the fly
    * Adapts based on results

    **Example:**
    "Show me Uniswap activity on Arbitrum"
  </Tab>

  <Tab title="Workflow mode">
    **Best for:**

    * Complex, multi-step analyses
    * Comparative studies requiring consistent methodology
    * Situations where reproducibility matters

    **How it works:**

    * Workflow detects it matches your question
    * Applies a pre-trained, structured approach
    * Follows a consistent methodology

    **Example:**
    Workflow detects "TVL analysis" intent → applies standard TVL calculation framework
  </Tab>
</Tabs>

<Warning>
  Running the same question in general mode vs Workflow mode will give you **different results**—by
  design. Workflows are structured and methodical; general mode is flexible and adaptive.
</Warning>

## Using Workflows

### Automatic detection

FlipsideAI automatically detects when your question matches a Workflow:

```text theme={null}
You: "Analyze TVL trends for Aave vs Compound over Q1 2024"

FlipsideAI: Using workflow: TVL comparative analysis
[Applies structured TVL calculation and comparison methodology]
```

You'll see "Using workflow: \[name]" when a Workflow is active.

### Manual selection

Use the `@` symbol to browse and manually select Workflows:

<Steps>
  <Step title="Type @">In the chat box, type `@` to open the selector</Step>
  <Step title="Browse Workflows">Scroll through available Workflows and datasets</Step>
  <Step title="Select one or more">Click to add Workflows to your prompt</Step>
  <Step title="Ask your question">Complete your prompt with the specific question</Step>
</Steps>

**Example:**

```text theme={null}
@TVL-Analysis Compare Aave and Compound over the past quarter
```

## Common Workflows

<AccordionGroup>
  <Accordion title="TVL analysis" icon="vault">
    **What it does:**

    * Calculates Total Value Locked using consistent methodology
    * Handles multi-asset pools and LP tokens correctly
    * Compares across protocols or time periods
    * Validates against external sources (e.g., DeFiLlama)

    **Best for:**

    * Protocol health assessments
    * Competitive comparisons
    * Trend analysis over time
  </Accordion>

  <Accordion title="Liquidity tracking" icon="water">
    **What it does:**

    * Measures liquidity depth and distribution
    * Tracks liquidity providers and concentration
    * Analyzes liquidity migration patterns
    * Assesses pool health and sustainability

    **Best for:**

    * DEX pool analysis
    * Liquidity provider behavior
    * Risk assessment for traders
  </Accordion>

  <Accordion title="User cohort analysis" icon="users-viewfinder">
    **What it does:**

    * Segments users by first interaction date
    * Tracks retention and behavior over time
    * Compares cohorts side-by-side
    * Identifies power users vs casual users

    **Best for:**

    * Protocol growth analysis
    * User retention studies
    * Product-market fit assessments
  </Accordion>

  <Accordion title="Token holder analysis" icon="hand-holding-dollar">
    **What it does:**

    * Identifies top holders and concentration
    * Tracks holder behavior (accumulation vs distribution)
    * Flags potential risks (whale movements, centralization)
    * Analyzes holder overlap across tokens

    **Best for:**

    * Tokenomics research
    * Risk assessments
    * Airdrop or incentive targeting
  </Accordion>

  <Accordion title="Bridge activity analysis" icon="bridge">
    **What it does:**

    * Tracks cross-chain asset flows
    * Identifies bridge users and patterns
    * Compares bridge volumes and market share
    * Analyzes net inflows/outflows by chain

    **Best for:**

    * Cross-chain ecosystem studies
    * Chain growth comparisons
    * Bridge risk assessments
  </Accordion>
</AccordionGroup>

## When to use Workflows

### ✅ Use Workflows when:

* You need **consistent, reproducible methodology**
* The analysis is **complex and multi-step** (e.g., cohort retention with multiple metrics)
* You're **comparing entities** and want apples-to-apples analysis
* You want **expert-level approaches** without specifying every step
* You're running **recurring analyses** (monthly reports, protocol monitoring)

### ❌ Don't use Workflows when:

* You're doing **quick, exploratory research**
* Your question is **highly specific or unusual** (Workflows may constrain the approach)
* You want **maximum flexibility** in how the analysis is structured
* You're **testing hypotheses** that don't fit standard frameworks

## Requesting new Workflows

Don't see a Workflow for your use case? Request one.

<Note>
  Workflow requests are reviewed and built by the Flipside team. If there's a common analytical
  pattern you run repeatedly, we want to build a Workflow for it.
</Note>

**What to include in your request:**

1. **Use case description**: What problem are you solving?
2. **Analytical steps**: What's the methodology you'd like codified?
3. **Frequency**: How often would you use this Workflow?
4. **Example questions**: What prompts should trigger this Workflow?

## Pro tips

<AccordionGroup>
  <Accordion title="Combine Workflows with Rules" icon="layer-group">
    Use [Rules](/flipsideai/rules) to customize Workflow output:

    * Rules control **how** results are presented
    * Workflows control **what** analysis is performed

    Example: Use TVL Workflow with a "Twitter-ready visuals" Rule for polished charts.
  </Accordion>

  <Accordion title="Override Workflows when needed" icon="ban">
    If a Workflow is triggered but you want general mode instead:

    ```text theme={null}
    "Analyze Aave TVL, but don't use the TVL Workflow—I want a custom approach"
    ```
  </Accordion>

  <Accordion title="Ask Workflows to explain themselves" icon="question">
    Workflows are transparent. Ask:

    * "What methodology did you use?"
    * "Why did you calculate it this way?"
    * "Can you show me the step-by-step logic?"
  </Accordion>

  <Accordion title="Fork and iterate" icon="code-fork">
    Workflow results can be a starting point:

    1. Let the Workflow run its structured analysis
    2. Review the results
    3. Ask follow-up questions to dig deeper or explore tangents

    The Workflow handles the foundation; you explore from there.
  </Accordion>
</AccordionGroup>

## Understanding Workflow outputs

When a Workflow runs, you'll see:

1. **Workflow name**: "Using workflow: \[name]"
2. **Structured analysis**: Results organized according to the Workflow's methodology
3. **Flipside Data boxes**: Queries used to generate results (fully transparent)
4. **Artifacts or reports**: Formatted outputs (charts, tables, summaries)

Unlike general mode, Workflows follow a predictable structure—making them ideal for recurring
analyses or comparisons.

## Next steps

<CardGroup cols={2}>
  <Card title="Analysis modes" icon="gears" href="/flipsideai/analysis-modes">
    Understand how Workflows fit into FlipsideAI's analysis modes
  </Card>

  <Card title="Effective prompting" icon="pen" href="/flipsideai/prompting">
    Learn to craft prompts that trigger the right Workflows
  </Card>

  <Card title="Data & results" icon="database" href="/flipsideai/data-and-results">
    Validate and export Workflow outputs
  </Card>

  <Card title="Rules" icon="sliders" href="/flipsideai/rules">
    Customize how Workflow results are presented
  </Card>
</CardGroup>