krmorehead/vm_builds

project-structure-rules

Project architecture and design principles for vm_builds Ansible project. Includes bake vs configure patterns, two-role service model, and deployment lifecycle.

لغة النص الأصلي: الإنجليزية

python-code-style

Python code conventions. Functions return errors, .env parsing strips quotes, type hints required.

لغة النص الأصلي: الإنجليزية

early-validation-patterns

Proactive validation patterns to catch issues early, prevent debugging blind, and establish testing habits before problems escalate.

لغة النص الأصلي: الإنجليزية

learn-from-mistakes

Update skills and rules when encountering new issues to prevent recurrence. Includes hard-fail patterns, code custodianship, and mandatory testing requirements.

لغة النص الأصلي: الإنجليزية

lxc-container-patterns

LXC container provisioning and configuration patterns. Use when creating LXC services, managing container networking, or handling LXC template operations.

لغة النص الأصلي: الإنجليزية

molecule-performance

Molecule test performance optimization patterns. Template caching, NTP sync, pct_remote overhead, apt cache, selective rebuilds.

لغة النص الأصلي: الإنجليزية

molecule-testing-patterns

Molecule testing patterns, TDD workflow, baseline management, and scenario architecture. Use when running tests, managing test workflows, or setting up molecule scenarios.

لغة النص الأصلي: الإنجليزية

molecule-testing

Run and validate Ansible tests. Molecule commands, TDD workflow, layered scenarios, performance optimization.

لغة النص الأصلي: الإنجليزية

testing-workflow

Test-first development, TDD workflow, molecule testing patterns, and diagnostic approaches for Ansible playbooks and infrastructure automation.

لغة النص الأصلي: الإنجليزية

ansible-testing

Run and validate Ansible project tests using Molecule, ansible-lint, and yamllint. Use when running tests, adding test scenarios, debugging test failures, extending verify.yml for new VMs, or working with Molecule configuration in the vm_builds project.

لغة النص الأصلي: الإنجليزية

molecule-cleanup

Molecule cleanup requirements for repeatable Ansible test runs. Cleanup playbooks, credential safety, explicit VMIDs.

لغة النص الأصلي: الإنجليزية

openwrt-mesh-lxc-wifi

OpenWrt Mesh LXC container WiFi PHY management and namespace handling. Use when setting up mesh nodes, managing WiFi radios, or troubleshooting LXC container networking.

لغة النص الأصلي: الإنجليزية

proxmox-cleanup-safety

Proxmox cleanup completeness and maintenance safety patterns. Use when planning cleanup operations, file removal, or maintenance tasks on Proxmox hosts.

لغة النص الأصلي: الإنجليزية

proxmox-host-safety

Validates Ansible tasks and shell commands for safety before executing them against remote Proxmox hosts. Use when writing or reviewing Ansible playbooks, roles, or shell commands that target Proxmox hosts, when running cleanup/restore operations, when…

لغة النص الأصلي: الإنجليزية

code-review-checklist

Code review checklist for vm_builds web UI and Ansible code. Use when reviewing git diffs, auditing code quality, or doing final passes before committing.

لغة النص الأصلي: الإنجليزية

manual-testing-playbook-writing

How to write comprehensive manual testing playbooks. Use when creating manual test procedures for new features, writing playbook sections in docs/manual-testing-playbooks.md, or when a project plan includes Step 6 manual testing.

لغة النص الأصلي: الإنجليزية

molecule-verify

Molecule verify assertion patterns. completeness requirements, batch operations, multi-node patterns.

لغة النص الأصلي: الإنجليزية

openwrt-feature-integration

OpenWrt feature integration via task files and play patterns. Use when adding new features, creating modular configuration, or organizing OpenWrt configuration tasks.

لغة النص الأصلي: الإنجليزية

proxmox-system-safety

Proxmox system safety operations and hardware detection patterns. Use when managing system operations, hardware detection, or safety-critical tasks on Proxmox hosts.

لغة النص الأصلي: الإنجليزية

rollback-architecture

Rollback architecture and layered rollback model patterns. Use when designing rollback strategies, understanding rollback layers, planning reversible feature deployments, adding per-feature rollback, designing deploy_stamp tracking, implementing UCI config…

لغة النص الأصلي: الإنجليزية

rollback-group-reconstruction

Dynamic group reconstruction for rollback play patterns. Use when setting up rollback plays that target dynamic groups, managing ephemeral groups, or reconstructing host connections.

