myDevice/CLAUDE.md

27 lines
1.1 KiB
Markdown
Executable File

# 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