Update Navi

Author: webosa

docs/system_manual/setup_guide.md

@@ -1,7 +1,7 @@
-<!-- VALIDATION_CHECKLIST: ["## PART A", "## PART B", "## PART C", "Visual Assets Standard", "Task: Standardize Package Headers", "Task: Update Structure Documentation"] -->
+<!-- VALIDATION_CHECKLIST: ["## PART A", "## PART B", "## PART C", "## PART D", "## PART E", "## PART F", "Visual Assets Standard", "Task: Standardize Package Headers"] -->
 # EvisHomeLab: Documentation System Manual
 
-**Version:** 7.3 (Added Local Commit Workflow)
+**Version:** 8.1 (Modularized)
 **Philosophy:** Agentic CMDB (Configuration Management Database)
 **Strategy:** "Detached Docs" (Private Config -> Public Documentation)
 
@@ -48,69 +48,70 @@ Create `.antigravity/rules.md`:
 * **Trust Git:** Terminal > `git config --global --add safe.directory '*'`.
 
 ---
-## PART C: Daily Operations (The Workflow)
+## PART C: Core Concepts & Standards
 
-### 1. The Full Maintenance Cycle
+### 1. Visual Assets Standard
+Images must be sorted into subfolders to keep the repo clean.
+* **Dashboards:** `docs/assets/images/dashboards/view_[path].png`
+* **Packages:** `docs/assets/images/packages/[name].png`
+* **Brand:** `docs/assets/images/brand/`
+
+### 2. Locking Files (Prevent Overwrite)
+To protect a manually written page from the Agent:
+* Add `auto_update: false` to the YAML frontmatter at the top of the Markdown file.
+
+### 3. Tagging Strategy
+Use YAML frontmatter to categorize pages for the Tag Cloud.
+* **Standard Tags:** `package`, `dashboard`, `network`, `automated`, `manual`.
+
+---
+
+## PART D: Daily Operations (The Workflow)
+
+### 1. The Full Maintenance Cycle (Recommended)
 Run these commands in order to keep everything synced.
 
-1.  **Mass Commit Config (Local):** Saves all Home Assistant changes to your local history.
-    ```powershell
-    git add .; git commit -m "Work in progress: Config updates"
-    ```
-2.  **Update Tools:** `python ag_update_docs.py` (Refreshes manual/scripts).
+1.  **Commit Config (Local Repo A):**
+    * `git add .; git commit -m "WIP: Config updates"`
+2.  **Update Tools:**
+    * `python ag_update_docs.py` (Refreshes manual/scripts).
 3.  **Regenerate Docs:**
     * Dashboards: `python ag_regenerate_dashboards.py`
     * Packages: `python ag_update_package.py --all`
-4.  **Publish Docs (Public):**
-    ```powershell
-    cd docs_site; git add .; git commit -m "Routine update"; git push
-    ```
+4.  **Publish Docs (Public Repo B):**
+    * `cd docs_site; git add .; git commit -m "Routine update"; git push`
 
 ### 2. The AI Architect Workflow
 **Start new chats with:** "I am resuming EvisHomeLab. Read `docs_site/AI_CONTEXT.md` and `docs_site/docs/system_manual/setup_guide.md`. Adopt the persona."
 
-### 3. Visual Assets Standard
-* **Dashboards:** `docs/assets/images/dashboards/view_[path].png`
-* **Packages:** `docs/assets/images/packages/[name].png`
-* **Brand:** `docs/assets/images/brand/`
-
-### 4. The Agent Prompts
+### 3. The Agent Prompts
 
-**Task: Standardize Package Headers (Source Code Management)**
-> "Scan the `packages/` directory. For every YAML file:
-> 1. **Analyze:** Read the file to determine its dependencies (entities used) and purpose.
-> 2. **Check Header:** Look for an existing top comment block.
-> 3. **Action:**
->    - **If missing:** Prepend the standard header.
->    - **If present but legacy/incomplete:** REPLACE the existing top comments with the standard header format (ensure `Version` is present).
->    - **Standard Header Format:**
+**Task: Standardize Package Headers**
+> "Scan `packages/`. Check headers. If missing/legacy, prepend:
 >    ```yaml
 >    # ------------------------------------------------------------------------------
 >    # Package: [Filename]
 >    # Version: 1.0.0
->    # Description: [Agent-generated summary]
->    # Dependencies: [List of major entities/integrations detected]
+>    # Description: [Summary]
+>    # Dependencies: [Entities used]
 >    # ------------------------------------------------------------------------------
 >    ```"
 
-**Task: Update Package Documentation (Focus Mode)**
+**Task: Update Single Package (Focus Mode)**
 > "Run `python ag_update_package.py [package_name]`."
-> *(Fallback: "Update `[package].md` reading from `[package].yaml`. Check frontmatter `auto_update`.")*
+> *(Fallback: "Update `[package].md` reading from `[package].yaml`. Check `auto_update` lock.")*
 
-**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: Update Architecture (Structure & Overview)**
+> "Update `docs_site/docs/smart-home/structure.md` AND `docs_site/docs/index.md`.
+> 1. **Structure:** Re-scan root. Update file tree.
+> 2. **Overview:** Update 'High Level Architecture' with new integrations."
 
 **Task: Web Design & Image Management**
 > "Scan `assets/images/`. Update Markdown files to replace placeholder text with actual image links. If asking for CSS changes, edit `assets/css/custom.css`."
 
-**Task: Generate All Package Documentation (Manual Fallback)**
+**Task: Generate All Package Documentation**
 > "Deep scan `packages/`. Create Markdown for all files with: Frontmatter tags, Summary, Architecture Diagram, Redacted Code, Dashboard connections, and Visuals."
 
-**Task: Enable Tags & Tag Cloud**
-> "Edit `docs_site/mkdocs.yml`. Add `- tags` under `plugins:`."
-
 ---
 ## PART E: Tool Reference
 
@@ -121,10 +122,7 @@ The Master Orchestrator. Imports content from `.ag_definitions/`, validates it,
 The Privacy Engine. Reads `.storage/lovelace_dashboards`, performs regex-based name redaction (Jukka->Evis), and outputs clean YAML blocks.
 
 ### 3. `ag_update_package.py`
-The Package Doc Generator. 
-* **Single Mode:** `python ag_update_package.py heating` (Updates one file).
-* **Batch Mode:** `python ag_update_package.py --all` (Updates all packages).
-* **Features:** Extracts header metadata (Version/Desc), checks for `auto_update: false` locks, and redacts secrets.
+The Package Doc Generator. Reads a specific package YAML, extracts header metadata (Version/Desc), and updates the specific Markdown file.
 
 ---
 ## PART F: Troubleshooting