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

docs: align agent and repo docs with desktop Decman profile

Browse Source
This commit is contained in:
Alex
2026-08-27 15:50:30 +02:00
parent 00781a3607
commit 10c214fc36
4 changed files with 30 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+9 -6
View File
@@ -12,13 +12,16 @@ This directory (`/home/alex`) is the **yadm worktree** for personal, Arch-orient
Start with the root `README.md` for the dotfile-specific constraints and manual-validation guidance.
## Shell
- Treat Fish (`fish`) as the default interactive shell. Write user-facing shell commands using Fish-compatible syntax unless another shell is explicitly requested or required.
## Ownership map
| Path | Owns |
| --- | --- |
| Root dotfiles (`.zshrc`, `.config/`, `.scripts/`, etc.) | Ordinary yadm-managed user configuration and helpers |
| `.setup/` | Legacy/manual setup assets and package lists; it is not a complete installer |
| `system-config/` | Declarative Decman configuration for this Arch laptop |
| `system-config/` | Declarative Decman configuration for this Arch desktop |
| `system-config/config/system/` | Files deployed into system locations; do **not** edit deployed `/etc` targets |
| `system-config/config/user/` | Selected user dotfiles deployed by Decman; do **not** edit deployed copies |
| `system-config/packages/` | Native and AUR package lists organized by concern |
@@ -29,7 +32,7 @@ Start with the root `README.md` for the dotfile-specific constraints and manual-
## Decman architecture
`system-config/source.py` is the Decman entrypoint. It currently selects the `laptop()` profile from `hosts.py` and applies modules in this order:
`system-config/source.py` is the Decman entrypoint. It currently selects the `desktop()` profile from `hosts.py` and applies modules in this order:
1. `files`
2. `pacman`
@@ -38,9 +41,9 @@ Start with the root `README.md` for the dotfile-specific constraints and manual-
`hosts.py` composes host profiles from package concerns:
- Shared concerns: `common/core`, `wayland`, `fonts`, `development`, `productivity`, `media`, `research`, `network`, and `services`.
- Laptop-specific concern: `laptop/hardware`.
- Desktop support is intentionally sparse and future-facing.
- Shared concerns: `common/core`, `common/hardware`, `common/wayland`, `common/fonts`, `common/development`, `common/productivity`, `common/media`, `common/research`, `common/network`, and `common/services`.
- Host-specific concerns: `laptop/hardware` and `desktop/local`.
- The active desktop profile combines the shared concerns, `desktop/local`, and desktop system/user configuration.
Keep policy in the declared data directories, not in Python glue: