diff --git a/README.md b/README.md
index 2e8b577..55e4f5a 100644
--- a/README.md
+++ b/README.md
@@ -9,23 +9,45 @@ Use Claude Code to create, test, diagnose and document your Genesys Cloud's Arch
This plugin allows you to:
* [Create architect flows of any type](#create-architect-flows-of-any-type)
+* [Document an entire flow](#document-an-entire-flow)
* [Run automated tests against Digital flows](#run-automated-tests-against-digital-flows)
-* [Create and test flow expressions](#create-and-test-flow-expressions)
-* [Inspect and fix issues in flows](#inspect-and-fix-issues-in-flows)
-* [Document flows](#document-flows)
+* [Create flow expressions](#create-flow-expressions)
+* [Identify issues with a flow](#identify-issues-with-a-flow)
+* [Asking questions of a flow](#asking-questions-of-a-flow)
* _and more..._
-## Getting started
+## Installation
-Follow the [installation guide](#installation), then simply tell Claude Code what you want it to do.
+1. Open Claude Code
+2. Type the following to add the marketplace for the plugin and install it:
+ 1. Add the marketplace
+ ```
+ /plugin marketplace add MakingChatbots/genesys-cloud-plugins
+ ```
-Below are examples of each of its capabilities:
+ 2. Install the plugin
+ ```
+ /plugin install genesys-cloud-architect@makingchatbots-genesys-cloud-plugins
+ ```
+3. When asked, provide the Credentials for an OAuth Client with the following permissions:
+ * `Architect > Flow > *`
+ * `Architect > Job > *`
+ * `Architect > UI > *`
+ * `Language Understanding > NLU Domain Version > View`
+ * `Textbots > *`
+ * `Architect > Dependency Tracking > View`
+ * `Routing > Queue > View`
-### Create architect flows of any type
+## Usage
+
+Once you've installed the plugin simply ask Claude to create, explain, test, diagnose flow, and much more...
-Asking Claude Code to create a flow will have it create, publish and test a flow using the [Architect Scripting SDK](https://mypurecloud.github.io/purecloud-flow-scripting-api-sdk-javascript/).
+Here are some examples of what it can do:
-Below is an example of a simple flow, but they can be much more complex:
+### Create architect flows of any type
+
+Manually dragging boxes in Architect can now become a thing of the past. Simply tell Claude what
+you want the flow to do and have it create, publish and test it using the [Architect Scripting SDK](https://mypurecloud.github.io/purecloud-flow-scripting-api-sdk-javascript/):
> Create a Bank bot flow with two intents: "Check Account Balance" (collects an 8-digit AccountNumber slot) and "Find a Branch" (collects a 5-digit ZipCode slot).
>
@@ -46,6 +68,22 @@ Resulting in a flow:
[Read more...](https://makingchatbots.com/i/200764669/create-your-flows-with-ai)
+### Document an entire flow
+
+The more complex a flow becomes the harder it is to understand. Since this plugin allows Claude Code to
+understand flows, it can be used to document them too...
+
+> Document the flow "Bank Bot".
+>
+> Show me how it hangs together, quote what the bot actually says at each step,
+> and flag anything that looks wrong.
+>
+> If it is too big for one diagram, split it by responsibility.
+
+
+
+[Read more...](https://makingchatbots.com/i/213933939/documenting-your-flows-with-ai)
+
### Run automated tests against Digital flows
The plugin allows Claude Code to run tests against Digital bot flows. This is useful when
@@ -55,7 +93,10 @@ it's developing flows, or simply to test for edge-cases in existing flows:
-### Create and test flow expressions
+### Create flow expressions
+
+The plugin can create expressions for you, along with an explanation of how they work. It does this by creating
+a test harness in a Digital bot flow which it can then create and test the expression in.
> My Genesys Architect flow needs to extract the 'author' from the JSON retrieved from a participant attribute below:
>
@@ -65,49 +106,46 @@ it's developing flows, or simply to test for edge-cases in existing flows:
>
> Create a Digital Bot flow to test your expression against different test cases.
-
[Read more...](https://makingchatbots.com/i/200764669/create-and-test-expressions)
-### Inspect and fix issues in flows
+### Identify issues with a flow
-TODO Add example
+Issues in flows can easily go unnoticed, quietly affecting customers. They're now easily identified by simply asking
+Claude Code to look for them:
-### Document flows
+> Review the flow "Main Intent Router" for problems.
+>
+> Give me a table of every issue you find, ordered by severity,
+> with what it would mean for a customer and where in the flow to fix it.
-TODO Add example
+
-## Installation
+[Read more...](https://makingchatbots.com/i/213933939/identify-issues-with-a-flows)
-1. Open Claude Code
-2. Type the following to add the marketplace and install the plugin:
- 1. Add the marketplace
- ```
- /plugin marketplace add MakingChatbots/genesys-cloud-plugins
- ```
+### Asking questions of a flow
- 2. Install the plugin
- ```
- /plugin install genesys-cloud-architect@makingchatbots-genesys-cloud-plugins
- ```
-3. When asked, provide the Credentials for an OAuth Client with the following permissions:
- * `Architect > Flow > *`
- * `Architect > Job > *`
- * `Architect > UI > *`
- * `Language Understanding > NLU Domain Version > View`
- * `Textbots > *`
- * `Architect > Dependency Tracking > View`
- * `Routing > Queue > View`
+It isn't always easy to know why or how the flow behaves in a particular way, so now
+you can ask how parts of your flow work:
+
+> Explain why the "Was the book bought in store?" question in the flow
+> "Main Intent Router" goes silent when the customer doesn't answer.
+>
+> Use simple illustrations to help me understand.
+
+
+
+[Read more...](https://makingchatbots.com/i/213933939/asking-questions-of-a-flow)
## Who built this?
-This is built by [Lucas Woodward](https://makingchatbots.com/about#§who-am-i).
+This is built by me, [Lucas Woodward](https://makingchatbots.com/about#§who-am-i).
-I've been building this in public - engaging with the Genesys community with each milestone. If you'd like to keep up
-to date with releases then [follow me on LinkedIn](https://www.linkedin.com/in/lucas-woodward-the-dev/).
+I've been building this in public, and engaging with the Genesys community with each milestone.
+If you'd like to keep up to date with releases then [follow me on LinkedIn](https://www.linkedin.com/in/lucas-woodward-the-dev/).
-What else I have built:
+These are some of the other projects I've built:
* [Genesys Cloud MCP Server](https://github.com/MakingChatbots/genesys-cloud-mcp-server)
* [Genesys Cloud n8n community node](https://github.com/MakingChatbots/n8n-nodes-genesys-cloud)
diff --git a/docs/assets/flow-documentation.png b/docs/assets/flow-documentation.png
new file mode 100644
index 0000000..1dd1ea9
Binary files /dev/null and b/docs/assets/flow-documentation.png differ
diff --git a/docs/assets/flow-explanation.png b/docs/assets/flow-explanation.png
new file mode 100644
index 0000000..378b857
Binary files /dev/null and b/docs/assets/flow-explanation.png differ
diff --git a/docs/assets/identify-flow-issues.png b/docs/assets/identify-flow-issues.png
new file mode 100644
index 0000000..ff5238d
Binary files /dev/null and b/docs/assets/identify-flow-issues.png differ