Arch Linux / CachyOS Administration

This file is intentionally machine-agnostic. Machine-specific data (hostname, hardware specs, kernel versions) lives in per-host files at the project root (e.g. <hostname>.md).

Always verify against the listed source before relying on anything. Training data goes stale; the docs do not. Use context7 and searxng skills for online verification.

Hard constraints

1. AI agent must not invoke sudo directly. Scripts that need root use sudo internally.
2. All fix scripts must be idempotent (safe to re-run).
3. User wants 300% certainty on kernel/bootloader changes. Investigate online; check the actual binary; verify the fix ran.
4. Avoid kernel panic risk. Kernel cmdline and initramfs changes are the highest-risk surface.

Pacman / pacman.conf

IgnorePkg placement (the top recurring bug)

IgnorePkg MUST be in the [options] section. Anywhere else (end of file, [multilib], etc.) → pacman prints directive 'IgnorePkg' in section '<name>' not recognized and silently ignores it.