> For the complete documentation index, see [llms.txt](https://help.jurisphere.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.jurisphere.ai/jurisphere-word-add-in/core-features/review-playbook/running-review-playbooks.md).

# Running Review Playbooks

Selecting a built Review Playbook inside the Word Add-In, reading clause level flags once it runs, and accepting, escalating or fixing a flagged deviation.

## Overview

Once a Review Playbook has been built on the web platform (see [Building Review Playbooks](https://claude.ai/cowork/cse_019A8QdUyX6GKXxDLJs3SeuB#) if you haven't done that yet), run against the real document you have open in Word, producing a clause by clause evaluation against your team's own defined standard.

{% hint style="success" %}
Running a Playbook flags deviations, it does not change your document unless you click on generate edit. Exactly like the suggested edits covered in [Drafting & Editing](/jurisphere-word-add-in/core-features/ask-juris/drafting-and-editing.md), nothing in your document is altered just because a Playbook ran. Every flag is something you review and act on deliberately, not something applied automatically without your permission.
{% endhint %}

<figure><img src="https://1915117185-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe5hzq5uD7DBUBcTTPvL4%2Fuploads%2FW5fyFMOnzWVAWyaAEBaL%2Fimage.png?alt=media&amp;token=27ad44ef-b4d8-462d-b125-11e8148bbcbc" alt=""><figcaption></figcaption></figure>

***

### Where Review Playbooks live in the panel

Review Playbooks sit in their **own tab** in the Word Add-In panel, separate from the **Ask Juris** tab used for questions, drafting instructions and Skills.

<figure><img src="https://1915117185-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe5hzq5uD7DBUBcTTPvL4%2Fuploads%2FsmRjqoXZSbjyLjbH7rBd%2Fimage.png?alt=media&amp;token=f6a22351-32c0-4d4e-a399-ffbb92bf54de" alt=""><figcaption></figcaption></figure>

***

## Running a Playbook against your document

{% stepper %}
{% step %}

### Switch to the Review Playbooks tab

Navigate and switch to the Review Playbooks from either the homepage of Jurisphere Word Add-In or from the top of the panel.
{% endstep %}

{% step %}

### Select the right Playbook for this document

Choose from the list of Playbooks you or your organization has built. For example, Employment Agreement Review Playbook, Vendor Agreement Playbook, etc. Picking the wrong Playbook for the document type will not necessarily fail. The rules with an Applicability Condition that never matches will simply come back **Not Applicable** across the review run, which is itself a useful signal that you may have the wrong Playbook selected.

<figure><img src="https://1915117185-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe5hzq5uD7DBUBcTTPvL4%2Fuploads%2FEhZJ7bxKXnCHJY2gUbPU%2Fimage.png?alt=media&amp;token=93cc6695-5574-497f-a117-4d3ad327e18e" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Review the Playbook's Overview

After clicking on the review playbook you want to run, you’ll see a brief description, input requirements playbook rules covered and an option to start the review.

{% hint style="info" %}
Clicking on any playbook rule expands the card providing an overview of the rule.
{% endhint %}

<figure><img src="https://1915117185-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe5hzq5uD7DBUBcTTPvL4%2Fuploads%2FCVYJOTU0CZ9LqeMvkuAx%2Fimage.png?alt=media&amp;token=fc68cb45-4d43-4f27-84c2-d2d7f680c171" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Run it

Click “Start Review” and the Add-In will assess every rule in the playbook against the document. It presents a structured clause by clause evaluation in the panel.
{% endstep %}

{% step %}

### Reading the results

<figure><img src="https://1915117185-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe5hzq5uD7DBUBcTTPvL4%2Fuploads%2FoukjBdBS36Fj9Zrum0oG%2Fimage.png?alt=media&amp;token=f53946ef-3cb4-4775-8959-2451fd8936e8" alt=""><figcaption></figcaption></figure>

Once a Playbook finishes running, each rule it contains resolves to one of three states for this particular document:

<table><thead><tr><th width="170.8558349609375">Position</th><th>Description</th></tr></thead><tbody><tr><td><h4>Not Acceptable</h4></td><td>The clause falls outside the position your Playbook allows. It does not match your <strong>Starting Position</strong> and it doesn't fall within any of the ranked <strong>Fallback Positions</strong> either. </td></tr><tr><td><h4>Fallback</h4></td><td>The clause does not match your Starting Position, but it does fall within one of the ranked Fallback Positions your Playbook defines as acceptable but not ideal. </td></tr><tr><td><h4>Acceptable</h4></td><td>The clause matches your Starting Position that no negotiation is needed and no edit is required.</td></tr></tbody></table>
{% endstep %}

{% step %}

### Acting on a flagged deviation

Once you're looking at a deviation, you have the same range of actions available across the rest of the Word Add-In.

Use the deviation's citation to navigate straight to the relevant text in your open document and read it in full context, the same way you would with any inline citation elsewhere in the Word Add-In.&#x20;
{% endstep %}

{% step %}

### Turn a deviation into an edit

A Playbook flag does not change anything automatically. To edit it, click on the "Generate Edit" dropdown under any of the unacceptable or fallback positions.

<figure><img src="https://1915117185-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe5hzq5uD7DBUBcTTPvL4%2Fuploads%2FryQTzjf7nCXRQqZ8Al4n%2Fimage.png?alt=media&amp;token=ebfc6b0b-4ce2-46ae-8f29-2046836a344d" alt=""><figcaption></figcaption></figure>

Clicking on the dropdown will open the options for selecting the edit suggestion’s scope. You can choose between the starting position and the fallback positions you had set. Once you’ve made your selection, click “Generate Edit”.

<figure><img src="https://1915117185-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe5hzq5uD7DBUBcTTPvL4%2Fuploads%2F49RNxFlnyJMs95EePhqc%2Fimage.png?alt=media&amp;token=fbea14c5-1a3a-4461-8c4a-578d9540c83d" alt=""><figcaption></figcaption></figure>

Follow the usual navigation steps to move between a show in a document, apply it, apply with a comment and then dismiss the suggestion (see [Reviewing and acting on a suggested edit](/jurisphere-word-add-in/core-features/ask-juris/drafting-and-editing.md#reviewing-and-acting-on-a-suggested-edit)) based on your desired outcome.

<figure><img src="https://1915117185-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe5hzq5uD7DBUBcTTPvL4%2Fuploads%2FxLqEmBr2T7qCD3Qy8pmX%2Fimage.png?alt=media&amp;token=56621e6f-f8c7-4d67-8cca-9bf874b4cdf7" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

If a Playbook raises a question you’re unsure about, don't hesitate to reach out. Schedule a call with our Customer Success team to discuss your concerns and get guidance on building a review playbook, working examples or anything else covered on this page.

<a href="https://cal.com/jayanth-j/jurisphere-custom-session?overlayCalendar=true" class="button primary" data-icon="screen-users">Book a Call</a><a href="https://wa.me/9137020567?utm_medium=email&#x26;_hsenc=p2ANqtz-83DaEWxpPeUPf7IW8f6PUvQQv20MwohaAuMr0JxwQM76240Ln3F7twMR50FameeXzdWhG3i_W75-xdRo7OEBfbR2QOyw&#x26;_hsmi=0&#x26;utm_content=2&#x26;utm_source=hs_email" class="button secondary" data-icon="whatsapp">Reach out to us via WhatsApp</a>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.jurisphere.ai/jurisphere-word-add-in/core-features/review-playbook/running-review-playbooks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
