docs(infrastructure): correct VM/template counts and clarify resource types

Update infrastructure documentation across all files to accurately distinguish
between active VMs (8), templates (2), and LXC containers (4). Previously,
VM templates 104 (ubuntu-dev) and 107 (ubuntu-docker) were incorrectly counted
as active VMs, inflating the total VM count to 10.

Changes:
- CLAUDE.md: Update Quick Reference and Infrastructure Overview sections
- CLAUDE_STATUS.md: Add dedicated VM Templates section with explanatory note
- INDEX.md: Separate templates from active VMs in infrastructure inventory
- README.md: Add VM Templates section distinguishing from active VMs
- Claude_UPDATES.md: Update infrastructure counts in Quick Reference tables
- services/README.md: Correct footer infrastructure counts
- sub-agents/*.md: Update infrastructure context in all agent prompts

This ensures accurate resource tracking and clarifies that templates are
immutable base images for cloning, not running workloads.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
2025-12-08 13:11:29 -07:00
parent 004e3da77c
commit d3dc899b30
9 changed files with 39 additions and 21 deletions

View File

@@ -5,7 +5,8 @@ infrastructure_source: CLAUDE_STATUS.md
repository_type: homelab repository_type: homelab
primary_node: serviceslab primary_node: serviceslab
proxmox_version: 8.3.3 proxmox_version: 8.3.3
vm_count: 10 vm_count: 8
template_count: 2
lxc_count: 4 lxc_count: 4
working_directory: /home/jramos/homelab working_directory: /home/jramos/homelab
git_remote: http://192.168.2.102:3060/jramos/homelab.git git_remote: http://192.168.2.102:3060/jramos/homelab.git
@@ -25,7 +26,7 @@ This is a homelab infrastructure repository managing a Proxmox VE 8.3.3-based se
|----------|-------| |----------|-------|
| **Proxmox Node** | serviceslab (192.168.2.200:8006) | | **Proxmox Node** | serviceslab (192.168.2.200:8006) |
| **Proxmox Version** | PVE 8.3.3 | | **Proxmox Version** | PVE 8.3.3 |
| **Infrastructure** | 10 VMs, 4 LXC containers | | **Infrastructure** | 8 VMs, 2 Templates, 4 LXC containers |
| **Monitoring** | http://192.168.2.114:3000 (Grafana) | | **Monitoring** | http://192.168.2.114:3000 (Grafana) |
| **Version Control** | Gitea at 192.168.2.102:3060 | | **Version Control** | Gitea at 192.168.2.102:3060 |
| **Working Directory** | /home/jramos/homelab | | **Working Directory** | /home/jramos/homelab |
@@ -91,7 +92,8 @@ Is this code/config creation (Ansible, Python, Terraform)?
- **Complete Index**: `INDEX.md` - **Complete Index**: `INDEX.md`
**Quick Summary:** **Quick Summary:**
- **VMs**: 10 total (IDs: 100, 101, 104-111) - **VMs**: 8 total (IDs: 100, 101, 105, 106, 108-111)
- **Templates**: 2 total (IDs: 104, 107)
- **LXC Containers**: 4 total (IDs: 102, 103, 112, 113) - **LXC Containers**: 4 total (IDs: 102, 103, 112, 113)
- **Storage Pools**: local, local-lvm, Vault (ZFS), PBS-Backups, iso-share - **Storage Pools**: local, local-lvm, Vault (ZFS), PBS-Backups, iso-share
- **Monitoring**: VM 101 at 192.168.2.114 (Grafana/Prometheus/PVE Exporter) - **Monitoring**: VM 101 at 192.168.2.114 (Grafana/Prometheus/PVE Exporter)
@@ -135,7 +137,7 @@ If `CLAUDE_STATUS.md` is missing or corrupted, recover it from the latest disast
## Current Infrastructure Snapshot ## Current Infrastructure Snapshot
- Proxmox VE 8.3.3 on serviceslab (192.168.2.200) - Proxmox VE 8.3.3 on serviceslab (192.168.2.200)
- 10 VMs, 4 LXC containers - 8 VMs, 2 Templates, 4 LXC containers
## Current Initiative ## Current Initiative
**Goal**: [Initiative description] **Goal**: [Initiative description]

View File

@@ -10,20 +10,18 @@
- **Version**: Proxmox VE 8.3.3 - **Version**: Proxmox VE 8.3.3
- **Management IP**: 192.168.2.200 - **Management IP**: 192.168.2.200
- **Architecture**: Single-node cluster - **Architecture**: Single-node cluster
- **Total Resources**: 10 VMs, 4 LXC Containers - **Total Resources**: 8 VMs, 2 Templates, 4 LXC Containers
--- ---
## Virtual Machines (QEMU/KVM) - 10 VMs ## Virtual Machines (QEMU/KVM) - 8 VMs
| VM ID | Name | IP Address | Status | Purpose | | VM ID | Name | IP Address | Status | Purpose |
|-------|------|------------|--------|---------| |-------|------|------------|--------|---------|
| 100 | docker-hub | 192.168.2.XXX | Running | Container registry/Docker hub mirror | | 100 | docker-hub | 192.168.2.XXX | Running | Container registry/Docker hub mirror |
| 101 | monitoring-docker | 192.168.2.114 | Running | Monitoring stack (Grafana/Prometheus/PVE Exporter) | | 101 | monitoring-docker | 192.168.2.114 | Running | Monitoring stack (Grafana/Prometheus/PVE Exporter) |
| 104 | ubuntu-dev | - | Stopped | Ubuntu development environment |
| 105 | dev | - | Stopped | General-purpose development workstation | | 105 | dev | - | Stopped | General-purpose development workstation |
| 106 | Ansible-Control | 192.168.2.XXX | Running | IaC orchestration, configuration management | | 106 | Ansible-Control | 192.168.2.XXX | Running | IaC orchestration, configuration management |
| 107 | ubuntu-docker | - | Stopped | Ubuntu Docker host |
| 108 | CML | - | Stopped | Cisco Modeling Labs - network simulation | | 108 | CML | - | Stopped | Cisco Modeling Labs - network simulation |
| 109 | web-server-01 | 192.168.2.XXX | Running | Web application server (clustered) | | 109 | web-server-01 | 192.168.2.XXX | Running | Web application server (clustered) |
| 110 | web-server-02 | 192.168.2.XXX | Running | Load-balanced pair with web-server-01 | | 110 | web-server-02 | 192.168.2.XXX | Running | Load-balanced pair with web-server-01 |
@@ -35,6 +33,17 @@
--- ---
## VM Templates - 2 Templates
| Template ID | Name | Purpose |
|-------------|------|---------|
| 104 | ubuntu-dev | Ubuntu development environment template for cloning |
| 107 | ubuntu-docker | Ubuntu Docker host template for rapid deployment |
**Note**: Templates are immutable base images used for cloning new VMs, not running workloads. They provide standardized configurations for consistent infrastructure provisioning.
---
## Containers (LXC) - 4 Containers ## Containers (LXC) - 4 Containers
| CT ID | Name | IP Address | Status | Purpose | | CT ID | Name | IP Address | Status | Purpose |

View File

@@ -143,7 +143,7 @@ The VM/LXC/Storage tables (lines 17-56) duplicate content from:
|----------|-------| |----------|-------|
| **Proxmox Node** | serviceslab (192.168.2.200:8006) | | **Proxmox Node** | serviceslab (192.168.2.200:8006) |
| **Proxmox Version** | PVE 8.3.3 | | **Proxmox Version** | PVE 8.3.3 |
| **Infrastructure** | 10 VMs, 4 LXC containers | | **Infrastructure** | 8 VMs, 2 Templates, 4 LXC containers |
| **Monitoring** | http://192.168.2.114:3000 (Grafana) | | **Monitoring** | http://192.168.2.114:3000 (Grafana) |
| **Version Control** | Gitea at 192.168.2.102:3060 | | **Version Control** | Gitea at 192.168.2.102:3060 |
| **Working Directory** | /home/jramos/homelab | | **Working Directory** | /home/jramos/homelab |
@@ -867,7 +867,7 @@ model: sonnet
|----------|-------| |----------|-------|
| **Proxmox Node** | serviceslab (192.168.2.200:8006) | | **Proxmox Node** | serviceslab (192.168.2.200:8006) |
| **Proxmox Version** | PVE 8.3.3 | | **Proxmox Version** | PVE 8.3.3 |
| **Infrastructure** | 10 VMs, 4 LXC containers | | **Infrastructure** | 8 VMs, 2 Templates, 4 LXC containers |
| **Monitoring** | http://192.168.2.114:3000 (Grafana) | | **Monitoring** | http://192.168.2.114:3000 (Grafana) |
| **Version Control** | Gitea at 192.168.2.102:3060 | | **Version Control** | Gitea at 192.168.2.102:3060 |
| **Working Directory** | /home/jramos/homelab | | **Working Directory** | /home/jramos/homelab |

View File

@@ -311,16 +311,14 @@ cat scripts/crawlers-exporters/COLLECTION-GUIDE.md
Based on the latest export (2025-12-07 12:00:40), your environment includes: Based on the latest export (2025-12-07 12:00:40), your environment includes:
### Virtual Machines (QEMU/KVM) - 10 VMs ### Virtual Machines (QEMU/KVM) - 8 VMs
| VM ID | Name | Status | Purpose | | VM ID | Name | Status | Purpose |
|-------|------|--------|---------| |-------|------|--------|---------|
| 100 | docker-hub | Running | Container registry/Docker hub mirror | | 100 | docker-hub | Running | Container registry/Docker hub mirror |
| 101 | monitoring-docker | Running | Monitoring stack (Grafana/Prometheus/PVE Exporter) at 192.168.2.114 | | 101 | monitoring-docker | Running | Monitoring stack (Grafana/Prometheus/PVE Exporter) at 192.168.2.114 |
| 104 | ubuntu-dev | Stopped | Ubuntu development environment |
| 105 | dev | Stopped | General-purpose development workstation | | 105 | dev | Stopped | General-purpose development workstation |
| 106 | Ansible-Control | Running | IaC orchestration, configuration management | | 106 | Ansible-Control | Running | IaC orchestration, configuration management |
| 107 | ubuntu-docker | Stopped | Ubuntu Docker host |
| 108 | CML | Stopped | Cisco Modeling Labs - network simulation | | 108 | CML | Stopped | Cisco Modeling Labs - network simulation |
| 109 | web-server-01 | Running | Web application server (clustered) | | 109 | web-server-01 | Running | Web application server (clustered) |
| 110 | web-server-02 | Running | Load-balanced pair with web-server-01 | | 110 | web-server-02 | Running | Load-balanced pair with web-server-01 |
@@ -328,6 +326,13 @@ Based on the latest export (2025-12-07 12:00:40), your environment includes:
**Recent Changes**: Added VM 101 (monitoring-docker) for dedicated observability infrastructure. **Recent Changes**: Added VM 101 (monitoring-docker) for dedicated observability infrastructure.
### VM Templates - 2 Templates
| Template ID | Name | Purpose |
|-------------|------|---------|
| 104 | ubuntu-dev | Ubuntu development environment template for cloning |
| 107 | ubuntu-docker | Ubuntu Docker host template for rapid deployment |
### Containers (LXC) - 4 Containers ### Containers (LXC) - 4 Containers
| CT ID | Name | Status | Purpose | | CT ID | Name | Status | Purpose |
@@ -570,5 +575,5 @@ bash scripts/crawlers-exporters/collect.sh
**Repository Version:** 2.1.0 **Repository Version:** 2.1.0
**Last Updated**: 2025-12-07 **Last Updated**: 2025-12-07
**Latest Export**: disaster-recovery/homelab-export-20251207-120040 **Latest Export**: disaster-recovery/homelab-export-20251207-120040
**Infrastructure**: 10 VMs, 4 Containers, Proxmox VE 8.3.3 **Infrastructure**: 8 VMs, 2 Templates, 4 Containers, Proxmox VE 8.3.3
**Maintained by**: Your homelab automation system **Maintained by**: Your homelab automation system

View File

@@ -17,15 +17,17 @@ This repository contains configuration files, scripts, and documentation for man
### Virtual Machines (QEMU/KVM) ### Virtual Machines (QEMU/KVM)
- **100** - docker-hub: Container registry and Docker hub mirror - **100** - docker-hub: Container registry and Docker hub mirror
- **101** - monitoring-docker: Monitoring stack (Grafana/Prometheus/PVE Exporter) at 192.168.2.114 - **101** - monitoring-docker: Monitoring stack (Grafana/Prometheus/PVE Exporter) at 192.168.2.114
- **104** - ubuntu-dev: Ubuntu development environment
- **105** - dev: General-purpose development environment - **105** - dev: General-purpose development environment
- **106** - Ansible-Control: Infrastructure automation control node - **106** - Ansible-Control: Infrastructure automation control node
- **107** - ubuntu-docker: Ubuntu Docker host
- **108** - CML: Cisco Modeling Labs for network simulation - **108** - CML: Cisco Modeling Labs for network simulation
- **109** - web-server-01: Web application server (clustered) - **109** - web-server-01: Web application server (clustered)
- **110** - web-server-02: Web application server (load-balanced) - **110** - web-server-02: Web application server (load-balanced)
- **111** - db-server-01: Database server - **111** - db-server-01: Database server
### VM Templates
- **104** - ubuntu-dev: Ubuntu development environment template for cloning
- **107** - ubuntu-docker: Ubuntu Docker host template for rapid deployment
### Containers (LXC) ### Containers (LXC)
- **102** - nginx: Reverse proxy and load balancer (Nginx Proxy Manager) - **102** - nginx: Reverse proxy and load balancer (Nginx Proxy Manager)
- **103** - netbox: Network documentation and IPAM - **103** - netbox: Network documentation and IPAM
@@ -176,4 +178,4 @@ For questions about:
*Last Updated: 2025-12-07* *Last Updated: 2025-12-07*
*Proxmox Version: 8.3.3* *Proxmox Version: 8.3.3*
*Infrastructure: 10 VMs, 4 LXC Containers* *Infrastructure: 8 VMs, 2 Templates, 4 LXC Containers*

View File

@@ -588,4 +588,4 @@ For homelab-specific questions or issues:
**Last Updated**: 2025-12-07 **Last Updated**: 2025-12-07
**Maintainer**: jramos **Maintainer**: jramos
**Repository**: http://192.168.2.102:3060/jramos/homelab **Repository**: http://192.168.2.102:3060/jramos/homelab
**Infrastructure**: 10 VMs, 4 LXC Containers **Infrastructure**: 8 VMs, 2 Templates, 4 LXC Containers

View File

@@ -15,7 +15,7 @@ color: orange
<system_role> <system_role>
You are the **Backend Builder** - the Engineer and Craftsman of this homelab. You are an expert DevOps engineer and software developer specializing in Infrastructure as Code, automation pipelines, and system integration. Your mission is to write production-quality code that is idempotent, well-documented, and follows industry best practices. You are the **Backend Builder** - the Engineer and Craftsman of this homelab. You are an expert DevOps engineer and software developer specializing in Infrastructure as Code, automation pipelines, and system integration. Your mission is to write production-quality code that is idempotent, well-documented, and follows industry best practices.
You operate within a Proxmox VE 8.3.3 environment on node "serviceslab" (192.168.2.200), creating automation for 10 VMs and 4 LXC containers. Your code must integrate seamlessly with the existing infrastructure: nginx reverse proxy (CT 102), web servers (VMs 109/110), database server (VM 111), and monitoring stack (VM 101). You operate within a Proxmox VE 8.3.3 environment on node "serviceslab" (192.168.2.200), creating automation for 8 VMs, 2 templates, and 4 LXC containers. Your code must integrate seamlessly with the existing infrastructure: nginx reverse proxy (CT 102), web servers (VMs 109/110), database server (VM 111), and monitoring stack (VM 101).
**Your Persona**: Pragmatic and thorough. You write code that handles edge cases gracefully because homelabs are messy environments. You explain your implementation decisions and never take shortcuts that compromise reliability. **Your Persona**: Pragmatic and thorough. You write code that handles edge cases gracefully because homelabs are messy environments. You explain your implementation decisions and never take shortcuts that compromise reliability.
</system_role> </system_role>

View File

@@ -13,7 +13,7 @@ color: green
<system_role> <system_role>
You are the **Lab Operator** - the Hands-On Systems Administrator of this homelab. You are an expert in Proxmox VE, Docker, Linux administration, networking, and storage management. Your mission is to keep services running, deploy configurations, troubleshoot issues, and maintain system health. You are the **Lab Operator** - the Hands-On Systems Administrator of this homelab. You are an expert in Proxmox VE, Docker, Linux administration, networking, and storage management. Your mission is to keep services running, deploy configurations, troubleshoot issues, and maintain system health.
You operate within Proxmox VE 8.3.3 on node "serviceslab" (192.168.2.200), managing 10 VMs and 4 LXC containers. You execute commands, deploy services, and verify infrastructure state. You operate within Proxmox VE 8.3.3 on node "serviceslab" (192.168.2.200), managing 8 VMs, 2 templates, and 4 LXC containers. You execute commands, deploy services, and verify infrastructure state.
**Your Persona**: Methodical and safety-conscious, like a seasoned sysadmin. You explain your reasoning, warn about risks, and always have a rollback plan. You teach while doing. **Your Persona**: Methodical and safety-conscious, like a seasoned sysadmin. You explain your reasoning, warn about risks, and always have a rollback plan. You teach while doing.
</system_role> </system_role>

View File

@@ -14,7 +14,7 @@ color: blue
<system_role> <system_role>
You are the **Scribe** - the Teacher and Historian of this homelab. You are an expert technical writer and infrastructure architect with deep knowledge of Proxmox VE, Docker, networking, and homelab best practices. Your mission is to ensure that documentation remains accurate, architecture is clearly communicated through diagrams, and complex concepts are explained in accessible language. You are the **Scribe** - the Teacher and Historian of this homelab. You are an expert technical writer and infrastructure architect with deep knowledge of Proxmox VE, Docker, networking, and homelab best practices. Your mission is to ensure that documentation remains accurate, architecture is clearly communicated through diagrams, and complex concepts are explained in accessible language.
You operate within a Proxmox VE 8.3.3 environment on node "serviceslab" (192.168.2.200), managing documentation for 10 VMs and 4 LXC containers. Your documentation serves both human operators and AI agents who rely on accurate, up-to-date information to perform their tasks. You operate within a Proxmox VE 8.3.3 environment on node "serviceslab" (192.168.2.200), managing documentation for 8 VMs, 2 templates, and 4 LXC containers. Your documentation serves both human operators and AI agents who rely on accurate, up-to-date information to perform their tasks.
**Your Persona**: Sophisticated, with a slightly dry wit. Encouraging like a patient professor who genuinely wants the reader to understand. You celebrate clarity over complexity. **Your Persona**: Sophisticated, with a slightly dry wit. Encouraging like a patient professor who genuinely wants the reader to understand. You celebrate clarity over complexity.
</system_role> </system_role>