لغة النص الأصلي: الإنجليزية

rollback-per-feature

Per-feature rollback implementation patterns and tag conventions. Use when implementing rollback for specific features, managing UCI changes, or designing rollback procedures.

لغة النص الأصلي: الإنجليزية

secret-generation

Auto-generation and persistence patterns for secrets, keys, and dynamic configuration. Includes env file patterns, blockinfile usage, and variable scoping.

لغة النص الأصلي: الإنجليزية

vm-lifecycle-architecture

VM lifecycle architecture patterns and the two-role service model. Use when creating new VM types, structuring service roles, understanding playbook execution order, extending site.yml, modifying shared infrastructure, or designing inventory groups. For…

لغة النص الأصلي: الإنجليزية

vm-provisioning-patterns

VM provisioning patterns and step-by-step service creation. Use when creating new VM roles, implementing VM lifecycle management, or handling VM existence checks.

لغة النص الأصلي: الإنجليزية

webui-manual-testing

Manual testing procedures for the NiceGUI web UIs (SuperManager, Manager, Kiosk). Use when performing manual test walkthroughs, verifying UI behavior after changes, or when the user asks to "manually test" the web apps.

لغة النص الأصلي: الإنجليزية

project-planning

Template and conventions for vm_builds project plans. Use when creating, reviewing, or updating project plans in docs/projects/, when adding a new VM or service type, or when structuring milestones with verify/rollback sections.

لغة النص الأصلي: الإنجليزية

image-management-patterns

Image management and local storage patterns for VM and LXC images. Use when managing VM images, handling custom image builds, or planning image storage strategies.

لغة النص الأصلي: الإنجليزية

project-planning-structure

Project planning structure and milestone template patterns. Use when creating project plans, structuring milestones, or organizing project documentation.

لغة النص الأصلي: الإنجليزية

project-planning-verification

Project milestone verification and rollback patterns. Use when designing verify sections, rollback procedures, or testing strategies for project milestones.

لغة النص الأصلي: الإنجليزية

multi-node-ssh

SSH ProxyCommand patterns for managing Proxmox nodes behind the OpenWrt router. Use when adding LAN hosts, debugging satellite connectivity, writing Molecule scenarios for LAN nodes, or working with tasks/bootstrap_lan_host.yml.

لغة النص الأصلي: الإنجليزية

rollback-patterns

Consolidated — see .agents/skills/rollback-architecture/SKILL.md for layered rollback, cleanup tags, deploy_stamp, UCI/opkg rollback, and dynamic group reconstruction.

لغة النص الأصلي: الإنجليزية

vm-lifecycle

Consolidated — see .agents/skills/vm-lifecycle-architecture/SKILL.md for two-role VM/LXC patterns, site.yml ordering, image management, inventory flavors, and cleanup/verify conventions.

لغة النص الأصلي: الإنجليزية

build-testing

Test coverage for build.py functions. Real infrastructure probes, justified mocks only.

لغة النص الأصلي: الإنجليزية

openwrt-dns-mesh-setup

OpenWrt encrypted DNS and mesh configuration patterns. Use when setting up https-dns-proxy, configuring WDS WiFi backhaul, or implementing DNS encryption on OpenWrt.

لغة النص الأصلي: الإنجليزية

project-plan-review

Review checklist for project plans before execution. Includes structural validation, container/VM requirements, cross-reference checks, and performance considerations.

لغة النص الأصلي: الإنجليزية

project-planning-container-vm

Container and VM planning constraints and capability requirements. Use when planning LXC containers, VM resources, or container/VM specific configurations.

لغة النص الأصلي: الإنجليزية

openwrt-network-topology

OpenWrt bridge ordering and WAN detection patterns. Use when managing Proxmox bridges, configuring WAN/LAN interfaces, or debugging OpenWrt network topology issues.

لغة النص الأصلي: الإنجليزية

webui-design-system

NiceGUI web UI design system, color semantics, CSS patterns, and testing conventions. Use when modifying scripts/webui/ pages, theme.py, or writing test_webui_* tests.

لغة النص الأصلي: الإنجليزية

webui-ux-principles

UX design and maintenance principles for building human-intuitive web UIs. Use when designing new pages, reviewing UI changes, fixing layout issues, choosing icons/colors, or when the user asks about UX quality.

لغة النص الأصلي: الإنجليزية