alexion/dotfiles
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(agents): add wayfinding skills

Browse Source
This commit is contained in:
alexion
2026-07-31 14:44:13 -04:00
parent 6945c29a47
commit 9ed4809837
3 changed files with 12 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
AGENTS.md
View File

@@ -1,7 +1,7 @@
# dotfiles-nixos # dotfiles-nixos
One flake that builds every machine the user owns. One flake that builds every machine the user owns.
The domain model (Host, Module, Skeleton, Auto-loader, Enable convention, overlays) lives in `~/Documents/ai-artifacts/projects/dotfiles/CONTEXT.md`. The domain model (Host, Module, Skeleton, Auto-loader, Enable convention, overlays) lives in `~/Documents/ai-artifacts/projects/dotfiles/003-dotfiles-context.md`.
## Conventions ## Conventions
@@ -18,8 +18,9 @@ The domain model (Host, Module, Skeleton, Auto-loader, Enable convention, overla
## Gotchas ## Gotchas
- ADR bodies are immutable records of decisions as they were made, while status frontmatter is mutable. - ADR bodies are immutable records of decisions as they were made, while frontmatter is mutable.
When a decision changes or its premise proves wrong, preserve the original body, update its status, and add a new ADR that supersedes it. When a decision changes or its premise proves wrong, preserve the original body, update its status, and add a new ADR that supersedes it.
Filename migrations preserve references in immutable bodies through frontmatter aliases rather than rewriting those bodies.
- This repo pins no Nix formatter, and its committed `.nix` files are not clean under current `nixfmt-rfc-style`. - This repo pins no Nix formatter, and its committed `.nix` files are not clean under current `nixfmt-rfc-style`.
Running `nixfmt` across a file reflows untouched code (for example `lib.nix`'s `deriveMac` list and multi-line assertion messages) and injects churn unrelated to the change. Running `nixfmt` across a file reflows untouched code (for example `lib.nix`'s `deriveMac` list and multi-line assertion messages) and injects churn unrelated to the change.
Format only the lines being written or changed, matching the surrounding style by hand. Format only the lines being written or changed, matching the surrounding style by hand.
@@ -59,7 +60,7 @@ The domain model (Host, Module, Skeleton, Auto-loader, Enable convention, overla
A `PreToolUse` hook refuses privileged commands while the cache is cold, so a cold cache announces itself instead of stalling. A `PreToolUse` hook refuses privileged commands while the cache is cold, so a cold cache announces itself instead of stalling.
A privileged-command failure *without* that message is the sandbox, not the cache. A privileged-command failure *without* that message is the sandbox, not the cache.
- Host GPUs: `neogaia` is Intel, `zeus` (the desktop) is **AMD**, and `raichu` (a headless server) is the only Nvidia machine. - Host GPUs: `neogaia` is Intel, `zeus` (the desktop) is **AMD**, and `raichu` (a headless server) is the only Nvidia machine.
The corrected fact also lives in ADR 0003. The corrected fact also lives in artifact `006-dotfiles-hyprland-compositor-adr.md`.
- This repo's `programs.firefox` `search` (with `force = true`) writes `search.json.mozlz4`. - This repo's `programs.firefox` `search` (with `force = true`) writes `search.json.mozlz4`.
Omission alone does not prune a built-in engine, since Firefox reconciles its app-provided engines back in, so remove one by listing it with `<engine>.metaData.hidden = true`. Omission alone does not prune a built-in engine, since Firefox reconciles its app-provided engines back in, so remove one by listing it with `<engine>.metaData.hidden = true`.
Engines are referenced by their current id, so the default is `default = "ddg"`, not `"DuckDuckGo"`. Engines are referenced by their current id, so the default is `default = "ddg"`, not `"DuckDuckGo"`.

8
flake.lock generated
View File

@@ -562,11 +562,11 @@
] ]
}, },
"locked": { "locked": {
"lastModified": 1785452609, "lastModified": 1785508905,
"narHash": "sha256-28OYRZJuSwKm46PSyJrU2mjDs8O8FFoHH5D0ZLpaPzU=", "narHash": "sha256-pIOEPavNimXWalp4/mFzneRNlEQafeiGqWzUeDED2Wk=",
"ref": "refs/heads/main", "ref": "refs/heads/main",
"rev": "f72c2622297651def9c0652a75b15a780d7ec2f9", "rev": "181dcc7a9ec16459efee09ffffb7f99386755be4",
"revCount": 29, "revCount": 36,
"type": "git", "type": "git",
"url": "https://git.alexion.dev/alexion/skills" "url": "https://git.alexion.dev/alexion/skills"
}, },

4
modules/agents/skills.nix
View File

@@ -13,11 +13,15 @@ let
# wiki reads the personal Obsidian vault, and consume mines a source into it. # wiki reads the personal Obsidian vault, and consume mines a source into it.
# grill interviews the operator relentlessly to resolve a plan before building. # grill interviews the operator relentlessly to resolve a plan before building.
# design-skill drafts and audits Agent Skills for structural predictability. # design-skill drafts and audits Agent Skills for structural predictability.
# wayfinder, research, and prototype guide work from exploration through validation.
skills = with inputs.skills.packages.${pkgs.stdenv.hostPlatform.system}; [ skills = with inputs.skills.packages.${pkgs.stdenv.hostPlatform.system}; [
wiki wiki
consume consume
grill grill
design-skill design-skill
wayfinder
research
prototype
]; ];
in in
{ {