# CLAUDE.md

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

## Project

Yino (a recursive acronym for "Yino Is Not Omarchy") is an opinionated set of configuration files for a desktop
operating system based on Debian Linux. It is exactly like Omarchy (https://github.com/basecamp/omarchy) but uses
Debian Linux as a stable base instead of Arch Linux.

See `docs/yino-fsd.md` for the full functional specification and changelog.

## Conventions

- KISS principle applies
- Minimize dependencies, less is more; discuss with owner before adding any
- Never install global Python packages; use a venv in this repository when Python dependencies are needed (e.g.
  `python3 -m venv venv && source venv/bin/activate && pip install ...`)

## Upstream tracking

- When re-analyzing or updating `docs/Omarchy.md`, always update the "Last analyzed" line at the top of the
  document with the current date and the latest commit hash from `basecamp/omarchy` (`dev` branch).