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 implements a comprehensive optimization of all sub-agent prompt
definitions based on Opus-powered prompt engineering analysis. All agents now
match the quality standard established by librarian.md.
Agent Improvements:
- scribe.md: 29→340 lines (11.7x expansion)
* Added 6 usage examples with role clarity
* Implemented comprehensive responsibilities section
* Added 3 complete ASCII diagram templates
* Included safety protocols and decision frameworks
- backend-builder.md: 40→291 lines (7.3x expansion)
* Added 6 usage examples with clear boundaries
* Expanded core responsibilities (Ansible, Terraform, Docker, Python, Shell)
* Added technology stack and validation rules tables
* Included handoff protocol for lab-operator deployment
* Defined clear boundaries (CREATES code, does NOT deploy)
- lab-operator.md: 37→193 lines (5.2x expansion)
* Added 6 usage examples with role clarity
* Expanded domain expertise with specific commands
* Added command style guide (5-step pattern)
* Included safety protocols and decision-making framework
* Defined clear boundaries (DEPLOYS/OPERATES, does NOT create IaC)
- librarian.md: Minor formatting improvements
CLAUDE.md Fixes:
- Moved YAML frontmatter to line 1 (was incorrectly at line 89)
- Fixed trailing pipe character
- Completed incomplete sentences about backup strategy and storage growth
- Removed redundant information
- Expanded status file template with recovery instructions
Files Added:
- Claude_UPDATES.md: Comprehensive prompt engineering analysis report
- monitoring/pve-exporter/pve.yml: PVE monitoring configuration
Impact:
- Total agent documentation: 249→967 lines (288% increase)
- Usage examples: 6→24 total (400% increase)
- All agents now have comprehensive safety protocols
- Clear role boundaries prevent agent overlap
- Validation testing confirms all agents functional
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
