Skip to content

Dotfiles docs

These docs are the source of truth for daily workflow knowledge in this repo. The top-level README stays small; setup details, host-lane policy, tool ownership, and repeatable workflows live here.

Start here

  • Workflow primer: operating model and daily command shape.
  • Setup: host lanes and bootstrap entrypoints.
  • Workflows: intended command palette for daily work.
  • Desktop: CachyOS KDE boundary and planned ricing design.
  • Tool manifest: which manager owns which tools.
  • Design records: current design status and historical records.
  • Decisions: current decisions and superseded ADRs.
  • Plans: staged implementation plans.
  • Quality gates: validation commands before packaging or committing.
  • Archive: historical plans and retired design records.

Repository shape

This is a chezmoi source repo. Managed home files live under home/; top-level docs, scripts, task queues, and manifests are repository material.