bootstrap
Adom Hydrogen (platform base)
Public Made by Adomby adom
Layer Hydrogen's workspace onto a standard Adom workstation.
← Commit history
LAYERING.md: the base/platform layering rule, previously only in commit messages
1 file changed
+11
LAYERING.mdadded+11@@ -0,0 +1,11 @@+# Skill layering (established by Kyle, 2026-08-28)++- **adom/hydrogen-bootstrap** is the platform-agnostic base. A skill lives here only if it is true on every platform Hydrogen runs on.+- **adom/hydrogen-windows-bootstrap** is the Windows / WSL2 layer. Windows-specific skills live here, either as full skills (`hydrogen-<topic>`) or as platform companions to a base skill (`hydrogen-<topic>-windows`).+- **adom/hydrogen-mac-bootstrap** is the macOS / Lima layer, same shape, `-mac` companions.++Rules:+1. Never add a Windows- or Mac-specific skill to the base. The base was cleaned on 2026-08-28; a deletion there was deliberate, and the ah repo's publish script refuses to re-add a skill that lives in a platform layer.+2. Skill names use the `hydrogen-` prefix only. The `hd-` prefix is retired (the last 31 were deleted or renamed in windows-bootstrap 0.3.17, whose install.sh prunes them from existing workspaces).+3. Install scripts copy every `skills/*/SKILL.md` into `~/.claude/skills/<name>/` flat, so a name used in two layers would silently collide. Companions get the platform suffix for that reason.+4. Source of truth for text is the ah repo (`skills/public-facing/`); publish from there. Edits made directly on the wiki must be back-ported or they are lost at the next publish.