Haruno Knowledge base

Create and manage Playbooks

How to write, edit, duplicate and delete Playbooks in the Windows app, what each field means, and the difference between a personal and a project Playbook.

  • Mac appAvailable
  • Windows appAvailable

Playbooks are managed in one window. Open the Playbooks menu in the menu bar and choose Manage Playbooks…. To run a Playbook, see Playbooks.

The Playbooks window: your list on the left, the selected Playbook on the right.
The Playbooks window. A list of two Playbooks is on the left. On the right, the fields of the selected one: Save in, Command name, Display name, Description, When to use, Instructions and Parameters. Save and Cancel are at the bottom.The Playbooks window. A list of two Playbooks is on the left. On the right, the fields of the selected one: Save in, Command name, Display name, Description, When to use, Instructions and Parameters. Save and Cancel are at the bottom.

Make a new Playbook

  1. Press New

    Press New under the search box. Use Search Playbooks to find an existing one.

  2. Name it

    Fill in the fields at the top.

    FieldWhat it is for
    Save inPersonal keeps it for you, in every project. Current project keeps it with the project that is open.
    Command nameThe word you type after the slash. Up to 64 letters, numbers, hyphens or underscores, starting with a letter or number.
    Display nameThe title shown in lists.
    DescriptionOne line saying what it does.
    When to useA note on when it fits.
  3. Write the instructions

    Write what Haruno should do in Instructions. If a short note is all you have, press AI Optimize beside the field. It turns the note into full instructions. Undo brings your own text back.

  4. Add parameters if you need them

    Open Parameters to add blanks that you fill in each time you run it. Parameter hint is a short reminder, such as <company>. In Parameter names (space separated), list the names with a space between them. Use a name in the instructions with a dollar sign, for example $company. A name can use letters, numbers, hyphens and underscores. It cannot be only digits, and each name must be different.

  5. Save

    Press Save. Cancel throws away your changes and closes the window.

If you have no project open, Current project is unavailable and the window says to open a project to save Playbooks there. You can change Save in later. Saving then moves the Playbook, and the window tells you so.

Edit, copy and delete

Click a Playbook in the list to open it.

  • Duplicate makes a copy to start from.
  • Show in Explorer opens the folder that holds it. For a learned Playbook it opens the folder Haruno saved it in.
  • Delete moves it to the Recycle Bin after you confirm, so it can be recovered.
  • Keep as My Playbook appears on a Learned by Haruno Playbook. It copies the Playbook into your list and removes the learned copy in one step. If the copy cannot be made, nothing changes.

Built into Haruno Playbooks are read-only. You can open them to read what they do, and they have no Save, Duplicate or Delete.

A small person icon marks a personal Playbook. A folder icon marks a project one.

The window shows up to 500 Playbooks from each place. If there are more, it says so.

When saving does not work

If the Playbook was changed outside the window while you were editing, Haruno keeps your text on screen and asks you to reopen the Playbook to see the latest version. Some documents cannot be edited reliably here. They are shown read-only, with a note to open them in a text editor. A name already in use is refused.

What to tell a customer

Start with one Playbook for a task done every week, such as a month review or a status email. Give it a parameter for the part that changes, so the customer only types the company name.

Last updated · PR #2878 · View this version on GitHub

