Arch Linux / CachyOS Administration

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

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 (from user feedback)

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.
5. Read existing skills before acting. ls .agents/skills/ and use find_skills from the global set.

Pacman / pacman.conf

IgnorePkg placement (the #1 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.