diff --git a/.claude/skills/nomarchy/SKILL.md b/.claude/skills/nomarchy/SKILL.md deleted file mode 100644 index 74007f0..0000000 --- a/.claude/skills/nomarchy/SKILL.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -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. diff --git a/.claude/skills/theme/SKILL.md b/.claude/skills/theme/SKILL.md deleted file mode 100644 index 4b9b199..0000000 --- a/.claude/skills/theme/SKILL.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -name: theme -description: Theme design and visual work for Nomarchy — use whenever the user asks to create, update, refine, or troubleshoot themes or visual design (palettes, Hyprland looks, Waybar, Ghostty, btop, rofi, wallpapers, typography, icons). ---- - -# Nomarchy Theme Designer Skill - -The skill body lives vendor-neutrally in the repo — read and follow -**`agent/THEME-DESIGN.md`**. Visual work additionally climbs the -verification ladder and visual protocol in **`agent/VERIFICATION.md`** -(scripted contrast/design checks first, then headless screenshots you -actually view). diff --git a/AGENTS.md b/AGENTS.md index 18ecd3f..96a6087 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -18,7 +18,7 @@ thin *adapter* (see bottom) and never holds shared content. | **`docs/VISION.md`** | Product themes toward **v1.0** (not a queue) | | **`docs/ROADMAP.md`** | Design history + shipped log | | **`docs/README.md`** | Full documentation map | -| **`.claude/`** | Claude Code adapter only (permissions, subagents, skill shims) — not the backlog | +| **`.claude/`** | Claude Code adapter only (permissions, subagent defs) — not the backlog | ## If you're here to work autonomously (the loop) Follow **`agent/LOOP.md`** — one iteration: orient → pick one BACKLOG diff --git a/README.md b/README.md index f3dd05d..90bdcd4 100644 --- a/README.md +++ b/README.md @@ -86,7 +86,7 @@ Flat on purpose. Two module trees, one options file each, no hidden layers. ├── agent/ # agent instructions + loop state — map: agent/README.md │ # BACKLOG (executable queue), LOOP, VERIFICATION, … ├── AGENTS.md # agent entry, any vendor (CLAUDE.md symlinks here) -├── .claude/ # Claude Code adapter: permissions + subagent/skill shims +├── .claude/ # Claude Code adapter: permissions + subagent defs └── tools/ # maintainer-only ├── import-palettes.py # converts old-distro themes → JSON + assets ├── test-live-iso.sh # build the ISO + boot it in QEMU diff --git a/agent/MEMORY.md b/agent/MEMORY.md index 30d012a..6b05b80 100644 --- a/agent/MEMORY.md +++ b/agent/MEMORY.md @@ -162,9 +162,9 @@ iteration would otherwise rediscover. effects carry a value, matchers take `match:` (§ windowrule migration). - grub `loadfont`s every `.pf2` in a theme dir — reuse a bundled DejaVu rather than shipping fonts (§ Distro branding). -- `.claude/skills/*/SKILL.md` are **tracked thin shims** — the actual - instruction bodies live vendor-neutrally in `agent/` (VERIFICATION, - DELEGATION, THEME-DESIGN); edit those, not the shims. Still never - `git add -A` blindly: check `git status --short` for genuine strangers - first (`settings.local.json`, harness-dropped files) and commit with - explicit pathspecs (§ loop hygiene). +- Agent instructions live vendor-neutrally in `agent/` (VERIFICATION, + DELEGATION, THEME-DESIGN; entry AGENTS.md) — `.claude/` is a thin + adapter (permissions + subagent defs only; skills were removed + 2026-07-11). Never `git add -A` blindly: check `git status --short` + for genuine strangers first (`settings.local.json`, harness-dropped + files) and commit with explicit pathspecs (§ loop hygiene). diff --git a/agent/README.md b/agent/README.md index b345967..8dbd7da 100644 --- a/agent/README.md +++ b/agent/README.md @@ -42,7 +42,6 @@ into the files above, in whatever format their harness requires. | [../AGENTS.md](../AGENTS.md) | any | Entry point (`CLAUDE.md` is a symlink to it) | | [../.claude/settings.json](../.claude/settings.json) | Claude Code | Tool permissions | | [../.claude/agents/](../.claude/agents/) | Claude Code | `nomarchy-scout` / `nomarchy-runner` role defs (contracts in [DELEGATION.md](DELEGATION.md)) | -| [../.claude/skills/](../.claude/skills/) | Claude Code | Skill shims → VERIFICATION/DELEGATION/THEME-DESIGN | Do **not** put backlog items, vision text, or policy under an adapter directory — it is not shared with other agent runners. diff --git a/docs/README.md b/docs/README.md index efbb502..33b2ae7 100644 --- a/docs/README.md +++ b/docs/README.md @@ -21,7 +21,7 @@ tree for the same facts. |------|------| | [../AGENTS.md](../AGENTS.md) | Agent entry point, any vendor/harness (`CLAUDE.md` symlinks to it) | | [../agent/README.md](../agent/README.md) | Agent instructions + **executable** loop state: BACKLOG, LOOP, VERIFICATION, … | -| [../.claude/](../.claude/) | Claude Code adapter only: permissions + subagent/skill shims | +| [../.claude/](../.claude/) | Claude Code adapter only: permissions + subagent defs | ## How work flows