# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Purpose

Personal knowledge base documenting the hardware and OS configuration of device `kr-nb-1003`. No source code — only Markdown documentation.

## Structure

- `system.md` — Hardware specs, disk layout (UUIDs, partitions), CachyOS VM config (BTRFS subvolumes, kernel, desktop)
- `ventoy-setup.md` — Ventoy VtoyBoot setup: pacman hook, mkinitcpio config, known boot issues and solutions
- `todos.md` — Open system administration tasks

## Key Context

- Dual-boot: Windows (nvme1n1) + CachyOS VM via Ventoy (nvme0n1)
- CachyOS runs as VirtualBox VM booted from Ventoy virtual disk (not a standard install)
- Critical constraint: mkinitcpio must use `udev` hooks (not `systemd`) for Ventoy compatibility
- Windows fast startup must be disabled before mounting NTFS read-write from Linux

## Conventions

- Documentation language: German
- When editing, preserve UUID references and partition labels exactly
- Keep `todos.md` as actionable checklist format