chore: clean up readme

Author: dwmkerr

README.md

@@ -37,7 +37,7 @@ Read the developer guide at:
 You MUST follow the rules in this guide. Summarise its intent in three lines.
 ```
 
-Or use the MCP Server:
+Or use the [AI Developer Guide MCP Server](./mcp/ai-developer-guide-mcp/README.md) to integrate with Claude Desktop, Claude Code, VS Code, and other MCP-compatible tools:
 
 ```json
 {
@@ -48,13 +48,11 @@ Or use the MCP Server:
 }
 ```
 
-## MCP Server
+The MCP Server is also available as a [Docker Image](#TODO link to docker guide in mcp readme) and a [Helm Chart](# TODO link to helm chart in mcp readme) which can optionally deploy to [Ark](https://github.com/mckinsey/agents-at-scale-ark).
 
-The AI Developer Guide can also be used with an [MCP (Model Context Protocol) server](./mcp/ai-developer-guide-mcp/README.md) that provides programmatic access to all guides and can be integrated with Claude Desktop, Claude Code, VS Code, and other MCP-compatible tools.
+The AI Developer Guide is like a set of **super-charged coding instructions** for an LLM.
 
-The AI Developer Guide is like a set of super-charged instructions for an LLM.
-
-Now try some prompts such as:
+Try some prompts such as:
 
 - "Look through the AI developer guide and tell me how to improve my project"
 - "What would be the essential patterns for open source for me to implement"

docs/setup.md

@@ -7,6 +7,11 @@ This page describes how to set up specific tools and editors, as well as how to
 - [Tools](#tools)
     - [Visual Studio Code](#visual-studio-code)
     - [Cursor](#cursor)
+        - [1. (Easiest) Just Reference the Guide in Your README.md](#1-easiest-just-reference-the-guide-in-your-readmemd)
+        - [2. Reinforce with Inline Prompts in Chat](#2-reinforce-with-inline-prompts-in-chat)
+        - [3. Optional: Add a Dev Guide Summary as a Code Comment](#3-optional-add-a-dev-guide-summary-as-a-code-comment)
+        - [4. Add the full Guide to Your Project Repo](#4-add-the-full-guide-to-your-project-repo)
+        - [5. Use Cursor's 'Rules' feature (related: 'Memories')](#5-use-cursors-rules-feature-related-memories)
     - [Claude Code](#claude-code)
     - [Claude Desktop](#claude-desktop)
 - [MCP](#mcp)
@@ -152,19 +157,6 @@ You can use the `@dwmkerr/ai-developer-guide` MCP server to integrate your LLM t
 }
 ```
 
-**Docker**: Run with `docker run -p 8080:8080 ghcr.io/dwmkerr/ai-developer-guide-mcp:latest`
-
-**Helm**: Deploy to Kubernetes:
-
-```bash
-# Install from GHCR
-helm upgrade --install ai-developer-guide oci://ghcr.io/dwmkerr/charts/ai-developer-guide-mcp
-
-# With Ark platform support
-helm upgrade --install ai-developer-guide oci://ghcr.io/dwmkerr/charts/ai-developer-guide-mcp \
-  --set mcpServer.create=true
-```
-
 Configuration:
 
 | Parameter    | Usage                                                                    |
@@ -173,6 +165,24 @@ Configuration:
 
 For details on how to build the server locally, debug, extend, check the [MCP Server README](../mcp/ai-developer-guide-mcp/README.md).
 
+Run as a Docker container:
+
+```bash
+docker run -p 8080:8080 ghcr.io/dwmkerr/ai-developer-guide-mcp:latest
+# todo comment the mcp/sse url below.
+```
+
+Deploy to Kubernetes:
+
+```bash
+# Install from GHCR, optionally creating the Ark MCP server resource type.
+helm upgrade --install ai-developer-guide oci://ghcr.io/dwmkerr/charts/ai-developer-guide-mcp \
+  --set mcpServer.create=true
+
+# The MCP Server will be available in Ark:
+kubectl get mcpserver
+```
+
 ## Extending the Guide or Project Specific Guides
 
 Create a file in your project directory, point at the developer guide and then extend with your own requirements: