Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion .agents/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,9 @@ guidance) with this file (guidance for editing this repo).
module), `provision.sh` (standalone-runnable, sources
`lib/provision-lib.sh`), optional `requires`. A module whose whole
directory is linked (`tmux`, `kitty`) keeps its config under `config/` so
the manifest and provisioning don't land in `$HOME`.
the manifest and provisioning don't land in `$HOME`. A hand-run module
(`obsidian`) has neither file: it ships a script the owner runs directly,
plus a README, and no role lists it.
- `modules/x11/` - the bspwm + sxhkd + polybar stack plus picom, dunst,
redshift, Xresources, the systemd user unit, and the X11-only scripts.
Grouped because sxhkd's hotkeys and polybar's toggle scripts reference
Expand Down
6 changes: 6 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,8 @@ roles/ server, workstation, desktop - one module name per line
modules/<name>/ install.conf.yaml (dotbot links, sources relative to the module)
provision.sh (pinned + sha256-verified tooling; standalone-runnable)
requires (optional: modules this one cannot work without)
a hand-run module (obsidian) instead ships a script and
README, and no role lists it
hosts/ per-machine values (see below)
apps/ applications that live here but are not dotfiles
lib/ provision-lib.sh (pins, sha256, apt), roles.sh, common.sh,
Expand Down Expand Up @@ -70,6 +72,10 @@ Modules:
`desktop-session-log`. These stay together because sxhkd's hotkeys and
polybar's toggle scripts reference bspwm's installed paths directly.
- `wacom` - one tablet's `xsetwacom` mapping; per-host.
- `obsidian` - a starter pack for new Obsidian vaults (settings, vimrc,
folder layout, `AGENTS.md`, `Home.md`). A hand-run module: no role lists
it; run `modules/obsidian/seed-vault <vault-path>`. Seeded vaults own
their copy afterwards. See [the module README](modules/obsidian/README.md).

Applications:

Expand Down
16 changes: 4 additions & 12 deletions modules/agents/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,10 @@ dotbot/bin/dotbot -d "$PWD/modules/agents" -c modules/agents/install.conf.yaml -
## Project convention

Keep shared authored context under `<project>/.agents/`. A project's root
`AGENTS.md` and `CLAUDE.md` point to `.agents/AGENTS.md`. A distinct Claude
`AGENTS.md` and `CLAUDE.md` point to `.agents/AGENTS.md`. Claude Code reads
`AGENTS.md` when a directory has no `CLAUDE.md`, so a project with only a
root `AGENTS.md` (such as a vault from `modules/obsidian`) needs no
`CLAUDE.md`; its Claude skills still go in `.claude/skills/`. A distinct Claude
instruction document can live at `.agents/CLAUDE.md` with its existing entry
point retained. Nested instruction scopes use the same layout in that scope.
Project skill sources live at `.agents/skills/<name>`; Claude gets individual
Expand Down Expand Up @@ -68,14 +71,3 @@ This installer has no required dependency on those files or on a notes vault.
`vault` replaces the former local `homebase` user skill. Its general vault
workflow lives here; application-specific Homebase procedures belong to that
application's project skills. The old global `homebase` links are retired.

`generate-notes`, `improve-notes`, `optimize`, and `tiling-tree` were migrated
from `krishna-bala/claude-bala-plugins` at commit
`ddc2c451db7542104b288db680c760c7a08a14ce`. The first three lived under
`pkm/skills/`; `tiling-tree` lived under `skills/`. Their initial contents are
preserved, including Claude-specific optional frontmatter and existing workflow
references. The source repository retains their earlier Git history. The owner
kept these four available while considering pruning or redesign.

The PKM workflows still assume a separate notes vault at `~/notes`; installing
them does not create that vault or its optional Anki integrations.
8 changes: 0 additions & 8 deletions modules/agents/install.conf.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -16,11 +16,3 @@
# Link individual skills so other installed skills remain independent.
~/.agents/skills/vault: skills/vault
~/.claude/skills/vault: skills/vault
~/.agents/skills/generate-notes: skills/generate-notes
~/.claude/skills/generate-notes: skills/generate-notes
~/.agents/skills/improve-notes: skills/improve-notes
~/.claude/skills/improve-notes: skills/improve-notes
~/.agents/skills/optimize: skills/optimize
~/.claude/skills/optimize: skills/optimize
~/.agents/skills/tiling-tree: skills/tiling-tree
~/.claude/skills/tiling-tree: skills/tiling-tree
71 changes: 0 additions & 71 deletions modules/agents/skills/generate-notes/SKILL.md

This file was deleted.

66 changes: 0 additions & 66 deletions modules/agents/skills/improve-notes/SKILL.md

This file was deleted.

79 changes: 0 additions & 79 deletions modules/agents/skills/optimize/SKILL.md

This file was deleted.

Loading
Loading