---
name: nomarchy
description: Development and maintenance workflow for the Nomarchy NixOS-based distribution (this repository). Use this skill for ANY change to this repo — new features, bug fixes, theming or visual work (Hyprland, Waybar, rofi, wallpapers, palettes), NixOS/Home-Manager module changes, flake lock bumps, theme imports, docs updates, backlog grooming, or loop iterations. Trigger even for "small" or "obvious" changes; the whole point of this skill is that no change ships without climbing the verification ladder, and small changes are where verification gets skipped.
---

# Nomarchy Development Skill

This repo is maintained by agents from multiple vendors, so the skill
body lives vendor-neutrally in the repo — this file only routes you
there. Read, then follow:

1. **`AGENTS.md`** — entry point: where everything lives, standing rules
2. **`agent/LOOP.md`** — the iteration protocol + the V0–V3 ladder
3. **`agent/VERIFICATION.md`** — the enforcement rules: preflight, the
   honesty rules, the visual verification protocol, hardware-blocked
   checks, maintenance work, the reporting format
4. **`agent/DELEGATION.md`** — capability tiers, the scout/runner roles
   (Claude Code defs: `.claude/agents/`), token economy, parallel fan-out

Before running any VM test, also read **`docs/TESTING.md`**. The repo
docs always win over any cached summary of them; if docs disagree with
each other, fix the discrepancy in the same or a follow-up commit.