myDevice/CLAUDE.md

1.1 KiB
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