History (2 versions)
  1. Windows Playbooks: built-in and learned lists, Keep as mine, used-Playbook lines (#2856) (#2878)
    What changed
    @@ -48,8 +48,11 @@ If you have no project open, **Current project** is unavailable and the window s
     Click a Playbook in the list to open it.
     
     - **Duplicate** makes a copy to start from.
    -- **Show in Explorer** opens the folder that holds it.
    +- **Show in Explorer** opens the folder that holds it. For a learned Playbook it opens the folder Haruno saved it in.
     - **Delete** moves it to the Recycle Bin after you confirm, so it can be recovered.
    +- **Keep as My Playbook** appears on a **Learned by Haruno** Playbook. It copies the Playbook into your list and removes the learned copy in one step. If the copy cannot be made, nothing changes.
    +
    +**Built into Haruno** Playbooks are read-only. You can open them to read what they do, and they have no Save, Duplicate or Delete.
     
     A small person icon marks a personal Playbook. A folder icon marks a project one.
     
    
  2. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    What changed
    @@ -0,0 +1,64 @@
    +---
    +title: Create and manage Playbooks
    +summary: How to write, edit, duplicate and delete Playbooks in the Windows app, what each field means, and the difference between a personal and a project Playbook.
    +feature: playbooks
    +covers:
    +  - windows-client/haruno-webview/web/src/components/playbooks/PlaybookManagerDialog.tsx
    +  - windows-client/Haruno.Desktop.Services/Playbooks/PlaybookService.cs
    +  - windows-client/Haruno.Desktop.Core/Playbooks/PlaybookDocument.cs
    +  - windows-client/docs/playbooks-fluent.md
    +---
    +
    +Playbooks are managed in one window. Open the **Playbooks** menu in the menu bar and choose **Manage Playbooks…**. To run a Playbook, see [Playbooks](/windows/chat/playbooks/).
    +
    +<Shot src="/m/8ca1badd05fa-windows-chat-playbooks-manager-light.png" dark="/m/c45ed3b98756-windows-chat-playbooks-manager-dark.png" alt="The Playbooks window. A list of two Playbooks is on the left. On the right, the fields of the selected one: Save in, Command name, Display name, Description, When to use, Instructions and Parameters. Save and Cancel are at the bottom." caption="The Playbooks window: your list on the left, the selected Playbook on the right." />
    +
    +## Make a new Playbook
    +
    +<Steps>
    +<Step title="Press New">
    +Press **New** under the search box. Use **Search Playbooks** to find an existing one.
    +</Step>
    +<Step title="Name it">
    +Fill in the fields at the top.
    +
    +| Field | What it is for |
    +|---|---|
    +| **Save in** | **Personal** keeps it for you, in every project. **Current project** keeps it with the project that is open. |
    +| **Command name** | The word you type after the slash. Up to 64 letters, numbers, hyphens or underscores, starting with a letter or number. |
    +| **Display name** | The title shown in lists. |
    +| **Description** | One line saying what it does. |
    +| **When to use** | A note on when it fits. |
    +</Step>
    +<Step title="Write the instructions">
    +Write what Haruno should do in **Instructions**. If a short note is all you have, press **AI Optimize** beside the field. It turns the note into full instructions. **Undo** brings your own text back.
    +</Step>
    +<Step title="Add parameters if you need them">
    +Open **Parameters** to add blanks that you fill in each time you run it. **Parameter hint** is a short reminder, such as `<company>`. In **Parameter names (space separated)**, list the names with a space between them. Use a name in the instructions with a dollar sign, for example `$company`. A name can use letters, numbers, hyphens and underscores. It cannot be only digits, and each name must be different.
    +</Step>
    +<Step title="Save">
    +Press **Save**. **Cancel** throws away your changes and closes the window.
    +</Step>
    +</Steps>
    +
    +If you have no project open, **Current project** is unavailable and the window says to open a project to save Playbooks there. You can change **Save in** later. Saving then moves the Playbook, and the window tells you so.
    +
    +## Edit, copy and delete
    +
    +Click a Playbook in the list to open it.
    +
    +- **Duplicate** makes a copy to start from.
    +- **Show in Explorer** opens the folder that holds it.
    +- **Delete** moves it to the Recycle Bin after you confirm, so it can be recovered.
    +
    +A small person icon marks a personal Playbook. A folder icon marks a project one.
    +
    +The window shows up to 500 Playbooks from each place. If there are more, it says so.
    +
    +<Callout variant="info" title="When saving does not work">
    +If the Playbook was changed outside the window while you were editing, Haruno keeps your text on screen and asks you to reopen the Playbook to see the latest version. Some documents cannot be edited reliably here. They are shown read-only, with a note to open them in a text editor. A name already in use is refused.
    +</Callout>
    +
    +<Callout variant="tip" title="What to tell a customer">
    +Start with one Playbook for a task done every week, such as a month review or a status email. Give it a parameter for the part that changes, so the customer only types the company name.
    +</Callout>