Update docs

Author: webosa

docs/smart-home/dashboards.md

@@ -1,3 +1,9 @@
+---
+tags:
+  - dashboard
+  - automated
+---
+
 # Home Assistant Dashboards
 
 This documentation is automatically generated from the live configuration.

docs/system_manual/setup_guide.md

@@ -1,6 +1,6 @@
 # EvisHomeLab: Documentation System Manual
 
-**Version:** 3.8
+**Version:** 3.9
 **Philosophy:** Agentic CMDB (Configuration Management Database)
 **Strategy:** "Detached Docs" (Private Config -> Public Documentation)
 
@@ -178,18 +178,7 @@ These settings are stored on your laptop, not the server, so you must set them a
 
 ## PART C: Daily Operations (The Workflow)
 
-### 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 |
-
-**Note:** The dashboard script `ag_regenerate_dashboards.py` automatically generates links assuming the `view_[path].png` format. If your image is missing, the link will be broken on the site.
-
-### 2. The Full Maintenance Cycle
+### 1. The Full Maintenance Cycle
 1.  **Update Tools:** `python ag_update_docs.py`
 2.  **Regenerate Dashboards:** `python ag_regenerate_dashboards.py`
 3.  **Publish:**
@@ -200,7 +189,28 @@ When adding images, you **must** use the correct naming convention so the automa
     git push
     ```
 
-### 3. The Agent Prompts
+### 2. The AI Architect Workflow (Resume Work)
+**When starting a new Chat Session with an AI Model:**
+Paste this prompt to "hydrate" the AI with the project context:
+
+> "I am resuming work on the **EvisHomeLab** project.
+>
+> **Task:**
+> 1. Read the attached **`docs_site/AI_CONTEXT.md`** to load your Persona, Architecture constraints, and Safety Rules.
+> 2. Read the attached **`docs_site/docs/system_manual/setup_guide.md`** to understand the operational workflows.
+>
+> **Action:** Confirm you have loaded the context and are ready to assist with maintaining the CMDB."
+
+### 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
 
 **Task: Update Single Package (Focus Mode)**
 > "Update the documentation for the **[PACKAGE_NAME]** package.
@@ -210,6 +220,22 @@ When adding images, you **must** use the correct naming convention so the automa
 > 4. **Dashboard Links:** Scan `.storage/lovelace_dashboards` for cards using these entities and embed them.
 > 5. **Visuals:** Look in `assets/images/packages/` for an image named `[PACKAGE_NAME].png` or `[PACKAGE_NAME]_card.png`. If found, display it. If not, use a placeholder."
 
+**Task: Generate All Package Documentation (Full Scan)**
+> "Perform a deep architectural scan of my `packages/` directory.
+> **For EVERY YAML file found, create a corresponding Markdown file in `docs_site/docs/smart-home/packages/` containing:**
+> 1. **Frontmatter:** Add tags `['package', 'automated']`.
+> 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`. 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."
+
+**Task: Update Structure Documentation**
+> "Update `docs_site/docs/smart-home/structure.md`.
+> 1. Re-scan the root directory and update the file tree structure description (Folders first, then files).
+> 2. Read `configuration.yaml` and update the commented code block explanation."
+
 **Task: Enable Tags & Tag Cloud**
 > "Edit `docs_site/mkdocs.yml`.
 > 1. Under `plugins:`, add `- tags`.