From f408203b446b87ce4fcae5a2fd38d646341163d9 Mon Sep 17 00:00:00 2001
From: nathan <nathan@castaldifamily.com>
Date: Tue, 14 Apr 2026 15:16:36 -0400
Subject: [PATCH] docs: update README and DEMO_GUIDE links for improved
 navigation and clarity

---
 DEMO_GUIDE.md |  2 +-
 README.md     | 35 ++++++-----------------------------
 2 files changed, 7 insertions(+), 30 deletions(-)

diff --git a/DEMO_GUIDE.md b/DEMO_GUIDE.md
index e28f464..892ee1d 100644
--- a/DEMO_GUIDE.md
+++ b/DEMO_GUIDE.md
@@ -351,4 +351,4 @@ python src/main.py
 2. Explore the pre-seeded drift scenarios using audit tools in Claude chat
 3. Populate `.env` with live credentials for available systems
 4. Enable additional shards as credentials are provisioned
-5. Review `nexus-mcp/README.md` for the full tool reference and NEXUS work item tracking
+5. Review [README.md](README.md) for the full tool reference and NEXUS work item tracking
diff --git a/README.md b/README.md
index 63af5a2..479ec9c 100644
--- a/README.md
+++ b/README.md
@@ -225,7 +225,7 @@ pip install -e .
 python src/main.py          # or: nexus-mcp
 ```
 
-## Claude Desktop Config
+## Claude Desktop config
 
 ```json
 {
@@ -236,35 +236,12 @@ python src/main.py          # or: nexus-mcp
       "cwd": "/path/to/nexus-mcp"
     }
   }
-}Sprint Status & Next Steps
-
-### ✅ Recently Completed (2026-04-13)
-- Async audit execution for high-volume scans
-- Enterprise resilience framework (retry logic, circuit breakers)
-- Pydantic schema standardization for cross-system data
-- Code health report with actionable improvements
-
-### 🟡 In Progress
-- **Pytest validation** of all 33 tools against live APIs
-- **Workday API credential approval** (NEXUS-009)
-- **Claude Desktop integration testing** with updated config
-
-### 🔴 Blocked / Pending Approval
-- **ITSM shard (BMC Helix):** AR-JWT credentials pending
-- **Assets shard (Lansweeper + Intune):** GraphQL + Graph API setup
-- **Logistics shard (FedEx):** OAuth2 client registration
+}
+```
 
 ---
 
-## Required Permissions
+## Required permissions
 
-See [Local-Setup.md](Local-Setup.md) for the full permission matrix and credential configuration guide
-All credentials can live in `nexus-mcp/.env` — no need to put them in the Claude config.
-
----
-
-## Required Permissions
-
-See [Local-Setup.md](Local-Setup.md) for the full permission matrix for each system.
-The same requirements apply here — Nexus-MCP is a refactor of that server,
-not a new system.
+See [DEMO_GUIDE.md](DEMO_GUIDE.md) for the full permission matrix, credential configuration, and live-mode setup.
+All credentials live in `nexus-mcp/.env` — no need to put them in the Claude config.