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

# Using Playbooks

## How to use Playbooks

To use playbooks simply select one from your Team or the Community library. You've successfully attached a playbook if you see a blue pill appear, along with an inline component for editing the playbook before starting your session.

<video controls className="w-full aspect-video" src="https://mintcdn.com/cognitionai-enterprise/A1NrXl_1--Cgx5nh/images/using_playbooks1.mp4?fit=max&auto=format&n=A1NrXl_1--Cgx5nh&q=85&s=6ae11d377e79eecb422314084ef1e38b" data-path="images/using_playbooks1.mp4" />

Alternatively, you can attach a `<filename>.devin.md` file when you start your Devin session.

### Using macros

If a playbook has a **macro** assigned (e.g., `!data-tutorial`), you can quickly attach it by typing the macro name in the prompt input box. This is a convenient shortcut when you know the macro identifier for the playbook you want to use.

Once you start the session, you should see your playbook show up with a grey background in the chat with Devin!

<Frame>
  <img src="https://mintcdn.com/cognitionai-enterprise/p6mfZwd14EeP9cx_/images/playbooks6.png?fit=max&auto=format&n=p6mfZwd14EeP9cx_&q=85&s=b293357b475e072c65509f107ab99d61" alt="Devin" width="1836" height="1296" data-path="images/playbooks6.png" />
</Frame>

## Refining Playbooks

As you run a new playbook with Devin, you'll identify opportunities to improve the instructions so that Devin can complete the task more reliably. Here are some helpful features for **iterating on playbooks live**:

<Frame>
  <img src="https://mintcdn.com/cognitionai-enterprise/p6mfZwd14EeP9cx_/images/playbooks8.png?fit=max&auto=format&n=p6mfZwd14EeP9cx_&q=85&s=e0e3e9ff1f8522102d9f83dbc7e52ccc" alt="Devin" width="1002" height="240" data-path="images/playbooks8.png" />
</Frame>

## Example Gallery

Check out the Community Gallery at [https://app.devin.ai/playbooks](https://app.devin.ai/playbooks):

<Frame>
  <img src="https://mintcdn.com/cognitionai-enterprise/p6mfZwd14EeP9cx_/images/playbooks9.png?fit=max&auto=format&n=p6mfZwd14EeP9cx_&q=85&s=50909ef9fc22406231fc86dbdd4f7a91" alt="Devin" width="1989" height="1000" data-path="images/playbooks9.png" />
</Frame>
