Update System Manual to 5.5

Author: webosa

docs/system_manual/setup_guide.md

@@ -1,6 +1,19 @@
+<!-- VALIDATION_CHECKLIST: [
+    "## PART A: One-Time Initialization",
+    "## PART B: Workstation Setup",
+    "## PART C: Daily Operations",
+    "The AI Architect Workflow",
+    "Visual Assets Standard",
+    "Task: Web Design & Image Management",
+    "Task: Update Single Package",
+    "Task: Generate All Package Documentation",
+    "ag_regenerate_dashboards.py",
+    "## PART E: Tool Reference",
+    "## PART F: Troubleshooting"
+] -->
 # EvisHomeLab: Documentation System Manual
 
-**Version:** 4.1
+**Version:** 5.1
 **Philosophy:** Agentic CMDB (Configuration Management Database)
 **Strategy:** "Detached Docs" (Private Config -> Public Documentation)
 
@@ -178,48 +191,15 @@ These settings are stored on your laptop, not the server, so you must set them a
 
 ---
 
-## PART C: Core Features & Concepts
-
-### 1. Visual Assets Standard
-When adding images, you **must** use the correct naming convention so the automation scripts can find them.
-
-| Type | Folder Location | Naming Convention |
-| :--- | :--- | :--- |
-| **Dashboards** | `docs/assets/images/dashboards/` | `view_[path].png` (e.g. `view_kitchen.png`) |
-| **Packages** | `docs/assets/images/packages/` | `[package_name].png` (e.g. `heating.png`) |
-| **General** | `docs/assets/images/brand/` | Free choice |
-
-### 2. Locking Files (Prevent Overwrite)
-If you have heavily customized a documentation page and don't want the Agent to touch it again:
-* Add this to the very top of the Markdown file:
-  ```yaml
-  ---
-  auto_update: false
-  ---
-  ```
-* The Agent is instructed to check for this flag and abort if found.
-
-### 3. Tagging Strategy
-We use YAML frontmatter to categorize pages. This enables Tag Clouds on the website.
-* **Standard Tags:** `package`, `dashboard`, `network`, `automated`, `manual`.
-
----
-
-## PART D: Daily Operations (The Workflow)
+## PART C: Daily Operations (The Workflow)
 
 ### 1. The Full Maintenance Cycle (Recommended Routine)
-Run these commands in order to keep everything synced.
+Run this sequence to update everything cleanly.
 
-1.  **Update Tools:**
-    ```powershell
-    cd /; python ag_update_docs.py
-    ```
-2.  **Regenerate Dashboards:**
-    ```powershell
-    cd /; python ag_regenerate_dashboards.py
-    ```
+1.  **Update Tools:** `python ag_update_docs.py` (Ensures you have the latest manual and scripts).
+2.  **Regenerate Dashboards:** `python ag_regenerate_dashboards.py` (Scans HA, redacts names, writes Markdown).
 3.  **Publish:**
-    ```powershell
+    ```bash
     cd docs_site; git add .; git commit -m "Routine update"; git push
     ```
 
@@ -235,7 +215,16 @@ Paste this prompt to "hydrate" the AI with the project context:
 >
 > **Action:** Confirm you have loaded the context and are ready to assist with maintaining the CMDB."
 
-### 3. The Agent Prompts (Execution)
+### 3. Visual Assets Standard
+When adding images, you **must** use the correct naming convention so the automation scripts can find them.
+
+| Type | Folder Location | Naming Convention |
+| :--- | :--- | :--- |
+| **Dashboards** | `docs/assets/images/dashboards/` | `view_[path].png` (e.g. `view_kitchen.png`) |
+| **Packages** | `docs/assets/images/packages/` | `[package_name].png` (e.g. `heating.png`) |
+| **General** | `docs/assets/images/brand/` | Free choice |
+
+### 4. The Agent Prompts (Execution)
 
 **Task: Update Single Package (Focus Mode)**
 > "Update the documentation for the **[PACKAGE_NAME]** package.
@@ -259,7 +248,7 @@ Paste this prompt to "hydrate" the AI with the project context:
 > 2. **Executive Summary:** What does this package do?
 > 3. **Architecture Diagram:** Generate a `mermaid` sequence diagram of the logic.
 > 4. **The Code:** Embed the YAML content in a code block (Redact secrets!).
-> 5. **Dashboard Connections:** Scan `.storage/lovelace_dashboards` to find associated cards.
+> 5. **Dashboard Connections:** Scan `.storage/lovelace_dashboards`. Identify cards that control entities from this package and embed their configuration.
 > 6. **Visuals:** Insert a placeholder link for a screenshot (e.g., `![View](assets/images/heating.png)`).
 > Finally, update `mkdocs.yml` navigation."
 
@@ -276,7 +265,7 @@ Paste this prompt to "hydrate" the AI with the project context:
 **Task: Convert Dashboard to YAML**
 > "Run `python ag_regenerate_dashboards.py`."
 
-### 4. System Integrity Check (Audit)
+### 5. System Integrity Check (Audit)
 **Use when:** You want to verify the system is healthy.
 
 1.  **Run Tool Update:** `python ag_update_docs.py` (Should pass without errors).