From 474d9dd4ebeed99bb984a47d492932f1b39a74e7 Mon Sep 17 00:00:00 2001 From: David Heinemeier Hansson Date: Fri, 7 Aug 2026 12:33:23 +0200 Subject: [PATCH] Move agent guides into agents/skills/ Leave agents/ ready for other agent artifacts like definitions and prompts alongside the skills. Co-Authored-By: Claude Fable 5 --- AGENTS.md | 16 ++++++++-------- agents/{ => skills}/acceptance-tests.md | 0 agents/{ => skills}/command-metadata.md | 0 agents/{ => skills}/install-scripts.md | 0 agents/{ => skills}/shell-dev.md | 2 +- agents/{ => skills}/visual-verification.md | 0 6 files changed, 9 insertions(+), 9 deletions(-) rename agents/{ => skills}/acceptance-tests.md (100%) rename agents/{ => skills}/command-metadata.md (100%) rename agents/{ => skills}/install-scripts.md (100%) rename agents/{ => skills}/shell-dev.md (97%) rename agents/{ => skills}/visual-verification.md (100%) diff --git a/AGENTS.md b/AGENTS.md index 159fad13..6cfad12d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,13 +1,13 @@ # Task Guides -Deeper instructions for specific kinds of work live in `agents/`. Read the +Deeper instructions for specific kinds of work live in `agents/skills/`. Read the matching guide before starting: -- [`agents/command-metadata.md`](agents/command-metadata.md) - adding or changing commands in `bin/` -- [`agents/install-scripts.md`](agents/install-scripts.md) - working under `install/` or on system/user setup commands -- [`agents/shell-dev.md`](agents/shell-dev.md) - editing the Quickshell desktop under `shell/` -- [`agents/acceptance-tests.md`](agents/acceptance-tests.md) - writing or running graphical acceptance tests under `test/acceptance.d/` -- [`agents/visual-verification.md`](agents/visual-verification.md) - verifying any change with a visual effect in the running UI +- [`agents/skills/command-metadata.md`](agents/skills/command-metadata.md) - adding or changing commands in `bin/` +- [`agents/skills/install-scripts.md`](agents/skills/install-scripts.md) - working under `install/` or on system/user setup commands +- [`agents/skills/shell-dev.md`](agents/skills/shell-dev.md) - editing the Quickshell desktop under `shell/` +- [`agents/skills/acceptance-tests.md`](agents/skills/acceptance-tests.md) - writing or running graphical acceptance tests under `test/acceptance.d/` +- [`agents/skills/visual-verification.md`](agents/skills/visual-verification.md) - verifying any change with a visual effect in the running UI - [`docs/migrations.md`](docs/migrations.md) - creating or changing migrations under `migrations/` # Style @@ -93,10 +93,10 @@ Run focused automated tests for the area you changed. Current test entry points: New Omarchy shell tests should live in `test/shell.d/*-test.sh` so `./test/shell` picks them up automatically. Source `test/shell.d/base-test.sh` for shared root-path discovery, assertions, and Node test helpers. The graphical acceptance suite runs in a disposable VM, not in the active -development session; see [`agents/acceptance-tests.md`](agents/acceptance-tests.md). +development session; see [`agents/skills/acceptance-tests.md`](agents/skills/acceptance-tests.md). Visual changes must be verified in the running UI in addition to automated -tests; follow [`agents/visual-verification.md`](agents/visual-verification.md). +tests; follow [`agents/skills/visual-verification.md`](agents/skills/visual-verification.md). # Refresh Pattern diff --git a/agents/acceptance-tests.md b/agents/skills/acceptance-tests.md similarity index 100% rename from agents/acceptance-tests.md rename to agents/skills/acceptance-tests.md diff --git a/agents/command-metadata.md b/agents/skills/command-metadata.md similarity index 100% rename from agents/command-metadata.md rename to agents/skills/command-metadata.md diff --git a/agents/install-scripts.md b/agents/skills/install-scripts.md similarity index 100% rename from agents/install-scripts.md rename to agents/skills/install-scripts.md diff --git a/agents/shell-dev.md b/agents/skills/shell-dev.md similarity index 97% rename from agents/shell-dev.md rename to agents/skills/shell-dev.md index b3ae7570..d33f21ef 100644 --- a/agents/shell-dev.md +++ b/agents/skills/shell-dev.md @@ -17,7 +17,7 @@ Run `omarchy-restart-shell` after making changes to QML files. at `~/.config/omarchy/plugins//` with a `manifest.json` at the root. - Every plugin manifest declares `schemaVersion`, `id`, `name`, `version`, `kinds`, and `entryPoints`. See - [`docs/omarchy-shell.md`](../docs/omarchy-shell.md) and + [`docs/omarchy-shell.md`](../../docs/omarchy-shell.md) and `shell/services/PluginRegistry.qml` for the current contract; fields such as `activation` are optional. - Entry-point QML files are `Item`s (not `ShellRoot`), and accept the diff --git a/agents/visual-verification.md b/agents/skills/visual-verification.md similarity index 100% rename from agents/visual-verification.md rename to agents/skills/visual-verification.md