system-health-check

name	system-health-check
description	Verifies repository baseline test passing state and available memory/GPU resources to ensure safe mission execution.
source	builtin
trust_score	100
provenance_sha	60047103ac9e7045

System Health Check (Pre-Flight)

Before accepting or starting a large architectural mission, you MUST run this health check to confirm you are not iterating on top of an already broken baseline.

1. Test Baseline Verification

Identify the primary test command for this workspace. Use the command matching the ecosystem:

• Node.js: npm run test or pnpm test:all
• Rust: cargo test
• Python: pytest

Rule: If the tests FAIL, immediately halt your mission and inform the user. Do not proceed until the existing codebase compiles and tests pass.

2. Resource Verification

Ensure the host machine has adequate capacity to compile your work or run complex LLMs.

Windows PowerShell Examples: Check available memory and CPU cores:

systeminfo | findstr /C:"Total Physical Memory" /C:"Available Physical Memory"
wmic cpu get NumberOfCores,NumberOfLogicalProcessors /format:list

3. Hardware Accelerators (Optional)

If your mission explicitly governs a machine learning or GPU-heavy task, check for an NVIDIA GPU via:

nvidia-smi --query-gpu=name,memory.total,memory.free --format=csv,noheader

If resources look extremely constrained (e.g., <2GB Free RAM), halt and warn the user before proceeding to file modifications.